> 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/attivare-la-console-per-un-ente.md).

# Attivare la console per un nuovo Ente

Cosa succede quando si attiva un nuovo Ente e come si nomina il primo amministratore della console.

Ogni Ente ha la propria IAM Console. Non serve installarla: si attiva insieme all'Ente nel Tenant Manager. Il lavoro manuale dello staff è uno solo: **nominare il primo amministratore**.

## Cosa succede in automatico

Quando crei un nuovo cliente nel Tenant Manager:

1. il Tenant Manager crea per l'Ente un'applicazione **iam-console**, come per ogni altro prodotto;
2. il Tenant Manager crea in Authentik il gruppo della console dell'Ente e lo collega all'applicazione della console, così solo chi è nel gruppo può entrare;
3. il flusso Windmill `f/tenant_manager/iam-console/provision` avvisa la console con un webhook;
4. la console prepara su OpenFGA i ruoli dell'Ente e delle sue applicazioni e collega le applicazioni all'Ente.

Se il webhook non risponde correttamente, il Tenant Manager non completa la transizione del tenant: il problema si vede subito nello stato del tenant.

{% hint style="info" %}
La console si riallinea anche da sola: a ogni avvio e ogni ora rilegge Enti e applicazioni dal Tenant Manager e sistema ruoli e accessi. Un Ente attivato mentre la console era ferma viene recuperato al giro successivo.
{% endhint %}

## Nominare il primo amministratore

Il primo amministratore dell'Ente lo nomina sempre lo staff OpenCity. Da quel momento l'Ente gestisce i propri accessi in autonomia.

{% stepper %}
{% step %}

## Entra nella console dell'Ente

Apri <https://iam.opencityitalia.it> con il tuo account dello staff e scegli l'Ente dal selettore in alto. Come staff vedi tutti gli Enti che hanno la console attiva (vedi [Lo staff OpenCity nella console](https://manuale.opencontent.it/manuali/manuale-operativo-interno/iam-console/lo-staff-opencity-nella-console.md)).
{% endstep %}

{% step %}

## Fai entrare la persona nell'Ente

Nella pagina **Operatori** usa **Aggiungi**, inserisci l'email della persona e scegli almeno un'applicazione a cui deve accedere.

* se la persona ha già un account OpenCity, riceve subito l'accesso e un'email che la avvisa;
* altrimenti la console crea l'account e le manda un'email con il link per impostare la password.

La console stessa non compare tra le applicazioni: il suo accesso lo danno i ruoli.
{% endstep %}

{% step %}

## Assegna il ruolo di amministratore

Apri la persona dall'elenco, vai nella scheda **Ruoli** e assegna **Amministratore dell'ente**. Il ruolo le dà anche l'accesso alla console: al prossimo accesso la vede.
{% endstep %}

{% step %}

## Verifica

Chiedi alla persona di entrare nella console. Deve vedere la pagina **Applicazioni** con le applicazioni dell'Ente e poter aprire la pagina **Operatori**.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
L'assegnazione dei ruoli funziona solo se nell'ambiente è attiva la variabile `IAM_ROLES_WRITE_ENABLED=true`; senza, la console risponde che l'operazione non è permessa.
{% endhint %}

## Limiti dell'Ente

Ogni Ente parte con i limiti di default: **cinque operatori** e **nessun operatore con secondo fattore**. Se il contratto prevede di più, imposta i limiti in GrowthBook prima di consegnare la console all'Ente (vedi [Limiti, MFA e manutenzione con GrowthBook](https://manuale.opencontent.it/manuali/manuale-operativo-interno/iam-console/limiti-mfa-e-manutenzione.md)). Lo staff OpenCity non conta nei limiti.
