Tareas post-instalación
Completa las tareas post-instalación requeridas para preparar IBM Bob para los usuarios finales, incluyendo certificados TLS, federación LDAP, acceso de usuarios y distribución de endpoints.
Después de instalar Bob self-hosted, realiza las siguientes tareas administrativas antes de incorporar a los usuarios.
Configurar IDP y federación LDAP
Con la federación LDAP, puedes iniciar sesión en Bob usando tus credenciales de LDAP o Active Directory existentes. Configura la federación LDAP solo si tu organización usa un servicio de directorio para la gestión de identidades. Si no se requiere federación LDAP, crea usuarios directamente en Keycloak.
Obtén los valores de configuración de LDAP o Active Directory requeridos, incluyendo:
- URL del servidor LDAP
- Bases de búsqueda de usuarios y grupos
- Información de cuenta de bind (si aplica)
- Certificado CA para conexiones LDAPS que usan una autoridad de certificación privada
Crea un archivo de configuración de IDP a partir de la plantilla proporcionada:
cp config-idp-template.yaml my-idp.yamlActualiza el archivo con tus dominios de correo electrónico, correos electrónicos de administradores y detalles del entorno de LDAP o Active Directory.
Aplica la configuración de IDP:
./bobctl configure-idp --config my-idp.yaml| Parámetro | Descripción |
|---|---|
--config | Especifica el archivo de configuración de IDP. |
--dry-run | Valida la configuración sin aplicar cambios. |
Verifica la configuración de IDP.
Ver el estado de IDP:
oc get bobidp -n <instance-namespace>Ver información detallada de reconciliación:
oc get bobidp bob-idp -n <instance-namespace> -o yamlVerifica que las siguientes condiciones reportan un estado exitoso:
| Condición | Descripción |
|---|---|
Ready | Todos los dominios configurados, asignaciones de administrador y proveedores LDAP se reconciliaron correctamente. |
LDAPRegistered | El proveedor LDAP fue registrado en Keycloak. |
LDAPReachable | El servidor LDAP es accesible desde el clúster. |
LDAPAuthenticated | La autenticación LDAP se completó correctamente. |
LDAPUserSyncSucceeded | La sincronización inicial de usuarios se completó correctamente. Solo aparece cuando userSync.enabled: true. |
Por defecto, bobctl espera hasta 600 segundos para que la reconciliación se complete. Para cambiar el tiempo de espera:
BOB_IDP_WAIT_TIMEOUT=900 ./bobctl configure-idp --config my-idp.yamlPuedes configurar múltiples proveedores LDAP en un único archivo de configuración definiendo múltiples entradas en la lista ldaps. No es necesaria una invocación separada de bobctl configure-idp para cada proveedor.
Para detalles completos de configuración LDAP, consulta Integración LDAP.
Gestionar certificados
Bob expone servicios sobre TLS. Las estaciones de trabajo de los clientes deben confiar en la autoridad de certificación (CA) que emitió los certificados del clúster.
Puedes usar uno de los siguientes enfoques de certificados:
- Configurar un certificado empresarial o público (recomendado)
- Generar certificados con OpenSSL
- Usar el certificado autofirmado predeterminado
Los errores de conexión TLS en Bob IDE o bob-shell suelen estar causados por un certificado CA que no es de confianza en la estación de trabajo del cliente.
Para instrucciones completas, consulta Certificados TLS.
Configurar el acceso de usuarios
Una instalación Bob self-hosted incluye un proveedor de identidad Keycloak. Antes de que los usuarios puedan acceder a la plataforma, configura uno de los siguientes métodos de autenticación:
- Federación LDAP o Active Directory: si configuraste la federación LDAP usando
bobctl configure-idp, los usuarios pueden autenticarse con sus credenciales empresariales existentes. Consulta Integración LDAP. - Usuarios directos de Keycloak: crea y gestiona usuarios directamente en Keycloak. Este enfoque es adecuado para entornos de evaluación que no usan la integración LDAP.
Recuperar y compartir la URL del endpoint
Proporciona a los usuarios la información de endpoint requerida para conectarse a Bob.
Recupera el hostname de la ruta del gateway de Bob:
oc get route \
-n <instance-namespace> \
-l app.kubernetes.io/component=gateway \
-o jsonpath='{.items[0].spec.host}'Ejemplo de salida:
api.bob.example.comConstruye la URL del endpoint:
https://api.bob.example.comSi no hay una ruta disponible, verifica que la instancia de Bob está lista:
oc get bob -n <instance-namespace>Confirma que el estado es Ready, luego proporciona a los usuarios la siguiente información:
| Elemento | Requerido |
|---|---|
| URL del endpoint de Bob | Sí |
Certificado CA (bob-ca.crt) | Solo cuando se usa una CA autofirmada o privada |
| Detalles de autenticación | Sí |