# Utenti

Una delle funzionalità previste dalla piattaforma è quella di poter **visualizzare e gestire i vari utenti e i rispettivi ruoli**.

All'interno della sezione Utenti, è possibile visualizzare la **lista di utenti associati ad ogni prodotto attivo** dell'Ente e per i prodotti per cui si possiede **un ruolo da Amministratore** è anche possibile svolgere una vasta gamma di operazioni (ad esempio, aggiungere, rimuovere, sospendere o riabilitare un altro utente).

<figure><img src="/files/G59uwPHecCxKKYbXAdEi" alt=""><figcaption><p>Sezione Utenti per un utente associato ad più prodotto</p></figcaption></figure>

Qui saranno esposte le liste di utenti abilitati per ogni prodotto:

* Lista “**Tutti**”: espone la lista di tutti gli utenti abilitati, suddivisa per prodotto;
* **Lista per prodotto**: per ogni prodotto specifico esiste un elenco apposito all’interno di cui si potrà consultare la lista di utenti abilitati per quel prodotto. &#x20;

Nel caso in cui l’ente abbia **aderito ad un solo prodotto**, viene esposta un’unica pagina riconducibile al prodotto in questione.

<figure><img src="/files/ifQTnjAjLLd0tE6GUKmu" alt=""><figcaption><p>Sezione Utenti per un utente associato ad un unico prodotti</p></figcaption></figure>

In ogni caso è presente una **funzione di filtraggio** che permette di recuperare i soli utenti in possesso di un determinato ruolo.

Quando si è in visualizzazione “**Tutti**” saranno presenti due livelli di filtraggio:

* Per **abilitazione sul prodotto** (Amministratore/Operatore);
* Per **specifico ruolo del singolo prodotto** (ad esempio, Operatore Api, Operatore Sicurezza, Gestore Notifiche).

<figure><img src="/files/AUY5mNBeYB8UVgEvUZVe" alt=""><figcaption><p>Possibilità di filtro per la lista di tutti gli utenti per tutti i prodotti</p></figcaption></figure>

Se si è posizionati invece su una qualsiasi **lista di prodotto**, sarà possibile filtrare solo per **specifico ruolo sul prodotto**.

<figure><img src="/files/bh9edCqu4ldsaGTBPKSr" alt=""><figcaption><p>Possibilità di filtro per la lista di tutti gli utenti per un prodotto specifico</p></figcaption></figure>

All’interno delle varie liste sarà inoltre possibile l’**aggiunta di un nuovo utente** tramite il pulsante “Aggiungi utente”, al click sul quale viene esposta una scheda da compilare con i dati anagrafici dell’utente che si vuole aggiungere.

<figure><img src="/files/P8QVWb3v4zcsuLSO3WrP" alt=""><figcaption><p>Pagina di aggiunta di un nuovo utente</p></figcaption></figure>

Una volta inseriti tutti i **dati anagrafici** richiesti (codice fiscale, nome, cognome e mail istituzionale) è possibile selezionare il **prodotto** e il **ruolo** che si vogliono associare all’utente. &#x20;

<figure><img src="/files/A8FQdgFn7BAJh314rLC2" alt=""><figcaption><p>Pagina di aggiunta di un nuovo utente</p></figcaption></figure>

Una volta che l’operazione di aggiunta è andata a buon fine, si viene reindirizzati al **profilo dell’utente** aggiunto, da cui è possibile non solo ottenere il dettaglio dei suoi dati, dei ruoli a lui assegnati sui diversi prodotti e dei gruppi del quale è membro, ma anche attuare alcune azioni su tale utenza (in base ai permessi posseduti sui vari prodotti).

#### Profilo utente <a href="#h.2p2csry" id="h.2p2csry"></a>

All’interno di qualsiasi pagina della sezione Utenti, per ciascun utente sono esposte le seguenti informazioni:

* **Nome**: nome e cognome dell’utente;
* **E-mail**: mail istituzionale dell’utente;
* **Ruolo**: ruolo dell’utente all’interno dell’Area Riservata di PagoPA per lo specifico Ente/prodotto.

Inoltre, cliccando sulla freccia a lato di ciascun utente, si potrà accedere alla relativa **scheda profilo**, all’interno della quale saranno esposti sia i dati anagrafici relativi all’utente selezionato (nome, cognome, codice fiscale) sia i ruoli e i gruppi a lui assegnati su ogni prodotto.

<figure><img src="/files/SD4XQ2WsGNC5KKVp7KYx" alt=""><figcaption><p>Pagina di dettaglio del singolo utente</p></figcaption></figure>

Dalla scheda del profilo utente è possibile svolgere una vasta gamma di azioni che dipendono dal proprio ruolo sul prodotto:&#x20;

* Se si è Amministratore del prodotto a cui l'utente è abilitato, è possibile&#x20;
  * **Assegnare** all'utente **un nuovo ruolo** su un altro prodotto: l'Amministratore di Piattaforma Notifiche può assegnare a un qualsiasi utente non ancora abilitato un ruolo sul prodotto (questo vale per un qualsiasi prodotto);&#x20;

  * **Sospendere**/**Riabilitare**/**Rimuovere** il ruolo;

  * **Modificare** i **dati anagrafici** dell’utente;

  * **Assegnare** l’utente ad **uno o più gruppi**.<br>

    <figure><img src="/files/BQWaFMD1HDxMfIqUcXA5" alt=""><figcaption><p> Visualizzazione per un utente che possiede almeno un ruolo attivo di Amministratore sul medesimo prodotto associato all’utente visualizzato</p></figcaption></figure>

  * Se si è Amministratore di uno o più prodotti a cui l'utente non è abilitato, è possibile solamente assegnare all'utente un nuovo ruolo su uno dei propri prodotti; <br>

    <figure><img src="/files/MIsWlfaLe7FusmAUmINm" alt=""><figcaption><p>Visualizzazione per un utente che possiede almeno un ruolo attivo di Amministratore su un prodotto diverso rispetto a quello associato all’utente visualizzato</p></figcaption></figure>

Nel caso in cui l'utente sia abilitato ad alcuni prodotti per cui si è Amministratore e ad altri per cui si possiede un ruolo diverso o nessun ruolo, si potranno effettuare diverse operazioni sull'utenza ma solo relativamente ai propri prodotti.&#x20;

Quindi, ad esempio, se si è Amministratori di SEND ma non di App IO, è possibile svolgere diverse azioni sull'utente ma solo relativamente al prodotto SEND. La gestione dell'utenza per altri prodotti è demandata agli Amministratori dei singoli prodotti.&#x20;

<figure><img src="/files/H2KHYaq1KYVHkCd7K4oo" alt=""><figcaption><p>Visualizzazione per un utente che possiede un ruolo di Amministratore su un prodotto e Operatore su un altro</p></figcaption></figure>

Di seguito si descrivono in dettaglio le varie azioni che possono essere effettuate dall’Amministratore tramite la scheda profilo dei vari utenti.

#### 1. Assegnazione di un nuovo ruolo

Nel caso in cui si sia in possesso di un ruolo attivo di livello **Amministratore su** ulteriori **prodotti non ancora associati all’utente** del quale si sta visualizzando il dettaglio, è disponibile in pagina la funzionalità “Assegna ruolo” che permette l’assegnazione all’utente di un nuovo ruolo su un nuovo prodotto.

<figure><img src="/files/PO5zWR5AG0EksXTIbbcn" alt=""><figcaption><p>Assegnazione di un nuovo ruolo all’utente</p></figcaption></figure>

Se ad esempio un utente è Amministratore del prodotto SEND e Interoperabilità, potrà assegnare un ruolo ad un qualsiasi utente non ancora abilitato ad altri prodotti.&#x20;

#### 2. Modifica dell'utente

La funzione offre la possibilità di modificare i **dati anagrafici** dell’utente; in particolare, mentre il campo relativo al “Codice fiscale” non può essere modificato, nome e cognome sono editabili solo qualora non siano stati verificati in precedenza mediante SPID (tramite accesso da parte dell’utente stesso alla propria Area Riservata).

<figure><img src="/files/bbeKMiLCtaBCBzcnROwd" alt=""><figcaption><p>Modifica dei dati dell'utente</p></figcaption></figure>

L’azione di “Modifica” è consentita solo se si possiede il ruolo da Amministratore su almeno un prodotto che risulti in comune con l’utente del quale si sta visualizzando il rispettivo dettaglio (e, inoltre, se quest'ultimo non abbia unicamente ruoli in stato “Sospeso”).

#### 3. Assegnazione di un altro ruolo

La funzione “Assegna un altro ruolo” è disponibile per l'’Amministratore nel caso in cui l’**utente** visualizzato sia già stato **abilitato ad un prodotto** ma **non** **possiede ancora tutti i ruoli** ammessi su quest'ultimo.

<figure><img src="/files/zq1xmMttfMDZKJsIdApv" alt=""><figcaption><p> Funzione Assegna un altro ruolo in scheda di dettaglio dell'utente</p></figcaption></figure>

Oltre al ruolo di Amministratore e Operatore sull’Area Riservata, ogni **prodotto** può prevedere dei **ruoli specifici** che rimandano a queste due categorie.&#x20;

\
È dunque possibile che per un prodotto esistano **diversi ruoli all’interno della stessa categoria** (ad esempio Operatore Sicurezza e Operatore API che appartengono entrambi alla categoria Operatore): se l’utente non ha già tutti i ruoli disponibili sul prodotto, è possibile assegnargli i ruoli non ancora posseduti (ad esempio un utente che è abilitato come Operatore Sicurezza potrà essere abilitato tramite la funzione Assegna ruolo anche come Operatore API).

Non è possibile in nessun caso censire uno stesso utente sia come Amministratore che come Operatore sullo stesso prodotto.

<br>

<figure><img src="/files/gIjk3QUABKSFxyIVJOMU" alt=""><figcaption><p>Assegnazione di un ruolo aggiuntivo</p></figcaption></figure>

####

#### 4. Sospensione di un ruolo

Per procedere alla **sospensione un ruolo** è presente l’apposito tasto “Sospendi” sulla specifica card di prodotto: questa funzione permette di inibire **temporaneamente** la possibilità dell’utente di operare sul prodotto senza rimuoverlo.

Cliccando su “Sospendi”, viene esposta una finestra da cui è possibile:

* **confermare l'operazione**: all’interno del profilo utente viene mostrato contestualmente il tag “Sospeso” in corrispondenza del prodotto e l'azione “Sospendi” viene modificata in “Riabilita”;
* **annullare l'operazione** e tornare sul profilo utente; l’utenza risulterà ancora attiva.

<figure><img src="/files/AM3odJh7h57oyEjMqer2" alt=""><figcaption><p>Finestra di conferma di sospensione del ruolo di un utente</p></figcaption></figure>

\
L’utente sospeso non potrà più operare sul prodotto fino a che non sarà riabilitato.

#### 5. Riabilitazione di un ruolo

Per **riabilitare un ruolo** di un **utente sospeso**, si dovrà cliccare su “Riabilita” presente nella all'interno della card di prodotto.

Cliccando su “Riabilita”, viene esposta una finestra da cui è possibile:

* **confermare l'operazione**: all’interno del profilo utente viene rimosso contestualmente il tag “Sospeso” in corrispondenza del prodotto e l'azione “Riabilita” viene modificata in “Sospendi”;
* **annullare l'operazione** e tornare sul profilo utente; l’utenza risulterà ancora sospesa.

<figure><img src="/files/QWq0yqB9OdCDyCojpgj2" alt=""><figcaption><p>Finestra di conferma di riabilitazione del ruolo di un utente</p></figcaption></figure>

Una volta riabilitato, l’utente potrà nuovamente operare sul prodotto.

#### 6. Rimozione di un ruolo

L’azione scritta “Rimuovi”, presente nella scheda di dettaglio dell’utente, garantisce la possibilità di **rimuovere un ruolo dell’utente su un determinato prodotto**.

Anche in questo caso, viene mostrata una finestra per la conferma dell'operazione:

<figure><img src="https://lh4.googleusercontent.com/0ZAinGxFUP5U-0vdRVmLq5fMP50PKxxe4upjb6LTK2z102D0L3ee1If3fRiiWNhghnAZpf3BkOfiOE0az-GQSlxtRxP-EMu9HxPYLdRiNjmBF01RqAC7mD-HQtr90j3hcQxPB50WG0_I-_dJYkjZFQbeqk5vIK_NbL5h69epkQSIM8r2tRNGQXlyCPfPA9Hb25sMq3Tv" alt=""><figcaption><p>Finestra di conferma di rimozione del ruolo di un utente</p></figcaption></figure>

Una volta rimosso il ruolo, l'utente **non** ha più possibilità di **accedere o operare su quello specifico prodotto.** Inoltre, il ruolo non sarà più visibile né all'interno del profilo utente, né nella sezione generale Utenti.\
Inoltre, l’eliminazione dell’ultimo ruolo sull’ultimo prodotto dell’utente ha come conseguenza la sua completa eliminazione a livello di Area riservata: questi dovrà essere aggiunto nuovamente ad almeno un prodotto per poter accedere nuovamente.

<figure><img src="https://lh5.googleusercontent.com/IOlIjLPlcrCcFFYkYnSYzVwVJA1Zhx73NNWGJd54Xn6dqn6mmgkTa4M-ZBilHA_L7MIQCaTzjvJFV5g1KgL_6J6Nglkhra6ufzDG5o7FzV3TsMeF8xTwEOJx3VLvCr2W2SIFJvAgO5Zs9NzUGBR-WWa1kQQoPKtMdnwScKg3ylImUaSVk7-jaRzNzznSWgHYY7-fehI3" alt=""><figcaption><p>Finestra di conferma della cancellazione dell'utente dall'area riservata (caso in cui si elimini l'ultimo ruolo associato all'utente)</p></figcaption></figure>

Per poter tornare a operare sul prodotto, l'utente deve essere aggiunto o deve essergli assegnato nuovamente il ruolo.&#x20;

#### 7. Assegnazione ad un gruppo

All'interno della card di prodotto è infine presente una funzionalità che permette l’**associazione dell’utente ad un gruppo** (“Assegna gruppo”).

<figure><img src="/files/zlxtP7yX2ab9J236YspT" alt=""><figcaption><p>Funzionalità di assegnazione dell'utente ad un gruppo</p></figcaption></figure>

Tale funzionalità è presente solo se se si verificano **contemporaneamente** queste due condizioni:

1. Esiste almeno un gruppo (in stato attivo) associato al prodotto;
2. L’utente in questione non appartiene già a tutti i gruppi in stato attivo presenti per il prodotto.

Cliccando sull'azione, si apre una finestra con l'**elenco dei gruppi assegnabili**:

<figure><img src="/files/FGKq9RcNyAdPJXX9ORE7" alt=""><figcaption><p>Elenco dei gruppi disponibili all'assegnazione</p></figcaption></figure>

Al click su “Assegna gruppo”, l’utente viene assegnato al gruppo selezionato, altrimenti è possibile tornare indietro tramite tasto “Annulla”.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pagopa.it/area-riservata-enti-piattaforma-notifiche/area-riservata-enti-send-servizio-notifiche-digitali/area-riservata/utenti.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
