1.1 Requisitos do sistema e pré-requisitos para instalação do Docker

1.1.1 Requisitos do sistema

Como o OpenText Identity Console pode ser executado como um container do Docker, para obter mais informações sobre requisitos do sistema e plataformas com suporte para instalação do OpenText Identity Console, consulte a Documentação do Docker.

1.1.2 Pré-requisitos

Instale o Docker 20.10.9-ce ou posterior. Para obter mais informações sobre como instalar o Docker com base em sua plataforma, consulte Docker Installation (Instalação do Docker).
Você precisa obter um certificado do servidor pkcs12 com a chave privada para criptografar/descriptografar a troca de dados entre o servidor do OpenText Identity Console e o servidor back-end. Esse certificado do servidor é usado para proteger a conexão http. Você pode usar certificados do servidor gerados por qualquer CA externa. Para mais informações, veja Criando um Objeto Certificação do Servidor. O certificado do servidor deve conter o Nome Alternativo do Assunto com endereço IP e DNS do servidor do OpenText Identity Console. Uma vez criado o objeto certificado do servidor, você precisa exportá-lo em formato .pfx.
Você precisa obter um certificado de CA em formato .pem para validar a autenticação de CA dos certificados de servidor obtidos na etapa anterior. Este certificado de CA raiz também garante o estabelecimento de uma comunicação LDAP segura entre o cliente e o servidor do OpenText Identity Console. Por exemplo, você pode obter o certificado de CA do eDirectory (SSCert.pem) de /var/opt/novell/OpenText eDirectory/data/SSCert.pem.
(Opcional) Ao utilizar o One SSO Provider (OSP), você pode habilitar a autenticação de login único para os seus usuários no portal do OpenText Identity Console. Você precisa instalar o OSP antes de instalar o OpenText Identity Console. Para configurar o OSP para o OpenText Identity Console, siga os prompts na tela e forneça os valores necessários para os parâmetros de configuração. Para registrar o OpenText Identity Console em um servidor OSP existente, você deve adicionar manualmente o seguinte ao arquivo ism-configuration.properties na pasta /opt/netiq/idm/apps/tomcat/conf/:
```
com.netiq.edirapi.clientID = identityconsole
com.netiq.edirapi.redirect.url = https://<Identity Console Server IP>:<Identity Console Listener Port>/eDirAPI/v1/<eDirectory Tree Name>/authcoderedirect
com.netiq.edirapi.logout.url = https://<Identity Console Server IP>:<Identity Console Listener Port>/eDirAPI/v1/<eDirectory Tree Name>/logoutredirect
com.netiq.edirapi.logout.return-param-name = logoutURL
com.netiq.edirapi.response-types = code,token
com.netiq.edirapi.clientPass._attr_obscurity = NONE
com.netiq.edirapi.clientPass = novell
```
NOTA:
- Com o OSP, você pode se conectar a apenas uma árvore do OpenText eDirectory, pois o OSP não suporta várias árvores do OpenText eDirectory.
- OSP de terceiros não é suportado no OpenText Identity Console.
- Em um ambiente integrado NAM, o OpenText Identity Console com OSP não é compatível no momento.
Verifique se você tem uma entrada DNS adequada disponível para a sua máquina host em /etc/hosts com um nome completo do host.
Se você quiser usar o OpenText Identity Console no browser Edge, precisará fazer download da versão mais recente do Microsoft Edge para obter a funcionalidade completa.

NOTA:Ao usar o OpenText Identity Console no Mozilla Firefox, a operação pode falhar com a mensagem de erro Origin Mismathc (Incompatibilidade de origem). Para solucionar o problema, execute as seguintes etapas:

Atualize o Firefox para a versão mais recente.
Especifique about:config no campo URL do Firefox e pressione Enter.
Pesquise Origin.
Clique duas vezes em network.http.SendOriginHeader e mude o valor para 1.

1.1.3 Configurando seu ambiente

Pode ser necessário criar um arquivo de configuração contendo determinados parâmetros. Se você quiser configurar o OpenText Identity Console com o OSP, você precisará especificar os parâmetros específicos do OSP no arquivo de configuração. Por exemplo, crie o arquivo edirapi.conf abaixo com parâmetros do OSP:

NOTA:Você deve fornecer o nome da árvore do OpenText eDirectory no campo osp-redirect-url.

listen = ":9000"
ldapserver = "192.168.1.1:636"
ldapuser = "cn=admin,ou=sa,o=system"
ldappassword = "novell"
pfxpassword = "novell"
ospmode = "true"
osp-token-endpoint = "https://10.10.10.10:8543/osp/a/idm/auth/oauth2/getattributes"
osp-authorize-url = "https://10.10.10.10:8543/osp/a/idm/auth/oauth2/grant"
osp-logout-url = "https://10.10.10.10:8543/osp/a/idm/auth/app/logout"
osp-redirect-url = "https://10.10.10.10:9000/eDirAPI/v1/edirtree/authcoderedirect"
osp-client-id = "identityconsole"
ospclientpass = "novell"
ospcert = "/etc/opt/novell/eDirAPI/cert/SSCert.pem"
bcert = "/etc/opt/novell/eDirAPI/cert/"
loglevel = "error"
check-origin = "true"
origin = "https://10.10.10.10:9000,https://192.168.1.1:8543"

Caso você queira configurar o OpenText Identity Console sem o OSP, crie um arquivo de configuração conforme mostrado abaixo, sem os parâmetros do OSP:

[OpenText Identity Console 1.9]

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

NOTA:

Remova o parâmetro edir-hosts do arquivo de configuração e adicione o parâmetro auto-fetch.
Se auto-fetch = false, você deve copiar manualmente o certificado de CA para a pasta cert.

[OpenText Identity Console 1.8 e anterior]

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

NOTA:Quando você quiser configurar o OpenText Identity Console com várias árvores do OpenText eDirectory, poderá ignorar os parâmetros “ldapserver”, “ldapuser” e “ldappassword” e criar o arquivo de configuração.

Tabela 1-1 Descrição dos parâmetros de configuração no arquivo de configuração

Parâmetros de configuração	Descrição
listen	Especifique 9000 como a porta de escuta do servidor do OpenText Identity Console dentro do container.
ldapserver	Especifique o IP e o número da porta do servidor host do OpenText eDirectory.
ldapuser	Especifique o nome de usuário do OpenText eDirectory. Este parâmetro é usado como uma credencial para iniciar chamadas LDAP para OpenText eDirectory usando controle de autorização por proxy no caso de login OSP. O usuário LDAP precisa ter direitos de supervisor na árvore do OpenText eDirectory.
ldappassword	Especifique a senha do usuário LDAP.
pfxpassword	Especifique a senha ou o arquivo de certificado do servidor pkcs12.
ospmode	Especifique true para integrar o OSP ao OpenText Identity Console. Se você definir como false, o OpenText Identity Console usará o login do LDAP.
osp-token-endpoint	Este URL é usado para buscar certos atributos do servidor OSP para verificar a validade do token de autenticação.
osp-authorize-url	Este URL é usado pelo usuário para fornecer credenciais para obter um token de autenticação.
osp-logout-url	Use este URL para terminar a sessão entre o usuário e o servidor OSP.
osp-redirect-url	O servidor OSP redireciona o usuário para este URL após conceder o token de autenticação. NOTA:Especifique o nome da árvore do OpenText eDirectory em minúsculas ao configurar o OpenText Identity Console. Caso o nome da árvore não esteja especificado em minúsculas, o login no servidor OpenText Identity Console pode falhar.
osp-client-id	Especifique o ID do cliente OSP fornecido no momento do registro do OpenText Identity Console no OSP.
ospclientpass	Especifique a senha do cliente OSP fornecida no momento do registro do OpenText Identity Console no OSP.
ospcert	Especifique a localização do certificado CA do servidor OSP.
bcert	Especifique a localização do certificado de CA do OpenText Identity Console.
loglevel	Especifique os níveis de registro que você deseja incluir no arquivo de registro. Esse parâmetro pode ser definido como “fatal”, “error”, “warn” ou “info”.
check-origin	Se estiver definido como true, o servidor do OpenText Identity Console comparará o valor de origem das solicitações. As opções disponíveis são true ou false. O parâmetro origin é obrigatório mesmo se o valor do parâmetro check-origin é definido como false quando a configuração de DNS é usada.
origin	O OpenText Identity Console compara o valor de origem das solicitações com os valores especificados neste campo. NOTA:A partir do OpenText Identity Console 1.4, esse parâmetro é independente do parâmetro check-origin e é obrigatório se a configuração de DNS é usada.
maxclients	Número máximo de clientes simultâneos que podem acessar o IDConsole. Qualquer cliente adicional além desse limite precisa esperar na fila.
auto-fetch	No OpenText Identity Console 1.9 em diante, você pode optar por buscar automaticamente o certificado de CA.
Edir-hosts (1.8 e anterior)	edir-host é um parâmetro que contém o(s) endereço(s) IP do OpenText eDirectory que você deseja conectar por meio do OpenText Identity Console.

NOTA:

O parâmetro de configuração ospmode deve ser usado apenas se você planeja integrar o OSP junto com o OpenText Identity Console.
Se o Identity Applications (Identity Apps) for configurado no modo cluster na configuração do OpenText Identity Manager, você deverá fornecer o nome DNS do servidor do balanceador de carga nos campos osp-token-endpoint, osp-authorize-url e osp-logout-url no arquivo de configuração. Se você fornecer os detalhes do servidor OSP nesses campos, o login do OpenText Identity Console falhará.
Se o OpenText Identity Console estiver configurado com a mesma instância do OSP que o Identity Apps e o OpenText Identity Reporting, o Login Único (serviço de autenticação) entrará em vigor quando você estiver efetuando login no portal do OpenText Identity Console.
O URL HTTPS do OSP deve ser validado com certificados contendo chave de 2048 bits ou mais, com o OpenText Identity Console 1.4 ou posterior.
Se você quiser restringir o acesso de domínios diferentes ao portal do OpenText Identity Console, defina o parâmetro samesitecookie como strict. Se você quiser permitir o acesso de domínios diferentes ao portal do OpenText Identity Console, defina o parâmetro samesitecookie como lax. Se o parâmetro não for especificado durante a configuração, as configurações do browser serão seguidas por padrão.

Quando estiver pronto com o arquivo de configuração, continue a implantação do container. Para obter mais informações, consulte Instalando o OpenText Identity Console como container do Docker.