Requisitos de certificado

Importante:

Para obter detalhes sobre como gerenciar certificados pós-instalação, consulte Gerenciamento de certificados.

O Automation Suite requer dois certificados no momento da instalação.

• Certificado TLS - necessário para comunicação TLS entre o cliente e o cluster;
• Certificado de assinatura do token de identidade — necessário para assinar o token de autenticação.

Importante:

O processo de instalação gera certificados autoassinados em seu nome. Recomendamos que você os substitua por certificados assinados por uma Autoridade de Certificação (CA) confiável. Observe que os certificados podem ser gerados no momento da instalação apenas se você conceder ao instalador do Automation Suite privilégios de administrador durante a instalação. Se você não puder conceder os privilégios de administrador do instalador, então você deve criar e gerenciar os certificados por conta própria.

Além dos certificados anteriores, você pode precisar fornecer certificados CA confiáveis adicionais se quiser que o cluster confie em software externo. Exemplo: certificado de CA do SQL Server, certificado de CA do servidor SMTP, certificado de CA de objectstore externo compatível com S3, etc.

No momento da instalação, você deve fornecer certificados de CA para qualquer software externo que requer uma comunicação TLS segura. No entanto, se você não habilitou a comunicação TLS, você pode configurá-la pós-instalação.

Para obter instruções, consulte Como gerenciar certificados.

Requisitos de certificado TLS

O certificado TLS deve atender aos seguintes requisitos:

• O formato do arquivo deve ser .pem, ou seja, certificado DER codificado em Base64;
• O comprimento da chave privada deve ser de pelo menos 2048;
• Uso estendido de chave: autenticação TLS de servidor da web; necessário para acessar o Automation Suite em dispositivos iOS;
• A chave do certificado deve estar descriptografada. Se a chave estiver criptografada, execute o seguinte comando para descriptografá-la:

  # replace /path/to/encrypted/cert/key to absolute file path of key
  # replace /path/to/decrypt/cert/key to store decrypt key
  # Once prompted, please entry the passphrase or password to decrypt the key
  
  openssl rsa -in /path/to/encrypted/cert/key -out /path/to/decrypt/cert/key
  

• Deve ter um nome alternativo de assunto para todas as entradas de DNS necessárias para a instalação do Automation Suite. Se o FQDN para o cluster for automationsuite.mycompany.com, o certificado SAN deve ter o seguinte DNS:
  • automationsuite.mycompany.com
  • *.automationsuite.mycompany.com
    Observação:

    Como alternativa, se o *curinga for muito genérico, certifique-se de ter entradas SAN para o seguinte DNS:

    • automationsuite.mycompany.com
    • alm.automationsuite.mycompany.com
    • monitoring.automationsuite.mycompany.com
    • insights.automationsuite.mycompany.com
    • apps.automationsuite.mycompany.com

Arquivo de certificado TLS

O Automation Suite requer três arquivos no momento de instalação, conforme a seguir:

• Arquivo de certificado TLS - o arquivo de certificado público do servidor. Este arquivo deve conter apenas o certificado leaf do servidor.
• Arquivo de chave TLS - arquivo de chave privada para o certificado do servidor.
• Certificate Authority Bundle - this is the Public Certificate of CA which is used to sign or issue the TLS certificate. This file must contain the complete certificate chain, including the root CA and all intermediate certificates.

Importante:

Starting with Automation Suite 2024.10.8, partial chains - providing only the leaf certificate and root CA without intermediate certificates - are no longer accepted. TLS validation will fail if the certificate chain is incomplete.

Para verificar o certificado da CA e do TLS, execute o comando a seguir na máquina Linux:

# Please replace /path/to/ca-certificate-bundle and /path/to/server-certificate with actual file path.

openssl verify -CAfile /path/to/ca-certificate-bundle /path/to/server-certificate

Se você optar por trazer seu próprio Gerenciador de certificados e seu certificado TLS for emitido por uma CA privada ou não pública, você deve incluir manualmente o certificado de folha e os certificados de CA intermediários no arquivo do certificado TLS. No caso de CAs públicas, elas são automaticamente confiáveis pelos sistemas do cliente, e nenhuma ação adicional é necessária de sua parte.

Certificado de assinatura do token de identidade

O Automation Suite tem os seguintes requisitos em termos de certificados de assinatura do token no momento da instalação:

• O formato do arquivo deve ser pkcs12 para assinar o token de autenticação;
• A senha para assinar o certificado é necessária.

Se um certificado de assinatura do token de identidade não for fornecido, o Automation Suite usa os certificados do servidor para gerar um no momento da instalação.