> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/stanza-del-cittadino/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/cambio-certificati-ssl.md).

# Cambio certificati SSL

Quando un intermediario di pagamento (es. IRIS-RT) comunica un cambio di certificati SSL, nella maggior parte dei casi non è necessario alcun intervento sulla piattaforma OpenCity Italia.

## Perché spesso non serve fare nulla

La piattaforma verifica automaticamente l'attendibilità dei server remoti tramite il bundle standard di CA pubbliche di Python (**certifi**). Questo bundle include le principali catene di certificazione (es. Telecom Italia Trust Technologies, Sectigo, USERTrust) e si aggiorna con le release standard di Python.

Se il nuovo certificato dell'intermediario è firmato da una CA già inclusa nel bundle certifi, non è necessaria nessuna configurazione aggiuntiva.

{% hint style="info" %}
Esempio: in occasione del cambio certificati SSL di IRIS-RT (staging 28/05/2026, produzione 04/06/2026), non è stato necessario modificare il proxy di pagamento — la catena di certificazione era già inclusa nel bundle certifi.
{% endhint %}

## Quando è necessario intervenire

Un intervento manuale è necessario solo se:

* il nuovo certificato è firmato da una CA non presente nel bundle certifi;
* l'intermediario usa un certificato self-signed o emesso da una CA privata.

In questi casi, contatta il team tecnico di OpenCity Italia per aggiornare la configurazione del proxy di pagamento.

## Come verificare prima di intervenire

1. Chiedi all'intermediario il nome della CA emittente del nuovo certificato.
2. Verifica che sia inclusa nel bundle certifi (lista disponibile su [pypi.org/project/certifi](https://pypi.org/project/certifi/)).
3. Se è presente, non serve alcun intervento.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.opencityitalia.it/stanza-del-cittadino/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/cambio-certificati-ssl.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.