2.1 Instalando o OpenText Identity Console CE 24.4 (v1.9)

2.1.1 Instalando o OpenText Identity Console autônomo (não Docker)

Você pode instalar o OpenText Identity Console de uma das seguintes maneiras:

NOTA:Para garantir a funcionalidade adequada, recomendamos que você instale o OpenText Identity Console e o OpenText eDirectory na mesma máquina, que deve ter pelo menos uma instância do OpenText eDirectory disponível.

Executando uma instalação interativa

Esta seção aborda como instalar o OpenText Identity Console autônomo usando o método de instalação interativa.

  1. Efetue login no portal Download e licença de software e navegue até a página Downloads de software.

  2. Selecione o seguinte:

    • Produto: OpenText eDirectory

    • Nome do produto: OpenText eDirectory per User Sub SW E-LTU

    • Versão: 9.2, 9.3

  3. Baixe e extraia o build mais recente do OpenText Identity Console.

  4. Navegue até o diretório onde você extraiu o build do OpenText Identity Console > IdentityConsole_<versão>_Linux.

  5. Execute o seguinte comando enquanto estiver logado como usuário root ou equivalente:

    ./identityconsole_install
  6. Leia a Introdução e clique em ENTER.

  7. Digite 'y' para aceitar o contrato de licença. Isso instala todos os RPMs necessários no seu sistema.

  8. Digite o nome de host do servidor do Identity Console (FQDN)/endereço IP. Por exemplo, 10.10.33.100

    Se você pressionar Enter sem especificar um endereço IP, o endereço IP/nome de host do seu sistema será usado por padrão.

  9. Digite o número da porta para o Identity Console escutar. O valor padrão é 9000.

  10. Especifique quais eDirectory-hosts conectar. Você pode fornecer o endereço IP ou o nome do domínio. Por exemplo: localhost:636,xx.xx.xx.xx:636 ou edir.domain.com:636

  11. (Condicional) Escolha uma das seguintes opçõeses com base em seus requisitos:

    • Se você não quiser integrar o OSP ao OpenText Identity Console, escolha "n" e continue com Etapa 12.

    • Se quiser integrar o OSP ao OpenText Identity Console, escolha "y" e forneça entradas para as seguintes etapas:

      1. Digite o nome de domínio/endereço IP do servidor do eDirectory/cofre de identidade com o número da porta LDAPS.

        Por exemplo:

        192.168.1.1:636

      2. Digite o nome de usuário do eDirectory/cofre de identidade.

        Exemplo:

        cn=admin,ou=org_unit,o=org

      3. Digite a senha do eDirectory/cofre de identidade.

      4. Digite novamente a senha do eDirectory/cofre de identidade para confirmá-la.

      5. Digite o nome de domínio/endereço IP do servidor do OSP com o número da porta SSL do servidor SSO.

      6. Insira o ID do cliente do OSP e a senha do cliente do OSP.

      7. Digite o nome da árvore do eDirectory/cofre de identidade.

  12. (Condicional) escolha uma das seguintes opções com base em seus requisitos:.

    • Se você quiser buscar automaticamente os certificados de CA, escolha buscar automaticamente como y.

    • Se você não quiser buscar automaticamente os certificados de CA, escolha buscar automaticamente como n.

  13. (Condicional) Escolha uma das seguintes opçõeses com base em seus requisitos:

    • Se desejar importar o certificado de CA do servidor, insira y e pressione Enter.

      O certificado de CA é copiado com êxito em /etc/opt/novell/eDirAPI/cert.

      Para buscar ou adicionar manualmente o certificado de CA, consulte Gerar certificado de CA

    • Se você não quiser importar o certificado de CA do servidor, insira n e pressione Enter.

    • Se você digitar "q", a instalação será terminada.

  14. (Condicional) Escolha uma das seguintes opções para gerar um Certificado do Servidor:

    • Se desejar gerar o Certificado do Servidor, insira "y" e pressione Enter. Forneça entradas para as seguintes etapas:

      1. Insira o nome de usuário do eDirectory. Exemplo: cn=admin,o=novell.

      2. Digite a senha de usuário do eDirectory.

      3. Digite novamente a senha de usuário do eDirectory.

      4. Digite o nome do certificado do servidor.

        Exemplo: servercert

      5. Digite a senha do certificado do servidor.

        Exemplo: password@123

      6. Digite novamente a senha do certificado do servidor.

        Exemplo: password@123

    • Se você já tiver um Certificado do Servidor que deseja usar, insira "n" e pressione Enter. Forneça entradas para as seguintes etapas:

      1. Especifique o local do caminho do diretório Certificado do Servidor manualmente.

        Por exemplo, /home/cert/keys.pfx

      2. Digite a senha do certificado do servidor.

      3. Digite novamente a senha do certificado do servidor.

NOTA:

  • É possível encontrar os seguintes arquivos de registro no diretório /var/opt/novell/eDirAPI/log:

    • edirapi.log – Este arquivo registra eventos edirapi e problemas de depuração.

    • edirapi_audit.log – Este arquivo registra eventos de auditoria do edirapi. Os registros seguem o formato de auditoria CEF.

    • identityconsole_install.log – Este arquivo registra eventos do OpenText Identity Console.

  • Você pode verificar os registros para operações de início e interrupção do OpenText Identity Console no arquivo /var/log/messages.

  • Se a instalação falhar, use o seguinte comando para reconfigurar:

    /usr/bin/identityconsoleConfigure

Utilitários para gerar certificados

Você tem a opção de obter certificados de CA e Certificados de Servidor para outras árvores usando as seguintes ferramentas ou utilitários.

NOTA:Os scripts para certificado de CA e de servidor estão disponíveis no caminho opt/novell/eDirAPI/sbin.

Gerar certificado de CA

  1. Baixe e extraia o build mais recente do OpenText Identity Console.

  2. Navegue até o diretório /opt/novell/eDirAPI/sbin para buscar, apagar ou exibir a lista de certificados de CA.

  3. Execute o seguinte comando enquanto estiver logado como usuário root ou equivalente.

    ./get_cacert fetch <ip address/DNS:ldaps port>

    Por exemplo:

    ./get_cacert fetch 10.10.10.10:636
  4. Para adicionar manualmente o certificado de CA na pasta cert, navegue até /etc/opt/novell/eDirAPI/cert e copie e cole o certificado de CA.

    <IP address/DNS_ldaps port.pem>

    Por exemplo:

    10.10.10.10_636.pem

Gerar certificado do servidor

  1. Baixe e extraia o build mais recente do OpenText Identity Console.

  2. Navegue até o diretório para buscar, apagar ou ver a lista de certificados de CA > /opt/novell/eDirAPI/sbin

  3. Execute o seguinte comando enquanto estiver logado como usuário root ou equivalente.

    ./get_servercert <eDirectory IP address with LDAPS port number> <eDirectory/Identity Vault username> <userpassword> <server certificate name> <server certificate password>

    Exemplo:

    ./get_servercert 10.10.10.10:636 cn=admin,ou=org_unit,o=org password keys password 

Realizando uma instalação silenciosa

A instalação silenciosa permite que você instale o OpenText Identity Console sem nenhuma entrada interativa. Para usar esse método, você deve definir suas opções para instalar o OpenText Identity Console no arquivo silent_properties e, em seguida, executar o processo de instalação usando a linha de comando. Depois de modificar o arquivo de propriedades, o sistema usa as informações dele para concluir a instalação silenciosamente.

Antes de iniciar a instalação silenciosa, atender a todos os pré-requisitos.

Para editar o arquivo de propriedades silenciosas:

  1. Navegue até o diretório IdentityConsole_<versão>_Linux no local onde você extraiu o build do OpenText Identity Console.

  2. Abra o arquivo silent_properties e modifique os valores de acordo com seu requisito:

    • Se auto fetch for Yes,

      1. Digite os seguintes detalhes no arquivo silent_properties:

        export AUTOGENERATE_CACERT="Yes" export AUTOGENERATE_SERVERCERT="Yes" export EDIR_HOST="" export IDC_IP="" export IDC_PORT="9000" export OSP_CLIENT_ID="identityconsole" export OSP_CLIENT_PASSWD="novell" export OSP_IP="" export OSP_MODE="No" export AUTO_FETCH="Yes" export SERVERCERT_NAME="cert" export SERVERCERT_PASSWORD="novell" export SERVERCERT_USERNAME="cn=admin,o=novell" export SERVERCERT_USER_PASSWORD="novell" export TREENAME="my_tree" export VAULT_IP="" export VAULT_USERNAME="cn=admin,o=novell" export VAULT_PASSWD="novell"
        
      2. Execute o seguinte comando para instalar no modo silencioso:

        ./identityconsole_install -s silent_properties
    • Se auto fetch for No,

      1. Digite os seguintes detalhes no arquivo silent_properties:

        export AUTOGENERATE_CACERT="No" export AUTOGENERATE_SERVERCERT="No" export EDIR_HOST="" export IDC_IP="" export IDC_PORT="9000" export OSP_CLIENT_ID="identityconsole" export OSP_CLIENT_PASSWD="novell" export OSP_IP="" export OSP_MODE="No" export AUTO_FETCH="No" export SERVERCERT_LOCATION="/etc/opt/novell/eDirAPI/cert/SSCert.pem" export SERVERCERT_NAME="cert" export SERVERCERT_PASSWORD="novell" export SERVERCERT_USERNAME="cn=admin,o=novell" export SERVERCERT_USER_PASSWORD="novell" export TREENAME="my_tree" export VAULT_IP="" export VAULT_USERNAME="cn=admin,o=novell" export VAULT_PASSWD="novell"
        
      2. Copie manualmente o certificado da CA para a pasta /etc/opt/novell/eDirAPI/cert/.

      3. Execute o seguinte comando para instalar o rpm:

        ./identityconsole_rpm_install
      4. Depois de instalar o rpm, execute o seguinte comando para executar o instalador no modo silencioso:

        ./identityconsoleConfigure -s silent_properties

Você pode encontrar registros relacionados à instalação no arquivo de Instalação do Identity Console > identityconsole_install.log.

Multiárvore com OpenText Identity Console autônomo

Para conectar o OpenText Identity Console a várias árvores do OpenText eDirectory quando a busca automática estiver desabilitada, você deve copiar os certificados de CA de todas as árvores do OpenText eDirectory para o diretório /etc/opt/novell/eDirAPI/cert/.

Copie os certificados de CA da seguinte forma:

cp /home/user/<ip address1_ldap port.pem> /etc/opt/novell/eDirAPI/cert/<ip address1_ldap port.pem>
cp /home/user/<ip address2_ldap port.pem> /etc/opt/novell/eDirAPI/cert/<ip address2_ldap port.pem>

Para buscar o certificado de CA usando o utilitário get_cacert, consulte a seção Gerar certificado de CA.

Execute um dos seguintes comandos para reiniciar o OpenText Identity Console:

  • /usr/bin/identityconsole restart
  • systemctl restart netiq-identityconsole.service

Quando a busca automática está habilitada, os certificados de CA são copiados automaticamente para a pasta cert.

Substituindo o certificado do servidor no OpenText Identity Console autônomo

Execute as seguintes etapas para substituir o certificado do servidor no OpenText Identity Console autônomo:

  1. Execute NLPCERT para armazenar as chaves:

    su - nds -c "/opt/novell/eDirAPI/sbin/decryptor /Expiredcert/noexpire/new-keys.pfx novell /etc/opt/novell/eDirAPI/conf/ssl/private/cert.pem"
  2. Reinicie o OpenText Identity Console:

    systemctl restart netiq-identityconsole.service

Parando, reiniciando e status do OpenText Identity Console autônomo

  • Para parar, execute um dos seguintes comandos:

    /usr/bin/identityconsole stop

    ou

    systemctl stop netiq-identityconsole.service
  • Para reiniciar, execute um dos seguintes comandos:

    /usr/bin/identityconsole restart

    ou

    systemctl restart netiq-identityconsole.service
  • Para verificar o status, execute um dos seguintes comandos:

    /usr/bin/identityconsole status

    ou

    systemctl status netiq-identityconsole.service
  • Para iniciar, execute um dos seguintes comandos:

    /usr/bin/identityconsole start

    ou

    systemctl start netiq-identityconsole.service

2.1.2 Instalando a estação de trabalho do OpenText Identity Console no Windows

O OpenText Identity Console pode ser lançado no Windows como estação de trabalho e requer os serviços REST em execução. Portanto, quando é iniciado, um processo eDirAPI é executado no prompt cmd edirapi.exe. Se você fechar o terminal edirapi.exe, o OpenText Identity Console não funcionará mais.

O procedimento a seguir descreve como executar o OpenText Identity Console no Windows.

  1. Efetue login no portal Download e licença de software e navegue até a página Downloads de software.

  2. Selecione o seguinte:

    • Produto: OpenText eDirectory

    • Nome do produto: OpenText eDirectory per User Sub SW E-LTU

    • Versão: 9.2, 9.3

  3. Faça download e extraia o conteúdo de IdentityConsole_<versão>_workstation_win_x86_64.zip.

  4. Navegue até a pasta extraída e instale NICI_wx64.

  5. (Opcional) Abra o arquivo edirapi_win.conf e edite o número da porta para que o OpenText Identity Console escute.

  6. (Condicional) Se você já tiver os arquivos keys.pfx e SSCert.pem que deseja usar, altere o nome do arquivo do certificado de CA para <ipaddress_ldap>.pem(xx.xx.xx.xxx_636.pem) e copie os arquivos manualmente para a pasta cert localizada em C:/IdentityConsole_<versão>_workstation_win_x86_64/DireAPI/cert.

    Em seguida, vá para a etapa 9.

  7. (Condicional) Se quiser gerar o certificado de CA, navegue até a pasta eDirAPI, execute o get_cacert.exe fetch <IP address_port.pem> binário no prompt de comando, localizado em C:/IdentityConsole_version_workstation_win_x86_64/eDirAPI e forneça o nome de domínio/endereço IP do servidor OpenText eDirectory/repositório de identidades com o número da porta LDAPS.

    Por exemplo,

    get_cacert.exe fetch 10.10.10.125:636

    o arquivo 10.10.10.125_636.pem é gerado.

  8. (Condicional) Se você quiser gerar o Certificado do Servidor, execute o binário get_servercert.exe help por meio do prompt de comando, juntamente com os seguintes detalhes:

    • Nome de domínio/endereço IP do servidor do eDirectory/Identity Vault com o número da porta LDAPS.

    • Nome de usuário do eDirectory/Identity Vault.

    • Senha do eDirectory/Identity Vault.

    • Nome do certificado do servidor.

    • Senha do certificado do servidor.

    Por exemplo,

    get_servercert.exe 10.10.10.125:636 cn=admin,o=novell novell keys novell

    Um arquivo keys.pfx é gerado.

  9. Navegue até a pasta extraída, clique duas vezes no arquivo configure.bat e digite a senha do certificado do servidor (keys.pfx) no prompt de comando.

    NOTA:Se o certificado do servidor for mudado, execute novamente o arquivo configure.bat com a senha do novo certificado.

  10. Navegue até a pasta extraída e clique duas vezes no arquivo run.bat.

    O terminal de processos eDirAPI (edirapi.exe) começa a funcionar e a página de login do OpenText Identity Console é exibida.

NOTA:

  • Para logins subsequentes no aplicativo OpenText Identity Console, clique duas vezes no botão run.bat. A página de login será exibida.

    Se o terminal de processos eDirAPI (edirapi.exe) já estiver em execução, execute identityconsole.exe da pasta em que o build foi extraído.

  • Os usuários podem encontrar os seguintes registros em: \IdentityConsole_<versão>_workstation_win_x86_64\eDirAPI\log

    edirapi.log — É usado para registrar diferentes eventos em problemas de depuração e edirapi.

    edirapi_audit.log — É usado para registrar eventos de auditoria do edirapi. Os registros seguem o formato de auditoria CEF.

  • Os logins baseados em OSP não têm suporte no modo de estação de trabalho.

  • Se o número da porta já estiver em uso, edite o parâmetro listen no arquivo edirapi_win.conf com um novo número de porta e clique duas vezes no run.bat para fazer login com sucesso no OpenText Identity Console.

Utilitários para gerar certificados

Você tem a opção de obter certificados de CA e certificados de servidor para outras árvores do OpenText eDirectory usando os seguintes utilitários.

NOTA:Os scripts para certificado de CA e de servidor estão disponíveis no caminho opt/novell/eDirAPI/sbin.

Gerar certificado de CA

  1. Baixe e extraia o build mais recente do OpenText Identity Console.

  2. Navegue até o diretório no qual você extraiu o build do OpenText Identity Console. Exemplo: C:/IdentityConsole_<versão>_workstation_win_x86_64/eDirAPI

  3. Execute o seguinte binário por meio do prompt de comando.

    get_cacert.exe fetch <ip address:port>

    Forneça o endereço IP do OpenText eDirectory e o número da porta LDAPS.

    Exemplo: get_cacert.exe fetch 10.10.10.125:636

    O arquivo 10.10.10.125_636.pem é gerado e copiado para a pasta cert.

Gerar certificado do servidor

  1. Navegue até a pasta na qual você extraiu o build do OpenText Identity Console.

    Exemplo: IdentityConsole_<versão>_WIN

  2. Execute get_servercert.exe help para obter mais opções de ajuda por meio do prompt de comando.

    • Nome de domínio/endereço IP do servidor do eDirectory/Identity Vault com o número da porta LDAPS.

    • Nome de usuário do eDirectory/Identity Vault.

    • Senha do eDirectory/Identity Vault.

    • Nome do certificado do servidor.

    • Senha do certificado do servidor.

      Para gerar o certificado do servidor, execute o seguinte comando por meio do prompt de comando:

      Exemplo:

      get_servercert.exe 10.10.10.125:636 cn=admin,o=novell novell keys novell

      O arquivo keys.pfx é gerado e copiado para a pasta cert.

Multiárvore com o OpenText Identity Console como estação de trabalho

O OpenText Identity Console permite que o usuário se conecte a várias árvores inserindo o endereço IP na página de login.

Fechar e reiniciar a estação de trabalho do OpenText Identity Console

Para fechar o aplicativo e o processo:

  1. Feche o aplicativo da área de serviço do OpenText Identity Console para Windows.

  2. Pare o processo eDirAPI fechando o terminal de processos eDirAPI.

Para reiniciar a estação de trabalho do OpenText Identity Console, navegue até a pasta na qual o build é extraído e clique duas vezes no arquivo run.bat (arquivo de lote do Windows).

NOTA:Se o terminal de processo eDirAPI já estiver em execução, execute identityconsole.exe da pasta em que o build foi extraído para reiniciar a estação de trabalho do OpenText Identity Console.

2.1.3 Instalando o OpenText Identity Console como container do Docker

Esta seção inclui os seguintes procedimentos:

Recomendações de segurança

  • Os containers do Docker não têm nenhuma restrição de recurso por padrão. Isso fornece a todos os containers o acesso a todos os recursos de CPU e memória fornecidos pelo kernel do host. Você também deve definir limites para a quantidade de recursos que podem ser usados por um container para garantir que um container em execução não consuma mais recursos do que o limite, fazendo com que falte recursos para outros containers em execução.

    • O container do Docker deve garantir que um limite físico seja aplicado à memória usada pelo container usando o flag --memory no comando de execução do Docker.

    • O container do Docker deve garantir que um limite seja aplicado à quantidade de CPU usada por um container em execução usando o flag --cpuset-cpus no comando de execução do Docker.

  • --pids-limit deve ser definido como 300 para restringir o número de threads do kernel gerados dentro do container a qualquer momento. Isso é para evitar ataques de DoS.

  • Você deve definir a política de reinício do container em falha como 5 usando o flag --restart no comando de execução do Docker.

  • Você deve usar o container do apenas quando o status de integridade aparecer como Healthy (Íntegro) depois que o container aparecer. Para verificar o status de saúde do container, execute o seguinte comando:

    docker ps <container_name/ID>
  • O container do Docker sempre começará como usuário não root (nds). Como uma medida de segurança adicional, habilite o remapeamento do namespace do usuário no daemon para evitar ataques de escalada de privilégios dentro do container. Para obter mais informações sobre o remapeamento de namespaces do usuário, consulte Isolar containers com um namespace de usuário.

Instalação do OpenText Identity Console como um container do Docker

NOTA:O OpenText Identity Console pode ser configurado com ou sem OSP. Se você optar por configurá-lo com o OSP, primeiro será necessário implantar o container do OSP, seguido pelo container do OpenText Identity Console. Certifique-se de modificar o arquivo edirapi.conf para incluir os valores desejados para implantação.

Para instalar o OpenText Identity Console como um container do Docker:

Os parâmetros de configuração, os valores amostrais e os exemplos mencionados neste procedimento são apenas para fins de referência. Não os use diretamente em seu ambiente de produção.

  1. Efetue login no portal Download e licença de software e navegue até a página Downloads de software.

  2. Selecione o seguinte:

    • Produto: OpenText eDirectory

    • Nome do produto: OpenText eDirectory per User Sub SW E-LTU

    • Versão: 9.2, 9.3

  3. Faça download do IdentityConsole_<versão>_Container.tar.zip.

  4. A imagem precisa ser carregada no registro local do Docker. Extraia e carregue o arquivo IdentityConsole_<versão>_Containers.tar.gz usando os comandos abaixo:

    tar -xvf IdentityConsole_version_Containers.tar.gz              
    docker load --input identityconsole.tar.gz
  5. Crie o container do Docker do OpenText Identity Console usando o seguinte comando:

    docker create --name identityconsole-container-name --env ACCEPT_EULA=Y --network=network-type --volume volume-name:/config/ identityconsole:version

    Por exemplo,

    docker create --name identityconsole-container-1 --env ACCEPT_EULA=Y --network=host --volume IDConsole-volume:/config/ identityconsole:version

    NOTA:

    • Você pode aceitar o EULA definindo a variável de ambiente ACCEPT_EULA como 'Y'. Você também pode aceitar o EULA do prompt da tela enquanto inicia o container usando a opção -it no comando de criação do Docker para o modo interativo.

    • O parâmetro --volume no comando acima criará um volume para armazenamento de dados de configuração e de registro. Neste caso, criamos um volume de amostra chamado IDConsole-volume.

  6. Copie o arquivo de certificado do servidor do sistema de arquivos local para o container como /etc/opt/novell/eDirAPI/cert/keys.pfx usando o comando a seguir. Para obter mais informações sobre a criação do certificado do servidor, consulte Pré-requisitos:

    docker cp <absolute path of server certificate file> <identityconsole-container-name>:/etc/opt/novell/eDirAPI/cert/keys.pfx

    Por exemplo,

    docker cp /home/user/keys.pfx identityconsole-container-1:/etc/opt/novell/eDirAPI/cert/keys.pfx

    Quando você se conecta a várias árvores do OpenText eDirectory, precisa obter pelo menos um certificado de servidor keys.pfx para todas as árvores conectadas.

  7. Copie o arquivo de certificado CA (.pem) do sistema de arquivos local para o container como /etc/opt/novell/eDirAPI/cert/sscert.pem usando o comando a seguir. Para obter mais informações sobre a obtenção do certificado CA, consulte Pré-requisitos:

    docker cp absolute path of CA certificate file identityconsole-container-name:/etc/opt/novell/eDirAPI/cert/SSCert.pem

    Por exemplo,

    docker cp /home/user/SSCert.pem identityconsole-container-1:/etc/opt/novell/eDirAPI/cert/SSCert.pem

    Se o usuário precisar se conectar a várias árvores do OpenText eDirectory, consulte a seção: Multiárvore com o OpenText Identity Console como Docker.

  8. Dependendo de você desejar configurar o OpenText Identity Console com ou sem OSP, modifique o arquivo de configuração edirapi.conf conforme necessário. Em seguida, use o seguinte comando para copiá-lo do seu sistema de arquivos local para o container em /etc/opt/novell/eDirAPI/conf/edirapi.conf:

    docker cp absolute path of configuration file identityconsole-container-name:/etc/opt/novell/eDirAPI/conf/edirapi.conf

    Por exemplo,

    docker cp /home/user/edirapi.conf identityconsole-container-1:/etc/opt/novell/eDirAPI/conf/edirapi.conf

    Um arquivo de configuração de exemplo é mostrado abaixo (OpenText Identity Console 1.9 e posterior):

    listen = ":9000" pfxpassword = "novell" bcert = "/etc/opt/novell/eDirAPI/cert/" ospmode=false auto-fetch=false 

    Um exemplo de arquivo de configuração é mostrado abaixo (Identity Console 1.8 e anterior):

    listen = ":9000" pfxpassword = "novell" bcert = "/etc/opt/novell/eDirAPI/cert/" ospmode=false edir-hosts = "<ip_address>:636"

    NOTA:Para acessar o OpenText eDirectory por meio do OpenText Identity Console, é necessário adicionar edir-hosts="x.x.x.x:ldaps_port no arquivo edirapi.conf.

    Exemplo: edir-hosts="10.10.10.10:636"

    Quando você define auto-fetch=true, inicialmente é necessário copiar o certificado da CA para o contêiner, conforme descrito na Etapa 7. Depois disso, o certificado da CA é obtido automaticamente nas sessões de login subsequentes.

    Um exemplo de arquivo de configuração ao configurar o OpenText Identity Console com OSP é mostrado abaixo:

    listen = ":9000" ldapserver = "10.71.39.15:636" ldapuser = "cn=admin,o=novell" ldappassword = "novell" pfxpassword = "novell" osp-token-endpoint = "https://<osp_ipaddress>:8543/osp/a/idm/auth/oauth2/getattributes" osp-authorize-url = "https://<osp_ipaddress>:8543/osp/a/idm/auth/oauth2/grant" osp-logout-url = "https://<osp_ipaddress>:8543/osp/a/idm/auth/app/logout" osp-redirect-url = "https://<identity_console_ipaddress>:9000/eDirAPI/v1/t/authcoderedirect" osp-client-id = "identityconsole" ospclientpass = "novell" ospcert = "/etc/opt/novell/eDirAPI/cert/SSCert.pem" bcert = "/etc/opt/novell/eDirAPI/cert/" ospmode=true check-origin =true origin = "https://<identity_console_ipaddress>:9000"
  9. Inicie o container do Docker usando o seguinte comando:

    docker start identityconsole-container-name

    Por exemplo,

    docker start identityconsole-container-1

NOTA:É possível encontrar os seguintes arquivos de registro no diretório /var/lib/docker/volumes/<nome_do_volume>/_data/eDirAPI/var/log:

  • edirapi.log — É usado para registrar diferentes eventos em problemas de depuração e edirapi.

  • edirapi_audit.log — É usado para registrar eventos de auditoria do edirapi. Os registros seguem o formato de auditoria CEF.

  • container-startup.log – É usado para capturar registros de instalação do container do Docker do OpenText Identity Console.

Multiárvore com o OpenText Identity Console como Docker

Para conectar o OpenText Identity Console 1.9 a várias árvores do OpenText eDirectory quando a busca automática estiver desabilitada, você deve copiar os certificados de CA de todas as árvores do OpenText eDirectory para o diretório /etc/opt/novell/eDirAPI/cert/.

O OpenText Identity Console 1.8 permite que o usuário se conecte a várias árvores obtendo o certificado de CA individual da árvore.

Por exemplo, se você se conectar a três árvores do OpenText eDirectory, precisará copiar todos os três certificados de CA no container do Docker:

docker cp /home/user/SSCert1.pem identityconsole-container-1:/etc/opt/novell/eDirAPI/cert/SSCert1.pem
docker cp /home/user/SSCert2.pem identityconsole-container-1:/etc/opt/novell/eDirAPI/cert/SSCert2.pem
docker cp /home/user/SSCert3.pem identityconsole-container-1:/etc/opt/novell/eDirAPI/cert/SSCert3.pem

Execute os seguintes comandos para reiniciar o OpenText Identity Console:

docker restart <identityconsole-container-name>

Exemplo:

docker restart identityconsole-container-1

Implantação do container do OSP

Execute as seguintes etapas para implantar o container do OSP:

  1. Efetue login no portal Download e licença de software e navegue até a página Downloads de software.

  2. Selecione o seguinte:

    • Produto: OpenText eDirectory

    • Nome do produto: OpenText eDirectory per User Sub SW E-LTU

    • Versão: 9.2

    • OpenText Identity Console autônomo

  3. Baixe e extraia o arquivo IdentityConsole_<versão>_Containers_tar.zip.

  4. Para instalar o OpenText Identity Console no container do OSP, é necessário um keystore (tomcat.ks).

    Execute as seguintes etapas para gerar o keystore:

    1. Crie uma pasta certs no diretório /opt/.

    2. Execute o comando a seguir para criar um keystore (tomcat.ks):

      keytool -genkey -alias osp -keyalg RSA -storetype pkcs12 -keystore /opt/certs/tomcat.ks -validity 3650 -keysize 2048 -dname "CN=blr-osp48-demo.labs.blr.novell.com" -keypass novell -storepass novell

      NOTA:Verifique se o endereço IP da máquina é nomeado como nome CN ou como nome completo do host. Por exemplo, CN=xx.xx.xx.xx

    3. Execute o comando a seguir para criar uma solicitação de autenticação de certificado. Por exemplo, cert.csr.

      keytool -certreq -v -alias osp -file /opt/certs/cert.csr -keypass novell -keystore /opt/certs/tomcat.ks -storepass novell
    4. Passe o cert.csr criado para o Identity Console e obtenha o cert.der conforme explicado:

      1. Inicie o OpenText Identity Console como Administrador.

      2. Clique em Gerenciamento de Certificados > Emitir o Certificado e selecione o arquivo.

      3. Vá até Especificações de Uso da Chave > Tipo de Chave e selecione o botão de opção Personalizada.

      4. Clique em Uso da chave e marque as seguintes caixas de seleção:

        • Criptografia de Dados

        • Criptografia de Chave

        • Assinatura Digital

      5. Clique em Parâmetros do Certificado > Nomes Alternativos do Assunto > Endereço IP do Servidor OSP ou Nome DNS do Servidor OSP > Próximo > OK.

        A mensagem aparece como O certificado foi gerado com êxito.

      6. Clique em OK.

      7. Faça download do certificado cert.der emitido e copie-o para /opt/certs/.

    5. Copie o SSCert.der do OpenText eDirectory para /opt/certs

    6. Execute os comandos a seguir para importar o certificado CA (SSCert.der) e o certificado do servidor (cert.der) para o keystore tomcat.ks.

      keytool -import -trustcacerts -alias root -keystore /opt/certs/tomcat.ks -file /opt/certs/SSCert.der -storepass novell -noprompt
      keytool -import -alias osp -keystore /opt/certs/tomcat.ks -file /opt/certs/cert.der -storepass novell -noprompt
  5. Crie uma nova pasta como /data.

  6. Copie o tomcat.ks de /opt/certs e cole-o na pasta data.

  7. No build extraído do container do OpenText Identity Console, copie os arquivos osp-edirapi-silent.properties para a pasta data.

  8. Modifique o arquivo de propriedades osp edirapi silent de acordo com seu requisito. Um arquivo de propriedades silenciosas de amostra é mostrado abaixo:

    # Silent file for osp with edirapi
    ## Static contents Do not edit - starts 
    INSTALL_OSP=true
    DOCKER_CONTAINER=y
    EDIRAPI_PROMPT_NEEDED=y
    UA_PROMPT_NEEDED=n
    SSPR_PROMPT_NEEDED=n
    RPT_PROMPT_NEEDED=n
    CUSTOM_OSP_CERTIFICATE=y
    ## Static contents Do not edit - ends
    
    # OSP Details
    SSO_SERVER_HOST=osp.example.com (osp confiugred serevr IP address)
    SSO_SERVER_SSL_PORT=8543
    OSP_COMM_TOMCAT_KEYSTORE_FILE=/config/tomcat.ks
    OSP_COMM_TOMCAT_KEYSTORE_PWD=novell
    SSO_SERVICE_PWD=novell
    OSP_KEYSTORE_PWD=novell
    IDM_KEYSTORE_PWD=novell
    OSP_CUSTOM_NAME="Identity Console"
    USER_CONTAINER="o=novell"
    ADMIN_CONTAINER="o=novell"
    MASTER_KEYSTORE_PWD=novell
    
    # IDConsole Details 
    IDCONSOLE_HOST=192.168.1.1 (IdentityConsole confiugred serevr IP address)
    IDCONSOLE_PORT=9000
    EDIRAPI_TREENAME=ed913 (Tree name should be in lowercase)
    
    #If ENABLE_CUSTOM_CONTAINER_CREATION is set to y
    #ie., when you have user and admin container different from o=data
    #    and they need to be created in eDir
    #then CUSTOM_CONTAINER_LDIF_PATH should be entered as well
    ENABLE_CUSTOM_CONTAINER_CREATION=n
    #ENABLE_CUSTOM_CONTAINER_CREATION=y
    #CUSTOM_CONTAINER_LDIF_PATH=/config/custom-osp.ldif
    
    # eDir Details
    ID_VAULT_HOST=192.168.1.1 (eDir/ID_Vault confiugred serevr IP address)
    ID_VAULT_LDAPS_PORT=636
    ID_VAULT_ADMIN_LDAP="cn=admin,o=novell"
    ID_VAULT_PASSWORD=novell

    NOTA:Para evitar restrições de espaço ao usar o arquivo de propriedades silenciosas (texto DOS), você deve converter o arquivo texto DOS para o formato UNIX usando a ferramenta dos2unix. Execute o comando abaixo para converter arquivos texto de finais de linha DOS para finais de linha Unix:

    nome de arquivo dos2unix

    Por exemplo:

    dos2unix samplefile

  9. Execute o seguinte comando para carregar a imagem do OSP:

    docker load --input osp.tar.gz
  10. Implante o container usando o seguinte comando:

    docker run -d --name OSP_Container --network=host -e SILENT_INSTALL_FILE=/config/osp-edirapi-silent.properties -v /data:/config osp:<version>

    Por exemplo:

    docker run -d --name OSP_Container --network=host -e SILENT_INSTALL_FILE=/config/osp-edirapi-silent.properties -v /data:/config osp:6.6.6 

    NOTA:Após implantar o container OSP, instale e configure o OpenText Identity Console com detalhes do servidor OSP.

Parada e reinício do OpenText Identity Console como container do Docker

Para parar, execute o seguinte comando:

docker stop identityconsole-container-name

Para reiniciar, execute o seguinte comando:

docker restart identityconsole-container-name

Para iniciar, execute o seguinte comando:

docker start identityconsole-container-name

Gerenciamento da Persistência de Dados

Volumes de persistência de dados também são criados juntamente com os containers do OpenText Identity Console. Para usar os parâmetros de configuração de um container antigo usando os volumes, execute as seguintes etapas:

  1. Pare o seu container do Docker atual usando o seguinte comando:

    docker stop identityconsole-container-name

    Exemplo:

    docker stop identityconsole-container-1
  2. Crie o segundo container usando os dados de aplicativo do container antigo armazenado no volume do Docker (IDConsole-volume-1).

    docker create --name identityconsole-container-name --network=host --volume IDConsole-volume-1:/config/ identityconsole:< version >

    Exemplo:

    docker create --name identityconsole-container-2 --network=host --volume IDConsole-volume-1:/config/ identityconsole:<version>
  3. Inicie o segundo container usando o seguinte comando:

    docker start identityconsole-container-name

    Exemplo:

    docker start identityconsole-container-2
  4. (Opcional) O primeiro container pode ser removido usando o seguinte comando:

    docker rm identityconsole-container-name

    Exemplo:

    docker rm identityconsole-container-1

Substituindo o certificado do servidor no container do Docker

Execute as seguintes etapas para substituir o certificado do servidor no container do Docker:

  1. Execute o seguinte comando para copiar o novo certificado do servidor em qualquer local do seu container.

    Exemplo:

    docker cp /path/to/new-keys.pfx <container_id/name>:/tmp/new-keys.pfx
  2. Efetue login no container usando o seguinte comando:

    docker exec -it container_name bash
  3. Execute o NLPCERT para armazenar as chaves como um pseudousuário:

    LD_LIBRARY_PATH=/opt/novell/lib64/:/opt/novell/eDirectory/lib64/:/opt/netiq/common/openssl/lib64/ /opt/novell/eDirAPI/sbin/nlpcert -i /tmp/new-keys.pfx -o /etc/opt/novell/eDirAPI/conf/ssl/private/cert.pem 
  4. Saia do console do container usando o comando:

    exit
  5. Reinicie o container digitando:

    docker restart container name

2.1.4 Instalando o OpenText Identity Console nos Serviços de Kubernetes do Azure

O AKS (Serviços de Kubernetes do Azure) é um serviço gerenciado de Kubernetes que permite instalar e gerenciar clusters. Esta seção inclui os seguintes procedimentos:

Instalando o OpenText Identity Console no AKS Cluster

Esta seção explica os seguintes procedimentos para instalar o OpenText Identity Console no cluster do AKS:

Criando um ACR (Registro de Contêiner do Azure)

O ACR (Registro de Contêiner do Azure) é um registro privado baseado no Azure, para imagens de containers do Docker.

Para obter mais detalhes, consulte a seção Create an Azure container registry using the Azure portal (Criar um Registro de Contêiner do Azure usando o portal do Azure) em Create container registry - Portal (Criar registro de container — Portal) ou execute as seguintes etapas para criar um ACR (Registro de Container do Azure):

  1. Efetue login no portal do Azure.

  2. Acesse Create a resource > Containers > Container Registry (Criar um recurso > Contêineres > Registro de Contêiner).

  3. Na guia Basics (Noções Básicas), especifique valores para Resource group (Grupo de recursos) e Registry name (Nome do registro). O nome do registro precisa ser único no Azure e conter no mínimo 5 e no máximo 50 caracteres alfanuméricos.

    Aceite os valores padrão para as configurações restantes.

  4. Clique em Examinar + criar.

  5. Clique em Criar.

  6. Efetue login na CLI do Azure e execute o comando a seguir para efetuar login no Registro de Contêiner do Azure.

    az acr login --name registryname

    Exemplo:

    az acr login --name < idconsole >
  7. Recupere o servidor de login do Registro de Contêiner do Azure usando o comando:

    az acr show --name registryname --query loginServer --output table

    Exemplo:

    az acr show --name < idconsole > --query loginServer --output table
  8. Marque a imagem local do OpenText Identity Console com o nome do servidor de login do ACR (registryname.azureacr.io) usando o seguinte comando:

    docker tag idconsole-image <login server>/idconsole-image

    Exemplo:

    docker tag identityconsole:<version> registryname.azurecr.io/identityconsole:<version>
  9. Envie por push a imagem marcada para o registro.

    docker push <login server>/idconsole: <version>

    Exemplo:

    docker push registryname.azurecr.io/identityconsole:<version>
  10. Recupere a lista de imagens no registro usando o comando:

    az acr show --name registryname --query loginServer --output table

Definindo um cluster do Kubernetes

Crie um recurso de serviço Kubernetes usando o portal do Azure ou a CLI.

Para obter mais detalhes para criar um recurso de serviço Kubernetes no Azure com um nó, confira Create an AKS Cluster (Criar um cluster do AKS) no Azure Quickstart (Início Rápido do Azure).

NOTA:

  • Verifique se você selecionou a CNI do Azure como a rede.

  • Selecione a rede virtual existente (onde o servidor OpenText eDirectory está instalado na sub-rede).

  • Selecione o registro de container existente no qual a imagem do OpenText Identity Console está disponível.

Criando um endereço IP público de SKU padrão

Um recurso de endereço IP público sob o grupo de recursos do cluster do Kubernetes atua como IP do balanceador de carga para o aplicativo.

Para obter etapas detalhadas, consulte Create a public IP address using the Azure portal (Criar um endereço IP público usando o portal do Azure) em Create public IP address – Portal (Criar endereço IP público — Portal).

Configurando o Cloud Shell e conectando ao cluster do Kubernetes

Use o Cloud Shell, disponível no portal do Azure, para todas as operações.

Para configurar o Cloud Shell no portal do Azure, consulte a seção Start Cloud Shell (Iniciar o Cloud Shell) em Bash – Quickstart (Bash — Início Rápido) ou execute as seguintes etapas para configurar o Cloud Shell e conecte-se ao cluster do Kubernetes:

  1. No portal do Azure, clique no botão para abrir o Cloud Shell.

    NOTA:Para gerenciar um cluster do Kubernetes, use o cliente de linha de comando do Kubernetes, kubectl. Se você usa o Azure Cloud Shell, o kubectl já está instalado.

  2. Configure o kubectl para se conectar ao seu cluster do Kubernetes usando o seguinte comando:

    az aks get-credentials --resource-group "resource group name" --name "Kubernetes cluster name"

    Exemplo:

    az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
  3. Verifique a lista dos nós de cluster usando o comando:

    kubectl get nodes

Implantando o aplicativo

Para instalar o OpenText Identity Console, você pode usar os arquivos de exemplo idc-services.yaml, idc-statefulset.yaml, idc-storageclass.yaml e idc-pvc.yaml.

Você também pode criar arquivos yaml próprios conforme suas necessidades.

  1. Crie um recurso de classe de armazenamento usando o comando abaixo:

    kubectl apply -f <location of the YAML file>

    Exemplo:

    kubectl apply -f idc-storageclass.yaml

    (Opcional) Para obter mais informações sobre como criar e usar dinamicamente o volume de persistência com o compartilhamento de arquivos do Azure, consulte Dynamically create and use a persistent volume with Azure Files in Azure Kubernetes Service (AKS) (Criar e usar dinamicamente um volume persistente com Arquivos do Azure no AKS [Serviço de Kubernetes do Azure]).

    Um arquivo de recurso de classe de armazenamento de exemplo foi mostrado abaixo:

    kind: StorageClass
    apiVersion: storage.k8s.io/v1
    metadata:
      name: azurefilesc
    provisioner: kubernetes.io/azure-file
    mountOptions:
      - dir_mode=0777
      - file_mode=0777
      - uid=0
      - gid=0
      - mfsymlinks
      - cache=strict
      - actimeo=30
    parameters:
      skuName: Standard_LRS
      shareName: fileshare
    ~

    Um recurso de classe de armazenamento permite o aprovisionamento dinâmico de armazenamento. Ele é usado para definir como um compartilhamento de arquivos do Azure é criado.

  2. Veja os detalhes da classe de armazenamento usando o comando abaixo:

    kubectl get sc
  3. Crie um recurso de pvc usando o arquivo idc-pvc.yaml:

    kubectl apply -f <location of the YAML file>

    Exemplo:

    kubectl apply -f idc.pvc.yaml

    Um arquivo de recurso de pvc de exemplo foi mostrado abaixo:

    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
      name: pvcforsc
    spec:
      accessModes:
        - ReadWriteMany
      storageClassName: azurefilesc
      resources:
        requests:
          storage: 5Gi

    Um recurso de reivindicação de volume persistente cria o compartilhamento de arquivos. Uma reivindicação de volume persistente (persistent volume claim — PVC) usa o objeto da classe de armazenamento para provisionar dinamicamente um compartilhamento de arquivos do Azure.

  4. Faça upload do certificado edirapi.conf, do certificado CA e do certificado do servidor para o Cloud Shell.

    Clique no ícone de botão Upload/Download files (Carregar/Baixar arquivos) no Cloud Shell e faça upload dos arquivos edirapi.conf, SSCert.pem e keys.pfx.

    NOTA:edirapi.conf tem um parâmetro “origem”. Aqui precisamos fornecer endereço IP com o qual acessaremos o aplicativo OpenText Identity Console. (use o endereço IP que é criado na seção Criando um endereço IP público de SKU padrão.)

    A instalação do OpenText Identity Console requer um certificado do servidor (keys.pfx).

    Ao criar o certificado do servidor, certifique-se de fornecer nome DNS válido em Nome(s) Alternativo(s) do Assunto.

    Etapas para criar um nome DNS válido:

    Um pod típico implantado usando StatefulSet tem um nome DNS como o abaixo — {nomedestatefulset}-{ordinal}.{nomedoserviço}.{namespace}.svc.cluster.local

    • Se o nome de StatefulSet no arquivo idconsole-statefulset.yaml for idconsole-app, então statefulsetname = idconsole-app

    • Se o pod for o primeiro, então ordinal = 0

    • Se você definir serviceName no arquivo idconsole -statefulset.yaml como idconsole, então serviceName = idconsole

    • Se o namespace for o padrão, então namespace=default

    Saída: idconsole-app-0.idcosole.default.svc.cluster.local

  5. Crie um recurso de configmap no cluster do Kubernetes que armazena os arquivos de configuração junto com os certificados.

    Antes de executar o comando, certifique-se de que os arquivos (edirapi.conf, SSCert.pem e keys.pfx) estejam presentes no diretório.

    kubectl create configmap <confgimapName> --from-file= "path where the files are present"

    Exemplo:

    kubectl create configmap config-data --from-file=/data
  6. Veja os detalhes do objeto configmap usando o comando de descrição kubectl:

    kubectl describe configmap <configmapName>

    Exemplo:

    kubectl describe configmap confg-data
  7. Crie um recurso StatefulSet para implantar um container.

    Execute o comando abaixo para implantar o container:

    kubectl apply -f <location of the YAML file>

    Exemplo:

    kubectl apply -f idc-statefulset.yaml

    Um arquivo de recurso StatefulSet de exemplo foi mostrado abaixo:

    apiVersion: apps/v1
    kind: StatefulSet
    metadata:
      name: idconsole-app
    spec:
      serviceName: idconsole
      selector:
        matchLabels:
          app: idconsole
      replicas: 1
      template:
        metadata:
          labels:
            app: idconsole
        spec:
          containers:
          - name: idconsole-container
            image: registryname.azurecr.io/identityconsole:<version>
            env:
            - name: ACCEPT_EULA
              value: "Y"
            ports:
            - containerPort: 9000
            volumeMounts:
              - name: configfiles
                mountPath: /config/data
              - name: datapersistenceandlog
                mountPath: /config
                subPath: log
          volumes:
            - name: configfiles
              configMap:
                name: config-data
            - name: datapersistenceandlog
              persistentVolumeClaim:
                claimName: pvcforsc
  8. Execute o seguinte comando para verificar o status do pod implantado:

    kubectl get pods -o wide
  9. Crie um recurso de serviço do tipo loadBalancer.

    O tipo do serviço especificado no arquivo yaml é loadBalancer.

    Crie um recurso de serviço usando o comando abaixo:

    kubectl apply -f <location of the YAML file>

    Exemplo:

    kubectl apply -f ids-service.yaml

    Um arquivo de recurso de serviço de exemplo foi mostrado abaixo:

    apiVersion: v1
    kind: Service
    metadata:
      name: idconsole-service
      labels:
        run: idconsole-service
    spec:
      type: LoadBalancer
      loadBalancerIP: xx.xx.xx.xx
      selector:
        app: idconsole
      ports:
       - port: 9000
         targetPort: 9000
         protocol: TCP

    Verifique o endereço EXTERNAL-IP (ou o loadBalancerIP) usando o comando abaixo:

    kubectl get svc -o wide
  10. Inicie o URL usando EXTERNAL-IP (ou o endereço loadBalancerIP).

    Exemplo:

    https://<EXTERNAL-IP>:9000/identityconsole