Tâches post-installation
Effectuez les tâches post-installation requises pour préparer IBM Bob aux utilisateurs finaux, notamment les certificats TLS, la fédération LDAP, l'accès des utilisateurs et la distribution de l'endpoint.
Après avoir installé Bob auto-hébergé, effectuez les tâches administratives suivantes avant d'intégrer les utilisateurs.
Configurer la fédération IDP et LDAP
Avec la fédération LDAP, tu peux te connecter à Bob avec tes credentials LDAP ou Active Directory existants. Configure la fédération LDAP uniquement si ton organisation utilise un service d'annuaire pour la gestion des identités. Si la fédération LDAP n'est pas requise, crée les utilisateurs directement dans Keycloak.
Obtenez les valeurs de configuration LDAP ou Active Directory requises, notamment :
- L'URL du serveur LDAP
- Les bases de recherche des utilisateurs et des groupes
- Les informations du compte de liaison (si applicable)
- Le certificat CA pour les connexions LDAPS qui utilisent une autorité de certification privée
Crée un fichier de configuration IDP à partir du modèle fourni :
cp config-idp-template.yaml my-idp.yamlMets à jour le fichier avec tes domaines de messagerie, les adresses e-mail des administrateurs, et les détails de ton environnement LDAP ou Active Directory.
Applique la configuration IDP :
./bobctl configure-idp --config my-idp.yaml| Paramètre | Description |
|---|---|
--config | Spécifie le fichier de configuration IDP. |
--dry-run | Valide la configuration sans appliquer les changements. |
Vérifie la configuration IDP.
Affiche le statut IDP :
oc get bobidp -n <instance-namespace>Affiche les informations de réconciliation détaillées :
oc get bobidp bob-idp -n <instance-namespace> -o yamlVérifiez que les conditions suivantes signalent un statut réussi :
| Condition | Description |
|---|---|
Ready | Tous les domaines configurés, les attributions d'administrateurs et les fournisseurs LDAP ont été réconciliés avec succès. |
LDAPRegistered | Le fournisseur LDAP a été enregistré dans Keycloak. |
LDAPReachable | Le serveur LDAP est accessible depuis le cluster. |
LDAPAuthenticated | L'authentification LDAP s'est terminée avec succès. |
LDAPUserSyncSucceeded | La synchronisation initiale des utilisateurs s'est terminée avec succès. Présent uniquement lorsque userSync.enabled: true. |
Par défaut, bobctl attend jusqu'à 600 secondes la fin de la réconciliation. Pour modifier le délai d'attente :
BOB_IDP_WAIT_TIMEOUT=900 ./bobctl configure-idp --config my-idp.yamlTu peux configurer plusieurs fournisseurs LDAP dans un seul fichier de configuration en définissant plusieurs entrées dans la liste ldaps. Il n'est pas nécessaire d'appeler bobctl configure-idp séparément pour chaque fournisseur.
Pour des détails complets sur la configuration LDAP, voir Intégration LDAP.
Gérer les certificats
Bob expose ses services via TLS. Les postes de travail client doivent approuver l'autorité de certification (AC) qui a émis les certificats du cluster.
Vous pouvez utiliser l'une des approches de certificat suivantes :
- Configurer un certificat d'entreprise ou public (recommandé)
- Générer des certificats avec OpenSSL
- Utiliser le certificat autosigné par défaut
Les erreurs de connexion TLS dans Bob IDE ou bob-shell sont généralement causées par un certificat CA non approuvé sur le poste de travail client.
Pour des instructions complètes, voir Certificats TLS.
Configurer l'accès des utilisateurs
Une installation auto-hébergée de Bob inclut un fournisseur d'identité Keycloak. Avant que les utilisateurs puissent accéder à la plateforme, configurez l'une des méthodes d'authentification suivantes :
- Fédération LDAP ou Active Directory : si tu as configuré la fédération LDAP à l'aide de
bobctl configure-idp, les utilisateurs peuvent s'authentifier avec leurs credentials d'entreprise existants. Voir Intégration LDAP. - Utilisateurs Keycloak directs : crée et gère les utilisateurs directement dans Keycloak. Cette approche convient aux environnements d'évaluation qui n'utilisent pas l'intégration LDAP.
Récupérer et partager l'URL de l'endpoint
Fournissez aux utilisateurs les informations d'endpoint requises pour se connecter à Bob.
Récupérez le nom d'hôte de la route de la passerelle Bob :
oc get route \
-n <instance-namespace> \
-l app.kubernetes.io/component=gateway \
-o jsonpath='{.items[0].spec.host}'Exemple de sortie :
api.bob.example.comConstruisez l'URL de l'endpoint :
https://api.bob.example.comSi aucune route n'est disponible, vérifiez que l'instance Bob est prête :
oc get bob -n <instance-namespace>Confirmez que le statut est Ready, puis fournissez aux utilisateurs les informations suivantes :
| Élément | Requis |
|---|---|
| URL de l'endpoint Bob | Oui |
Certificat CA (bob-ca.crt) | Uniquement lors de l'utilisation d'une AC autosignée ou privée |
| Détails d'authentification | Oui |