> 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/limiti-mfa-e-manutenzione.md).

# Limiti, MFA e manutenzione con GrowthBook

I flag GrowthBook della IAM Console, i valori di default e come si attiva la manutenzione.

Alcune regole della console non stanno nel codice ma in **GrowthBook**: il numero di operatori per Ente, quanti possono avere il secondo fattore e la modalità di manutenzione. Le modifichi in GrowthBook e la console le applica entro **un minuto**, senza riavvii.

## I flag

| Flag                             | Default           | Cosa decide                                                                                                                                                                              |
| -------------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `iam_max_operators`              | 5                 | Quanti operatori può avere l'Ente                                                                                                                                                        |
| `iam_max_mfa_operators`          | 0                 | Quanti operatori possono avere il secondo fattore                                                                                                                                        |
| `iam_password_expiry_days`       | 365 (da 90 a 365) | Giorni di validità della password (vedi [Scadenza della password e promemoria](https://manuale.opencontent.it/manuali/manuale-operativo-interno/iam-console/scadenza-della-password.md)) |
| `iam_inactivity_suspension_days` | 365 (da 90 a 730) | Giorni di inattività prima della sospensione. Per ora solo informativo                                                                                                                   |
| `is_in_maintenance`              | false             | Mette la console in manutenzione                                                                                                                                                         |

Un valore fuori dall'intervallo viene riportato al limite più vicino; un valore non numerico viene ignorato e vale il default. In entrambi i casi la console lo segnala nei log con `flag_value_clamped`.

## Alzare i limiti di un Ente

Il modo più semplice è il **Tenant Manager**: cerca il tenant **iam-console** dell'Ente, apri il tab **Feature flag**, imposta il valore e salva.

In alternativa aggiungi in GrowthBook una regola sul flag, valida solo per quell'Ente. La console passa a GrowthBook due attributi che puoi usare nella condizione:

* `customer_id`: l'UUID dell'Ente;
* `tenant_id`: l'UUID dell'applicazione **iam-console** dell'Ente.

**Come si contano gli operatori:**

* contano le persone dell'Ente e gli inviti ancora in attesa;
* non contano lo staff OpenCity, gli amministratori della piattaforma e i service account;
* il rinnovo di un invito scaduto occupa un posto (gli inviti si creano ormai solo dalle API v1).

Se un Ente è già oltre il limite, chi c'è resta; non si possono però aggiungere persone nuove finché non alzi il limite o qualcuno esce.

{% hint style="warning" %}
Con il default `iam_max_mfa_operators = 0` nessun operatore dell'Ente può attivare il secondo fattore. Se l'Ente lo chiede, alza prima il limite.
{% endhint %}

## Attivare la manutenzione

{% stepper %}
{% step %}

## Imposta la regola

Nel flag `is_in_maintenance` aggiungi una regola con condizione `app_name` uguale a `iam-console` e valore `true`, nell'ambiente giusto (QA o produzione), e pubblica. La condizione su `app_name` serve se il flag è condiviso con altre applicazioni.
{% endstep %}

{% step %}

## Attendi un minuto

La console aggiorna i flag ogni minuto. Nei log compare l'evento `maintenance_on`.
{% endstep %}

{% step %}

## Per uscire

Togli la regola o metti il valore a `false`. Entro un minuto nei log compare `maintenance_off`.
{% endstep %}
{% endstepper %}

**Durante la manutenzione:**

* le pagine mostrano un avviso di servizio non disponibile, anche all'indirizzo stabile `/manutenzione`;
* le API della console e le API v1 rispondono con errore 503 e chiedono di riprovare dopo cinque minuti;
* l'accesso (`/api/auth`) e i webhook di Tenant Manager e Authentik continuano a funzionare.

La manutenzione vale per tutta la console: non si può mettere in manutenzione un solo Ente.

## Se GrowthBook non risponde

La console continua con le ultime regole scaricate oppure, se non ne ha ancora, con i valori di default. Non va mai in errore e non toglie mai i limiti. Nei log trovi `growthbook_unavailable` e poi `growthbook_available` quando torna raggiungibile.
