Completa le attività post-installazione richieste per preparare IBM Bob agli utenti finali, inclusi certificati TLS, federazione LDAP, accesso degli utenti e distribuzione dell'endpoint.

Dopo aver installato Bob on-premises, esegui le seguenti attività amministrative prima di eseguire l'onboarding degli utenti.

Configurare IDP e federazione LDAP

Con la federazione LDAP, puoi accedere a Bob utilizzando le tue credenziali LDAP o Active Directory esistenti. Configura la federazione LDAP solo se la tua organizzazione usa un servizio di directory per la gestione delle identità. Se la federazione LDAP non è richiesta, crea gli utenti direttamente in Keycloak.

Ottieni i valori di configurazione LDAP o Active Directory richiesti, inclusi:

URL del server LDAP
Base di ricerca di utenti e gruppi
Informazioni sull'account bind (se applicabile)
Certificato CA per le connessioni LDAPS che usano un'autorità di certificazione privata

Crea un file di configurazione IDP dal template fornito:

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

Aggiorna il file con i tuoi domini email, le email degli amministratori e i dettagli dell'ambiente LDAP o Active Directory.

Applica la configurazione IDP:

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

Parametro	Descrizione
`--config`	Specifica il file di configurazione IDP.
`--dry-run`	Valida la configurazione senza applicare le modifiche.

Verifica la configurazione IDP.

Visualizza lo stato dell'IDP:

oc get bobidp -n <instance-namespace>

Visualizza le informazioni di riconciliazione dettagliate:

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

Verifica che le seguenti condizioni riportino uno stato di successo:

Condizione	Descrizione
`Ready`	Tutti i domini configurati, le assegnazioni degli amministratori e i provider LDAP sono stati riconciliati correttamente.
`LDAPRegistered`	Il provider LDAP è stato registrato in Keycloak.
`LDAPReachable`	Il server LDAP è raggiungibile dal cluster.
`LDAPAuthenticated`	L'autenticazione LDAP è stata completata correttamente.
`LDAPUserSyncSucceeded`	Sincronizzazione iniziale degli utenti completata correttamente. Presente solo quando `userSync.enabled: true`.

Per impostazione predefinita, bobctl attende fino a 600 secondi per il completamento della riconciliazione. Per modificare il timeout:

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

Puoi configurare più provider LDAP in un singolo file di configurazione definendo più voci nell'elenco ldaps. Non è necessaria un'invocazione separata di bobctl configure-idp per ciascun provider.

Per i dettagli completi della configurazione LDAP, vedere Integrazione LDAP.

Gestire i certificati

Bob espone i servizi tramite TLS. Le workstation client devono considerare attendibile l'autorità di certificazione (CA) che ha emesso i certificati del cluster.

Puoi usare uno dei seguenti approcci per i certificati:

Configurare un certificato enterprise o pubblico (consigliato)

Generare certificati con OpenSSL

Usare il certificato self-signed predefinito

Nota:

Gli errori di connessione TLS in Bob IDE o bob-shell sono tipicamente causati da un certificato CA non attendibile sulla workstation client.

Per istruzioni complete, vedere Certificati TLS.

Configurare l'accesso degli utenti

Un'installazione on-premises di Bob include un identity provider Keycloak. Prima che gli utenti possano accedere alla piattaforma, configura uno dei seguenti metodi di autenticazione:

Federazione LDAP o Active Directory: se hai configurato la federazione LDAP usando bobctl configure-idp, gli utenti possono autenticarsi con le proprie credenziali aziendali esistenti. Vedere Integrazione LDAP.

Utenti Keycloak diretti: crea e gestisci gli utenti direttamente in Keycloak. Questo approccio è adatto per ambienti di valutazione che non utilizzano l'integrazione LDAP.

Recuperare e condividere l'URL dell'endpoint

Fornisci agli utenti le informazioni sull'endpoint necessarie per connettersi a Bob.

Recupera il hostname della route del gateway Bob:

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

Output di esempio:

api.bob.example.com

Costruisci l'URL dell'endpoint:

https://api.bob.example.com

Se non è disponibile alcuna route, verifica che l'istanza Bob sia pronta:

oc get bob -n <instance-namespace>

Conferma che lo stato sia Ready, poi fornisci agli utenti le seguenti informazioni:

Elemento	Obbligatorio
URL endpoint Bob	Sì
Certificato CA (`bob-ca.crt`)	Solo quando si usa una CA self-signed o privata
Dettagli di autenticazione	Sì

Attività post-installazione

Configurare IDP e federazione LDAP

Gestire i certificati

Configurare l'accesso degli utenti

Recuperare e condividere l'URL dell'endpoint

In questa pagina