Um diese Zertifikatsvalidierungswarnung zu beheben, beachten Sie die folgenden Anweisungen:

Korrekte Verwendung:

Wenn Sie das Zertifikat irgendwo auf der Festplatte haben, instanziieren Sie die ISAMAppliance mit:

Sie können dies von der Appliance mit einem Befehl wie dem folgenden abrufen:

Wenn das Zertifikat in Ihrer Python-Umgebung bereits vertrauenswürdig ist, instanziieren Sie die ISAMAppliance mit:

oder setzen Sie die Umgebungsvariable: IBMSECLIB_VERIFY_CONNECTION=true

Wenn Sie Fehler erhalten, dass der Hostname nicht mit dem Zertifikat übereinstimmt:

Das könnte so aussehen:

Stellen Sie sicher, dass der Hostname, der beim Instanziieren Ihrer ISAMAppliance verwendet wird, mit dem Subject Alternative Name des Zertifikats übereinstimmt.

Überprüfen Sie mit:

Beispiel:

Certificate:

…

Das Folgende erzeugt Fehler:

da der Host nicht mit dem Subject Alternative Name übereinstimmt. Verwenden Sie stattdessen:

Versionierung

Dieses Paket verwendet ein Datum für die Versionierung. Zum Beispiel: "2017.03.18.0"

Es ist das Datum, an dem das Paket veröffentlicht wird, mit einer Sequenznummer am Ende, um zu behandeln, wenn es mehrere Veröffentlichungen an einem Tag gibt (was voraussichtlich ungewöhnlich ist).

Funktionen

Dieses Python-Paket bietet die folgenden Funktionen:

1. Einfach zu bedienen – die Einzelheiten eines REST-Aufrufs werden innerhalb einer Appliance-Klasse behandelt
2. Intuitives Layout des Codepakets und Benennung, die der GUI-Oberfläche der Appliance entspricht
3. Idempotenz – Funktionen, die Aktualisierungen vornehmen, fragen die Appliance ab, um die angegebenen Daten zu vergleichen und zu sehen, ob eine Änderung erforderlich ist, bevor die eigentliche Änderung vorgenommen wird.
4. Commit- und Deploy-Schritte werden separat bereitgestellt, um Flexibilität bei deren Aufruf zu ermöglichen
5. Standardmäßiges Logging ist enthalten – mit der Möglichkeit, Logging-Stufen festzulegen.
6. Parameter für Funktionen verwenden, wo immer möglich, Standardwerte.
7. Eine Force-Option wird bereitgestellt, um die Idempotenz zu überschreiben.
8. Vergleichsfunktionen werden bereitgestellt – sie nehmen JSON-Ausgabe und liefern einen aussagekräftigen Vergleich.

Format der Funktionsdatenrückgabe

Hinweis: Es ist bevorzugt, Warnungen zurückzugeben, anstatt einen Nicht-Null-rc zurückzusenden.

Organisation des Codes

Appliance-Klassen

Eine abstrakte ibmappliance-Klasse wird erweitert, um eine Klasse für jede hier unterstützte Appliance zu erstellen. Derzeit sind das ISAM- und ISDS-Appliances.

Benutzerklassen

Ein abstrakter User wird für jede benötigte Benutzerart erweitert. Für ISAM gibt es einen Benutzer für den Appliance-Zugriff und einen anderen für die Authentifizierung bei Web Runtime (Policy Server).

Layout der ISAM-Pakete

Es gibt vier primäre ISAM-Pakete – base, web, aac und fed. web enthält alle Komponenten, die für die Einrichtung der Web-Funktionalität benötigt werden, einschließlich eingebettetem LDAP, Runtime und Funktionen, die als Teil des wga-Moduls aktiviert werden. aac enthält Funktionen, die als Teil des mga-Moduls aktiviert werden, und fed die der federation. base enthält alles andere – einschließlich aac und fed runtime und Audit Configuration (diese sind aac und fed gemeinsam und befinden sich daher in base).

Paket- und Dateinamen

Die Paket- und Dateinamen wurden mit der folgenden Absicht erstellt:

1. Namen beibehalten, die mit der GUI-Oberfläche übereinstimmen (LMI für die ISAM-Appliance).
2. Jede Datei sollte nur eine Funktion jedes Typs enthalten (siehe Liste unten) – d. h. nur ein add().
3. Verwandte Funktionen gruppieren – eine von jedem Typ – in einer Datei.
4. Der URI für die REST-API-Aufrufe innerhalb einer Datei ist derselbe und verwaltet ein "Feature" der Appliance.

Dienstprogramme

Enthält verschiedene Funktionen, die generisch und unabhängig von einer IBM Appliance sind, z. B. json_compare().

Funktionstypen

get_all()

Diese Funktion gibt typischerweise alle Objekte zurück, die mit diesem Feature zusammenhängen.

get()

Diese Funktion gibt die Details eines bestimmten Objekts zurück.

set()

Diese Funktion ermittelt, ob das zu manipulierende Objekt existiert; wenn nicht, ruft sie add() auf, andernfalls ruft sie update() auf. In Fällen, in denen es kein update() gibt, vergleicht sie, ob es einen Unterschied zwischen dem vorhandenen Wert auf der Appliance und dem Wert, der über die Funktion gesetzt wird, gibt – wenn unterschiedlich, löscht sie das Objekt mit delete(), bevor sie add() aufruft.

add()

Überprüft, ob das Objekt bereits existiert – wenn ja, überspringen, andernfalls hinzufügen.

update()

Überprüft, ob das Objekt bereits existiert – wenn ja, prüfen, ob eine Aktualisierung erforderlich ist, bevor eine Änderung vorgenommen wird, andernfalls nichts tun.

delete()

Überprüft, ob das Objekt bereits existiert – wenn ja, löschen, andernfalls nichts tun.

import_<>()

"import" ist ein reserviertes Wort, daher gibt es ein Suffix, das angibt, was importiert werden soll (z. B. Datei oder Schlüssel). Dies überprüft, ob das Objekt existiert, bevor es importiert wird.

export_<>()

Export prüft, ob das Objekt existiert, bevor es exportiert wird – beim Exportieren in eine Datei wird nicht erneut exportiert, wenn die Datei bereits existiert. Export

compare()

Compare nimmt die JSON-Ausgabe der get_all()-Funktionen und vergleicht sie. Es entfernt Daten aus JSON, die für jede Appliance eindeutig sind (z. B. UUID-Werte). Der zurückgegebene deleted_keys-Wert listet die JSON-Schlüssel auf, die vor dem Vergleich gelöscht wurden.

Funktionsparameter

Appliance-Objekt

Erstellen Sie ein Appliance-Objekt und übergeben Sie es an die Funktion. Appliance und das benötigte User-Objekt sind Klassen, um zukünftige Erweiterungen wie die Authentifizierung mit Zertifikat anstelle von Benutzername/Passwort zu ermöglichen.

check_mode

Der Standardwert ist False; übergeben Sie True, um zurückzukehren und keine Änderung vorzunehmen. Das "changed"-Flag wird auf True gesetzt, wenn Änderungen erkannt werden.

force

Der Standardwert ist False; übergeben Sie True, um die Idempotenzlogik zu überschreiben.

Andere Parameter

Die anderen Parameter entsprechen wörtlich der REST-API-Dokumentation. Die Absicht war, auf die REST-API-Dokumentation zu verweisen und sie nicht zu wiederholen. Bitte lesen Sie die REST-API-Dokumentation für Details.

Hinzufügen und Ändern

Bitte erstellen Sie ein Issue auf GitHub, wenn ein Fehler entdeckt wird oder es REST-APIs gibt, die von diesem Paket nicht abgedeckt werden. Geben Sie detaillierte Notizen zusammen mit Trace-Logs an, wenn ein Fehler gemeldet wird.

Lizenz

Der Inhalt dieses Repositorys ist unter der Apache-2.0-Lizenz Open Source.