> For the complete documentation index, see [llms.txt](https://docs.pagopa.it/manuale-back-office-pagopa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagopa.it/manuale-back-office-pagopa/manuale-bo-pagopa-psp/readme/funzionalita/generazione-api-key.md).

# 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="/files/iDxbQL1MY4ox5ru7Pfi4" 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"*](broken://pages/FcGBQ2PgxwRjZrmCp6IL)
  {% endhint %}

<figure><img src="/files/zBsk5RAxW4OqCWvcVPBt" 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="/files/6orYt59ZeegTIdqZgv9g" 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="/files/PzXg0SoRCb1h3Vdr0vc5" 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="/files/qttPC2q99OSUWtbTDrJ0" 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="/files/7JxDmyszTtcsG6LTQ4Qp" 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="/files/GmjOA3KJBiLfCRHGTYcU" 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="/files/ZrjTslBR8XlVLuR7783f" 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="/files/BIycJtnex1MLVgZPX9OX" 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.