# Certificati attendibili

Aggiungere certificati CA o autofirmati affinché la piattaforma consideri attendibili via TLS mail relay, gateway SMS o destinazione di provisioning.

Quando la piattaforma apre una connessione TLS in uscita verso uno dei propri server, ne convalida il certificato. In **Certificati attendibili** si aggiunge l'autorità di certificazione (CA) o il certificato autofirmato che quel server presenta, in modo che la connessione risulti attendibile anziché venire rifiutata.

Questa attendibilità vale unicamente per le connessioni **in uscita** (la piattaforma agisce da client e convalida il certificato del *server remoto*). Sono interessati:

- il proprio **mail relay** (un server SMTP dedicato),
- il proprio **gateway SMS personalizzato**,
- il **provisioning in uscita** verso una destinazione SCIM,
- un server multifattore **privacyIDEA** self-hosted.

Gli endpoint che presentano un certificato attendibile pubblicamente (ad esempio un'API commerciale di posta o SMS) funzionano senza alcuna voce in questo elenco.

> **Nota:** l'autenticazione a più fattori tramite Duo non è coperta da questo archivio di attendibilità. L'integrazione Duo convalida direttamente il certificato cloud di Duo e non può essere reindirizzata verso un'altra autorità di certificazione. Se la propria rete esegue l'ispezione TLS (decrittazione SSL) sul traffico in uscita, occorre **escludere gli host del servizio Duo (`*.duosecurity.com`) dall'ispezione**, altrimenti l'accesso Duo fallisce.

## Quando serve

Aggiungere un certificato quando il server di destinazione usa:

- un **certificato autofirmato**, oppure
- un certificato emesso da un'**autorità di certificazione interna / privata** non attendibile pubblicamente.

Se non viene aggiunto, la connessione fallisce con un errore come `self-signed certificate in certificate chain`.

## Prima di iniziare

- Avere a disposizione il certificato in formato **PEM** (un blocco di testo che inizia con `-----BEGIN CERTIFICATE-----`).
- Per un certificato emesso da una CA interna, aggiungere il **certificato della CA** (e gli eventuali certificati intermedi), non il certificato foglia del server. Nel dubbio, includere l'intera catena.

## Aggiungere un certificato attendibile

1. Aprire **Impostazioni → Certificati attendibili**.
2. Selezionare **Aggiungi certificato**.
3. Inserire un **Nome** che ne permetta il riconoscimento successivo (ad esempio `Internal Mail Relay CA`).
4. Incollare il certificato nel campo di testo, oppure trascinare un file `.pem` / `.crt` nell'area di caricamento.
5. Selezionare **Aggiungi certificato**. Il soggetto, l'emittente, la scadenza e il fingerprint vengono letti dal certificato e mostrati nell'elenco.

È possibile incollare un'intera catena o un bundle (più certificati in un unico blocco); ogni certificato viene memorizzato come voce distinta.

## Rimuovere un certificato attendibile

Nell'elenco, selezionare l'icona di eliminazione sulla riga e confermare. Il certificato non è più considerato attendibile; le connessioni verso i server che vi fanno affidamento possono quindi fallire.

> **Nota:** una modifica può richiedere alcuni minuti per essere applicata su tutti i nodi dell'istanza.

## Riferimento

| Campo | Note |
|---|---|
| Formato | PEM (`-----BEGIN CERTIFICATE-----`). Un singolo certificato, una catena o un bundle. |
| Metadati mostrati | Nome, soggetto, tipo (CA radice / CA intermedia o certificato), scadenza, fingerprint (SHA-256) |
| Scadenza | Un certificato scaduto viene rifiutato al caricamento; le voci prossime alla scadenza sono segnalate nell'elenco |
| Ambito di validità | Un certificato attendibile vale per tutte le connessioni TLS in uscita elencate sopra |

## Risoluzione dei problemi

- **`self-signed certificate in certificate chain`**: la catena del server non è pienamente attendibile. Aggiungere il certificato della CA emittente, compresi gli eventuali intermedi e la radice.
- **Il certificato è scaduto**: il certificato ha superato la propria data di validità. Richiederne uno aggiornato all'operatore del server e aggiungerlo.
- **Mancata corrispondenza del nome host**: considerare attendibile il certificato non salta la verifica del nome host. Il certificato del server deve comunque corrispondere al nome host a cui ci si collega.
- **Aggiunto, ma la connessione continua a fallire**: verificare di aver aggiunto il certificato della CA (non solo il certificato foglia del server) e che l'intera catena sia presente.

## Vedere anche

- [Provider email](https://dts-identity.com/it/docs/branding/email.md)
- [Provider telefono / SMS](https://dts-identity.com/it/docs/branding/phone-sms.md)
