# Generazione API Key

Il ruolo che ne possiede il **pieno potere** a livello di **operatività** è il **Responsabile Tecnico**:

* interno al **PSP**, nel caso di soggetto **direttamente connesso** al Nodo dei Pagamenti PagoPA;
* dell’**Intermediario Tecnologico** o del **Partner tecnologico** del **PSP**, nel caso di soggetto **non direttamente connesso** al Nodo dei Pagamenti PagoPA.

L' **Amministratore** possiede invece **pieno** **potere** a livello di **visualizzazione.**

### Sezione API Key: Ambiente di Collaudo

Dalla **Panoramica - Area riservata**, dopo aver cliccato sul pulsante "Gestisci**"** del prodotto e aver selezionato l'ambiente target, ad esempio **"Collaudo"**, l'utente accede alla *Pagina Vista API Key.*

Nella suddetta *Pagina* è possibile procedere alla generazione delle chiavi cliccando sul tasto “+ Genera API Key” o su link in blu “Genera API Key”.

<figure><img src="https://490180108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F46oWOwuxwu0HEYnJPQ4h%2Fuploads%2FGOJoM2V2FwCq7SmAXZk7%2Fimage.png?alt=media&#x26;token=0501e32d-4886-4eeb-8b65-575d020e4239" alt=""><figcaption><p><em>Pagina Vista API Key</em></p></figcaption></figure>

Effettuando il click, si accede alla *Pagina di Selezione tipo di prodotto*

#### **Selezione del tipo di prodotto**

Nella *Pagina di Selezione tipo di prodotto,* tramite Il menu a tendina “Tipo di prodotto”, è possibile visualizzare e selezionare la tipologia di prodotto per cui è necessario generare le chiavi.

{% hint style="info" %}
La prossima sezione descrive il processo di generazione di una coppia di API Key per una tipologia di prodotto, la principale, ovvero la ***connessione con nodo***.&#x20;

Le altre tipologie di prodotto, per semplicità non descritte hanno rispettivamente i seguenti compiti:

* ***FdR - Flussi di Rendicontazione*** (PSP) -> prodotto da utilizzare per recuperare i flussi di rendicontazione da parte dei PSP
* ***Backoffice External (PSP)** ->  prodotto da utilizzare per le API esterne descritte nella sezione* [*"External API"*](https://docs.pagopa.it/manuale-back-office-pagopa/manuale-bo-pagopa-psp/readme/funzionalita/broken-reference)
  {% endhint %}

<figure><img src="https://490180108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F46oWOwuxwu0HEYnJPQ4h%2Fuploads%2FX9SpSw2bOauXFnVvVkfJ%2FScreenshot%202024-03-18%20alle%2016.15.54.png?alt=media&#x26;token=ae706eab-8186-4a90-a0db-10e21e7e9873" alt=""><figcaption></figcaption></figure>

#### **Connessione con nodo**

*Questa API Key permette di connettersi al Nodo Pagamenti di PagoPA: azione propedeutica per tutte le ulteriori operazioni.*

Per procedere, dal menù è necessario selezionare il prodotto “**Connessione con nodo**”.

Solo una volta selezionata la voce, sarà possibile proseguire cliccando sul pulsante “Genera API Key”.

Cliccando sul tasto "Annulla", invece, è possibile tornare alla *Pagina Vista API Key.*

<figure><img src="https://490180108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F46oWOwuxwu0HEYnJPQ4h%2Fuploads%2FFrUBXPQXjTfEw4vcrwOZ%2Fimage.png?alt=media&#x26;token=b9f93685-e140-4d03-8576-9589188c0dc6" alt=""><figcaption><p><em>Pagina di Selezione tipo di prodotto: Connessione con nodo</em></p></figcaption></figure>

Una volta aver cliccato sul pulsante “Genera API Key”, se la coppia di chiavi (primaria e secondaria) è stata generata correttamente allora è possibile visualizzarle e gestirle all’interno della *Pagina Vista API Key.*

<figure><img src="https://490180108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F46oWOwuxwu0HEYnJPQ4h%2Fuploads%2FZLVy3P2PwIA435Z3iqkz%2Fimage.png?alt=media&#x26;token=26591dbf-bac2-4b67-8f9c-8fd526a7be33" alt=""><figcaption><p><em>Pagina Vista API Key: Connessione con nodo</em></p></figcaption></figure>

Per ogni campo contenente il codice API Key è possibile effettuare le seguenti azioni:

* cliccare su **icona a forma di occhio** che consente la visualizzazione del Codice alfanumerico

<figure><img src="https://490180108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F46oWOwuxwu0HEYnJPQ4h%2Fuploads%2FB3j0gK02mI8UgSBUQHmy%2Fimage.png?alt=media&#x26;token=9dcd1626-2dfa-4a38-97d4-66a5e9de7003" alt=""><figcaption><p><em>Pagina Vista API Key: icona a forma di occhio</em></p></figcaption></figure>

* cliccare sul tasto **"Usa questa chiave"** che permette di copiare ed incollare il codice alfanumerico;

<figure><img src="https://490180108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F46oWOwuxwu0HEYnJPQ4h%2Fuploads%2FAOiKqZxJVrUk9Pm85jVk%2Fimage.png?alt=media&#x26;token=01f86a87-8845-4ec8-b5e2-848c52238df1" alt=""><figcaption><p><em>Pagina Vista API Key: tasto “Usa questa chiave”</em></p></figcaption></figure>

* cliccare sul tasto **“Rigenera”**, da cui verrà mostrato il pop up informativo che consente di generare un nuovo codice. Se si intende procedere alla generazione del nuovo codice è necessario cliccare sul pulsante “Rigenera”, altrimenti sul pulsante “Annulla” al fine di chiudere il pop up.

<figure><img src="https://490180108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F46oWOwuxwu0HEYnJPQ4h%2Fuploads%2FqSWq0XOOkooDkSVZWV0Y%2Fimage.png?alt=media&#x26;token=7663f31a-cefa-46f4-bd61-5ca49687c3a4" alt=""><figcaption><p><em>Pagina Vista API Key: tasto “Rigenera”</em></p></figcaption></figure>

Completata la generazione della coppia di chiavi per il prodotto Connessione con nodo in ambiente di Collaudo, è possibile effettuare questa operazione in ambiente di Produzione.&#x20;

Per procedere è necessario ritornare nella Panoramica - Area Riservata, selezionando questa dal **menù a tendina** situato al lato sinistro dell'intestazione.

<figure><img src="https://490180108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F46oWOwuxwu0HEYnJPQ4h%2Fuploads%2F0eSv7iJJPSaklIveXXwu%2Fimage.png?alt=media&#x26;token=3b216ca3-12a6-4c6d-81f5-7d612e522f74" alt=""><figcaption><p><em>Menu a tendina che consente di tornare nella Panoramica di Area Riservata</em> </p></figcaption></figure>

Dalla Panoramica - Area riservata, dopo aver cliccato sul pulsante "Gestisci" del prodotto è possibile selezionare il secondo ambiente per cui si intende effettuare la generazione es. **"Produzione".**

<figure><img src="https://490180108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F46oWOwuxwu0HEYnJPQ4h%2Fuploads%2FcZl2eXeI8Kn4j2ZU0D26%2Fimage.png?alt=media&#x26;token=4b7f4108-3155-42d0-a15e-bf673aca8ff8" alt=""><figcaption><p><em>Pop up di selezione ambiente target</em></p></figcaption></figure>

### Sezione API Key: Ambiente di Produzione

L'utente potrà procedere alla **generazione** delle API Key in **ambiente di produzione**, svolgendo le stesse azioni illustrate nella sezione API Key: Ambiente di Collaudo.