# Certificados fidedignos

Adicione certificados de AC ou autoassinados para que a plataforma confie por TLS no seu relay de correio, gateway SMS ou destino de aprovisionamento.

Quando a plataforma estabelece uma ligação de saída por TLS a um dos seus próprios servidores, valida o certificado desse servidor. Em **Certificados fidedignos** adiciona a autoridade de certificação (AC) ou o certificado autoassinado que esse servidor apresenta, para que a ligação seja considerada fidedigna em vez de recusada.

Esta confiança aplica-se apenas a ligações de **saída** (a plataforma atua como cliente e valida o certificado do *servidor remoto*). Afeta:

- o seu **relay de correio** (um servidor SMTP próprio),
- o seu **gateway de SMS personalizado**,
- o **aprovisionamento de saída** para um destino SCIM,
- um servidor multifator **privacyIDEA** alojado por si.

Os endpoints que apresentam um certificado publicamente fidedigno (por exemplo, uma API comercial de e-mail ou de SMS) funcionam sem qualquer entrada aqui.

> **Nota:** A autenticação multifator através do Duo não é abrangida por este arquivo de confiança. A integração com o Duo valida diretamente o certificado de nuvem do próprio Duo e não pode ser reencaminhada para outra autoridade de certificação. Se a sua rede efetuar inspeção de TLS (desencriptação de SSL) sobre o tráfego de saída, tem de **excluir da inspeção os hosts de serviço do Duo (`*.duosecurity.com`)**, caso contrário o início de sessão com Duo falha.

## Quando precisa disto

Adicione um certificado quando o servidor de destino utilizar:

- um **certificado autoassinado**, ou
- um certificado emitido por uma **autoridade de certificação interna / privada** que não seja publicamente fidedigna.

Se não o adicionar, a ligação falha com um erro como `self-signed certificate in certificate chain`.

## Antes de começar

- Tenha o certificado em formato **PEM** (um bloco de texto que começa por `-----BEGIN CERTIFICATE-----`).
- Para um certificado emitido por uma AC interna, adicione o **certificado da AC** (e quaisquer intermediários), não o certificado folha do próprio servidor. Em caso de dúvida, inclua a cadeia completa.

## Adicionar um certificado fidedigno

1. Abra **Definições → Certificados fidedignos**.
2. Selecione **Adicionar certificado**.
3. Introduza um **Nome** para o reconhecer mais tarde (por exemplo, `Internal Mail Relay CA`).
4. Cole o certificado no campo de texto ou arraste um ficheiro `.pem` / `.crt` para a área de carregamento.
5. Selecione **Adicionar certificado**. O titular, o emissor, a validade e o fingerprint são lidos do certificado e apresentados na lista.

Pode colar uma cadeia completa ou um pacote (vários certificados num só bloco); cada certificado é guardado como uma entrada própria.

## Remover um certificado fidedigno

Na lista, selecione o ícone de eliminação na linha e confirme. O certificado deixa de ser fidedigno; as ligações a servidores que dependam dele podem então falhar.

> **Nota:** Uma alteração pode demorar alguns minutos a aplicar-se em todos os nós da instância.

## Referência

| Campo | Notas |
|---|---|
| Formato | PEM (`-----BEGIN CERTIFICATE-----`). Um certificado, uma cadeia ou um pacote. |
| Metadados apresentados | Nome, titular, tipo (AC raiz / AC intermédia ou certificado), expiração, fingerprint (SHA-256) |
| Expiração | Um certificado expirado é recusado no carregamento; as entradas próximas da expiração são assinaladas na lista |
| Âmbito | Um certificado fidedigno aplica-se a todas as ligações TLS de saída indicadas acima |

## Resolução de problemas

- **`self-signed certificate in certificate chain`**: a cadeia do servidor não é totalmente fidedigna. Adicione o certificado da AC emissora, incluindo quaisquer intermediários e a raiz.
- **O certificado está expirado**: o certificado ultrapassou a sua data de validade. Obtenha um atual junto do operador do servidor e adicione-o.
- **Incompatibilidade de nome de host**: confiar no certificado não dispensa a verificação do nome de host. O certificado do servidor tem de continuar a corresponder ao nome de host a que se liga.
- **Adicionado, mas a ligação continua a falhar**: verifique se adicionou o certificado da AC (e não apenas o certificado folha do servidor) e se a cadeia completa está presente.

## Consulte também

- [Fornecedor de e-mail](https://dts-identity.com/pt/docs/branding/email.md)
- [Fornecedor de telefone / SMS](https://dts-identity.com/pt/docs/branding/phone-sms.md)
