Conclua as tarefas pós-instalação necessárias para preparar o IBM Bob para os usuários finais, incluindo certificados TLS, federação LDAP, acesso de usuários e distribuição de endpoints.

Após instalar o Bob on-premises, realize as seguintes tarefas administrativas antes do onboarding dos usuários.

Configurar federação IDP e LDAP

Com a federação LDAP, você pode fazer login no Bob usando suas credenciais LDAP ou Active Directory existentes. Configure a federação LDAP apenas se sua organização usar um serviço de diretório para gerenciamento de identidade. Se a federação LDAP não for necessária, crie usuários diretamente no Keycloak.

Obtenha os valores de configuração LDAP ou Active Directory necessários, incluindo:

URL do servidor LDAP
Bases de busca de usuários e grupos
Informações da conta de bind (se aplicável)
Certificado CA para conexões LDAPS que usam uma autoridade de certificação privada

Crie um arquivo de configuração IDP a partir do template fornecido:

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

Atualize o arquivo com seus domínios de e-mail, e-mails de administrador e os detalhes do ambiente LDAP ou Active Directory.

Aplique a configuração IDP:

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

Parâmetro	Descrição
`--config`	Especifica o arquivo de configuração IDP.
`--dry-run`	Valida a configuração sem aplicar as mudanças.

Verifique a configuração IDP.

Visualize o status do IDP:

oc get bobidp -n <instance-namespace>

Visualize informações detalhadas de reconciliação:

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

Verifique se as seguintes condições reportam um status de sucesso:

Condição	Descrição
`Ready`	Todos os domínios configurados, atribuições de administrador e provedores LDAP foram reconciliados com sucesso.
`LDAPRegistered`	O provedor LDAP foi registrado no Keycloak.
`LDAPReachable`	O servidor LDAP está alcançável a partir do cluster.
`LDAPAuthenticated`	A autenticação LDAP foi concluída com sucesso.
`LDAPUserSyncSucceeded`	A sincronização inicial de usuários foi concluída com sucesso. Presente apenas quando `userSync.enabled: true`.

Por padrão, o bobctl aguarda até 600 segundos para que a reconciliação seja concluída. Para alterar o timeout:

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

Você pode configurar múltiplos provedores LDAP em um único arquivo de configuração definindo múltiplas entradas na lista ldaps. Não é necessária uma invocação separada de bobctl configure-idp para cada provedor.

Para detalhes completos de configuração LDAP, consulte Integração LDAP.

Gerenciar certificados

O Bob expõe serviços sobre TLS. As estações de trabalho de clientes devem confiar na autoridade de certificação (CA) que emitiu os certificados do cluster.

Você pode usar uma das seguintes abordagens de certificado:

Configurar um certificado empresarial ou público (recomendado)

Gerar certificados com OpenSSL

Usar o certificado autoassinado padrão

Nota:

Erros de conexão TLS no Bob IDE ou bob-shell são normalmente causados por um certificado CA não confiável na estação de trabalho do cliente.

Para instruções completas, consulte Certificados TLS.

Configurar acesso de usuários

Uma instalação on-premises do Bob inclui um provedor de identidade Keycloak. Antes que os usuários possam acessar a plataforma, configure um dos seguintes métodos de autenticação:

Federação LDAP ou Active Directory: se você configurou a federação LDAP usando bobctl configure-idp, os usuários podem autenticar-se com suas credenciais empresariais existentes. Consulte Integração LDAP.

Usuários diretos no Keycloak: crie e gerencie usuários diretamente no Keycloak. Essa abordagem é adequada para ambientes de avaliação que não usam integração LDAP.

Recuperar e compartilhar a URL do endpoint

Forneça aos usuários as informações de endpoint necessárias para conectar-se ao Bob.

Recupere o nome do host da rota do gateway Bob:

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

Exemplo de saída:

api.bob.example.com

Construa a URL do endpoint:

https://api.bob.example.com

Se nenhuma rota estiver disponível, verifique se a instância Bob está pronta:

oc get bob -n <instance-namespace>

Confirme que o status é Ready e forneça aos usuários as seguintes informações:

Item	Obrigatório
URL do endpoint Bob	Sim
Certificado CA (`bob-ca.crt`)	Somente ao usar uma CA autoassinada ou privada
Detalhes de autenticação	Sim

Tarefas pós-instalação

Configurar federação IDP e LDAP

Gerenciar certificados

Configurar acesso de usuários

Recuperar e compartilhar a URL do endpoint

Nesta página