> For the complete documentation index, see [llms.txt](https://manuale.opencontent.it/manuali/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manuale.opencontent.it/manuali/manuale-operativo-interno/iam-console/come-funziona/accesso-unico.md).

# Un solo accesso per tutti i prodotti

Un account per tutti i prodotti OpenCity dell'Ente, con un'unica pagina di accesso.

Ogni persona ha **un solo account OpenCity** e lo usa per entrare in tutte le applicazioni a cui ha accesso. Non servono credenziali diverse per ogni prodotto: l'accesso passa sempre dalla stessa pagina.

## Come funziona per chi accede

* l'account è legato all'**email** della persona, che non si può modificare;
* con lo stesso account la persona entra in tutte le applicazioni dell'Ente che l'amministratore le ha assegnato;
* se una persona lavora per più Enti, l'account resta uno solo: ogni Ente decide a quali delle proprie applicazioni può accedere;
* se l'Ente lo attiva per quella persona, all'accesso viene chiesto anche un **secondo fattore** (MFA, autenticazione a più fattori) oltre alla password.

## Come nasce un account

Nella console una persona entra sempre con **Aggiungi**, nella pagina **Operatori**: l'amministratore inserisce l'email e sceglie almeno un'applicazione. Cosa succede dipende da chi è la persona:

* **non ha ancora un account OpenCity**: la console crea subito l'account e le manda un'email con il link per **impostare la password**. Al primo accesso la persona sceglie la password e può entrare nelle applicazioni assegnate;
* **ha già un account OpenCity**, per esempio perché lavora per un altro Ente: la console le dà l'accesso alle applicazioni scelte e le manda un'email che la avvisa. La password resta quella che già usa.

Il link per impostare la password:

* vale **24 ore**, la durata predefinita dei token in Authentik (impostazione **Default token duration** in *System → Settings*);
* si usa **una volta sola**;
* sostituisce il precedente: se ne generi uno nuovo, quello vecchio smette di funzionare.

Se l'email non arriva o il link non vale più, chi ha il ruolo **Link di recupero** genera un link nuovo dal dettaglio dell'operatore e lo manda alla persona.

{% hint style="warning" %}
Gli **inviti** (un'email con un link da accettare entro sette giorni) sono disattivati nella console: "Aggiungi" crea sempre l'account. Nella pagina Operatori possono comparire ancora inviti creati in passato: si possono rinnovare o revocare, ma non se ne creano di nuovi. Le API v1 invece permettono ancora di creare inviti (vedi [API v1 e webhook](https://manuale.opencontent.it/manuali/manuale-operativo-interno/iam-console/api-v1-e-webhook.md)).
{% endhint %}

{% hint style="info" %}
L'account è unico per tutta la piattaforma. Per questo alcune azioni che toccano l'account, per esempio il recupero della password o il secondo fattore, seguono regole più prudenti quando la persona lavora per più Enti.
{% endhint %}

## Il ruolo della IAM Console

La IAM Console non sostituisce la pagina di accesso: decide **chi può entrare in quale applicazione**. Quando l'amministratore dà a una persona l'accesso a un'applicazione, quella persona può entrarci con il suo account; quando lo toglie, l'accesso a quell'applicazione cessa.
