Führe die erforderlichen Post-Installations-Aufgaben durch, um IBM Bob für Endbenutzer vorzubereiten, einschließlich TLS-Zertifikaten, LDAP-Federation, Benutzerzugang und Endpoint-Verteilung.

Nach der Installation von Bob Self-Hosted führe die folgenden administrativen Aufgaben durch, bevor du Benutzer onboardest.

IDP- und LDAP-Federation konfigurieren

Mit der LDAP-Federation kannst du dich mit deinen bestehenden LDAP- oder Active-Directory-Anmeldeinformationen bei Bob anmelden. Konfiguriere die LDAP-Federation nur, wenn deine Organisation einen Verzeichnisdienst für das Identitätsmanagement verwendet. Wenn die LDAP-Federation nicht erforderlich ist, erstelle Benutzer direkt in Keycloak.

Beschaffe die erforderlichen LDAP- oder Active-Directory-Konfigurationswerte, einschließlich:

LDAP-Server-URL
Benutzer- und Gruppen-Suchbasen
Bind-Account-Informationen (falls zutreffend)
CA-Zertifikat für LDAPS-Verbindungen, die eine private Zertifizierungsstelle verwenden

Erstelle eine IDP-Konfigurationsdatei aus der bereitgestellten Vorlage:

cp config-idp-template.yaml my-idp.yaml

Aktualisiere die Datei mit deinen E-Mail-Domänen, Admin-E-Mails und LDAP- oder Active-Directory-Umgebungsdetails.

Wende die IDP-Konfiguration an:

./bobctl configure-idp --config my-idp.yaml

Parameter	Beschreibung
`--config`	Gibt die IDP-Konfigurationsdatei an.
`--dry-run`	Validiert die Konfiguration ohne Anwendung der Änderungen.

Überprüfe die IDP-Konfiguration.

IDP-Status anzeigen:

oc get bobidp -n <instanz-namespace>

Detaillierte Abstimmungsinformationen anzeigen:

oc get bobidp bob-idp -n <instanz-namespace> -o yaml

Überprüfe, ob die folgenden Bedingungen einen erfolgreichen Status melden:

Bedingung	Beschreibung
`Ready`	Alle konfigurierten Domänen, Administrator-Zuweisungen und LDAP-Provider wurden erfolgreich abgeglichen.
`LDAPRegistered`	Der LDAP-Provider wurde in Keycloak registriert.
`LDAPReachable`	Der LDAP-Server ist vom Cluster aus erreichbar.
`LDAPAuthenticated`	Die LDAP-Authentifizierung wurde erfolgreich abgeschlossen.
`LDAPUserSyncSucceeded`	Die initiale Benutzersynchronisierung wurde erfolgreich abgeschlossen. Nur vorhanden, wenn `userSync.enabled: true`.

Standardmäßig wartet bobctl bis zu 600 Sekunden auf den Abschluss der Abstimmung. So änderst du den Timeout:

BOB_IDP_WAIT_TIMEOUT=900 ./bobctl configure-idp --config my-idp.yaml

Du kannst mehrere LDAP-Provider in einer einzigen Konfigurationsdatei konfigurieren, indem du mehrere Einträge in der ldaps-Liste definierst. Für jeden Provider ist kein separater bobctl configure-idp-Aufruf erforderlich.

Vollständige LDAP-Konfigurationsdetails findest du unter LDAP-Integration.

Zertifikate verwalten

Bob stellt Dienste über TLS bereit. Client-Workstations müssen der Zertifizierungsstelle (CA) vertrauen, die die Cluster-Zertifikate ausgestellt hat.

Du kannst einen der folgenden Zertifikatsansätze verwenden:

Ein Unternehmens- oder öffentliches Zertifikat konfigurieren (empfohlen)

Zertifikate mit OpenSSL generieren

Das standardmäßige selbstsignierte Zertifikat verwenden

Hinweis:

TLS-Verbindungsfehler in Bob IDE oder bob-shell werden in der Regel durch ein nicht vertrauenswürdiges CA-Zertifikat auf der Client-Workstation verursacht.

Vollständige Anweisungen findest du unter TLS-Zertifikate.

Benutzerzugang konfigurieren

Eine Bob Self-Hosted-Installation enthält einen Keycloak-Identitätsprovider. Bevor Benutzer auf die Plattform zugreifen können, konfiguriere eine der folgenden Authentifizierungsmethoden:

LDAP- oder Active-Directory-Federation: Wenn du die LDAP-Federation mit bobctl configure-idp konfiguriert hast, können sich Benutzer mit ihren bestehenden Unternehmens-Anmeldeinformationen authentifizieren. Siehe LDAP-Integration.

Direkte Keycloak-Benutzer: Benutzer direkt in Keycloak erstellen und verwalten. Dieser Ansatz eignet sich für Evaluierungsumgebungen, die keine LDAP-Integration verwenden.

Endpoint-URL abrufen und teilen

Stelle Benutzern die Endpoint-Informationen bereit, die für die Verbindung mit Bob erforderlich sind.

Bob-Gateway-Route-Hostname abrufen:

oc get route \
  -n <instanz-namespace> \
  -l app.kubernetes.io/component=gateway \
  -o jsonpath='{.items[0].spec.host}'

Beispielausgabe:

api.bob.example.com

Endpoint-URL erstellen:

https://api.bob.example.com

Wenn keine Route verfügbar ist, überprüfe, ob die Bob-Instanz bereit ist:

oc get bob -n <instanz-namespace>

Bestätige, dass der Status Ready ist, und stelle Benutzern dann die folgenden Informationen bereit:

Element	Erforderlich
Bob-Endpoint-URL	Ja
CA-Zertifikat (`bob-ca.crt`)	Nur bei Verwendung einer selbstsignierten oder privaten CA
Authentifizierungsdetails	Ja

Post-Installations-Aufgaben

IDP- und LDAP-Federation konfigurieren

Zertifikate verwalten

Benutzerzugang konfigurieren

Endpoint-URL abrufen und teilen

Auf dieser Seite