2.2 Instalando o OpenText Identity Console 1.8 e anterior

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

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

NOTA:É recomendável instalar 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

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

  4. Navegue até o diretório onde você extraiu o build do 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 instalará 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. (Condicional) Escolha uma das seguintes opções dependendo do seu requisito:

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

    • Se quiser integrar o OSP ao 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.

  11. 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

    Se desejar que o OpenText Identity Console se conecte a várias árvores do eDirectory do OpenText, insira seus endereços IP ou nomes de domínio separados por vírgulas.

    NOTA:Se desejar que o OpenText Identity Console se conecte a várias árvores do OpenText eDirectory, insira seus endereços IP ou nomes de domínio separados por vírgulas.

  12. (Condicional) Siga um destes procedimentos para importar o certificado de CA:

    • Se desejar importar o certificado de CA do servidor, insira "y" e pressione Enter. Em seguida, digite o nome de domínio/endereço IP do servidor do eDirectory com o número da porta LDAPS.

      Por exemplo: 10.10.10.10:636

    • Se você não quiser importar o certificado de CA do servidor, insira "n" e pressione Enter. Em seguida, forneça manualmente o local do caminho do diretório do certificado de CA.

    • Se você inserir "q", a instalação será encerrada.

  13. (Condicional) Siga um destes procedimentos 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. Digite o nome de domínio or endereço IP do servidor do eDirectory com o número da porta LDAPS.

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

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

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

      5. Digite o nome do certificado do servidor.

        Exemplo: servercert

      6. Digite a senha do certificado do servidor.

        Exemplo: password@123

      7. 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.

  • Quando estiver gerando o certificado de CA e o Certificado do Servidor, execute o instalador do Console de identidade do diretório IdentityConsole_<versão>_Linux no local da extração.

  • Se a instalação falhar, não é necessário desinstalar o OpenText Identity Console existente, em vez disso, o usuário pode executar o seguinte comando:

    /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 onde você extraiu o build do OpenText Identity Console > IdentityConsole_<versão>_Linux.

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

    ./get_cacert
  4. Digite o endereço IP do eDirectory com o número da porta LDAPS. Por exemplo: 10.10.10.10:636.

Certificados de raiz confiáveis copiados com êxito do servidor para /tmp/SSCert.pem.

Gerar certificado do servidor

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

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

  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> <path_of_CA _certificate with filename> <path of server certificate with filename>

    Exemplo:

    ./get_servercert 10.10.10.10:636 cn=admin,ou=org_unit,o=org password keys password /var/opt/novell/eDirectory/data/SSCert.pem /home/user/keys.pfx
    

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. Para criar o arquivo silent_properties, você pode usar o utilitário create_silent_properties que vem com o OpenText Identity Console versão 1.7.2 e posterior. Depois de gerar 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 gerar 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. Execute o seguinte comando para usar o utilitário create_silent_properties:

    ./create_silent_properties
  3. Digite o endereço IP ou o nome de host do servidor do Identity Console. Por exemplo, 10.0.0.1.

  4. Insira o número da porta na qual você deseja que o Identity Console escute. Por exemplo, 9000.

  5. (Condicional) Escolha uma das seguintes opções dependendo do seu requisito:

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

    • Se quiser integrar o OSP ao 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.

  6. Insira os nomes de host ou endereço IP do servidor do eDirectory para o qual você deseja que o Identity Console estabeleça uma conexão. Por exemplo, 10.10.10.10:636.

  7. Insira os nomes de host ou endereço IP do servidor do eDirectory para o qual você deseja que o Identity Console estabeleça uma conexão. Por exemplo, 10.10.10.10:636.

  8. Insira o caminho do diretório do certificado do servidor, incluindo o nome do arquivo. Por exemplo, /home/cert/keys.pfx.

  9. Digite a senha do certificado do servidor.

  10. Digite novamente a senha do certificado do servidor.

    O arquivo silent_properties é gerado com êxito no local IdentityConsole_<versão>_Linux.

Para executar uma instalação silenciosa:

  1. Depois de gerar o arquivo silent_properties, execute o seguinte comando para executar o instalador no modo silencioso:

    ./identityconsole_install -s silent_properties
  2. Digite o nome de domínio/endereço IP do servidor do eDirectory com o número da porta LDAPS. Por exemplo: 10.10.10.10:636

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 com várias árvores do OpenText eDirectory, você deve fornecer o IP do OpenText eDirectory e a porta LDAPS separados por vírgulas no arquivo edirapi.conf localizado em /etc/opt/novell/eDirAPI/conf/. Além disso, você deve copiar os certificados de CA de todas as árvores do OpenText eDirectory para o diretório /etc/opt/novell/eDirAPI/cert/.

Por exemplo, para conectar o OpenText Identity Console a três árvores do OpenText eDirectory, forneça o endereço IP no seguinte formato:

edir-hosts="10.0.0.1:636,10.0.0.2:636,10.0.0.3:636"

Em seguida, copie os certificados de CA da seguinte forma:

cp /home/user/SSCert1.pem /etc/opt/novell/eDirAPI/cert/SSCert1.pem
cp /home/user/SSCert2.pem /etc/opt/novell/eDirAPI/cert/SSCert2.pem
cp /home/user/SSCert3.pem /etc/opt/novell/eDirAPI/cert/SSCert3.pem

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

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

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

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

  1. Execute NLPCERT para armazenar as chaves:

    su - nds -c "LD_LIBRARY_PATH=/opt/novell/lib64/:/opt/novell/eDirectory/lib64/:/opt/netiq/common/openssl/lib64/ /opt/novell/eDirAPI/sbin/nlpcert -i /Expiredcert/noexpire/new-keys.pfx -o /etc/opt/novell/eDirAPI/conf/ssl/private/cert.pem"
  2. Reinicie o OpenText Identity Console:

    systemctl restart netiq-identityconsole.service

Parada e reinício 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 iniciar, execute um dos seguintes comandos:

    /usr/bin/identityconsole start

    ou

    systemctl start netiq-identityconsole.service

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

O OpenText Identity Console (versão 1.5 e posterior) 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: eDirectory per User Sub SW E-LTU

    • Versão: 9.2

  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, instale NICI_w32 ou NICI_wx64, dependendo da configuração do sistema.

  5. (Condicional) Se você já tiver os arquivos keys.pfx e SSCert.pem que deseja usar, copie-os manualmente para a pasta cert localizada em C:\IdentityConsole_<versão>_workstation_win_x86_64\eDirAPI\cert.

    Em seguida, vá para a etapa 9.

  6. (Condicional) Se você quiser gerar o certificado de CA, navegue até a pasta eDirAPI, execute o binário get_cacert.exe no power shell, localizado em C:\IdentityConsole_<versão>_workstation_win_x86_64\eDirAPI e forneça os seguintes detalhes:

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

    • Caminho do certificado de CA de raiz confiável com o nome do certificado.

    Por exemplo,

    get_cacert.exe 10.10.10.125:636 C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert\SSCert.pem

    Um arquivo SSCert.pem é gerado.

  7. (Condicional) Se você quiser gerar o Certificado do Servidor, execute o binário get_servercert.exe por meio do power shell, 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.

    • Caminho do certificado de CA de raiz confiável com o nome do certificado.

    • O caminho do certificado do servidor-raiz confiável com o nome do certificado (keys.pfx é codificado).

    Por exemplo,

    get_servercert.exe 10.10.10.125:636 cn=admin,o=novell novell keys novell C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert\SSCert.pem C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert\keys.pfx

    Um arquivo keys.pfx é gerado.

  8. Copie os arquivos keys.pfx e SSCert.pem (gerados nas etapas 6 e 7) manualmente para a pasta cert.

  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 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.

  • A estação de trabalho do OpenText Identity Console escuta apenas na porta 9000. Não modifique o arquivo edirapi_win.conf.

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
  4. Forneça o endereço IP do eDirectory e o número da porta LDAPS.

    Exemplo: get_cacert.exe 10.10.10.125:636

    Um arquivo SSCert.pem é gerado. Copie SSCert.pem manualmente na 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.

    • Caminho do certificado de raiz confiável com o nome do certificado.

      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 SSCert.pem

      Um arquivo keys.pfx é gerado. Copie keys.pfx manualmente na 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 obtendo o certificado de CA individual da árvore.

  1. Feche a estação de trabalho do OpenText Identity Console e o terminal eDirAPI.

  2. Copie os certificados de CA SSCert.pem para o local: IdentityConsole_<versão>_workstation_win_x86_64\eDirAPI\cert.

    Por exemplo, se você quiser se conectar a três árvores do eDirectory, copie os certificados de CA como SSCert1.pem, SSCert2.pem e SSCert3.pem, respectivamente.

  3. Navegue até a pasta na qual o build foi extraído e clique duas vezes no arquivo run.bat (arquivo de lote do Windows).

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.2.3 Instalando o OpenText Identity Console como container do Docker

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