> 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/scadenza-della-password.md).

# Scadenza della password e promemoria

Quando scade la password degli operatori, i promemoria via email, la durata ridotta per Ente e cosa rispondere al supporto.

La password degli operatori scade dopo **365 giorni** dall'ultimo cambio. Un Ente può chiedere una durata più breve, fino a **90 giorni**. Prima della scadenza l'operatore riceve tre promemoria via email; alla scadenza cambia la password al primo accesso, con un link che riceve per email.

La scadenza la applica **Authentik** a ogni accesso. Il **controllo giornaliero** della IAM Console calcola la durata per ogni operatore e manda i promemoria.

## Cosa vede l'operatore

{% stepper %}
{% step %}

## Venti, dieci e un giorno prima

Riceve un'email «La tua password OpenCity scade il …» (l'ultima: «scade domani»). L'email non contiene link: indica l'indirizzo della pagina di accesso e spiega il percorso **accedi, poi Cambia password**. Ricorda anche che OpenCity non chiede mai la password via email.
{% endstep %}

{% step %}

## Nel proprio profilo

In **Sicurezza e accesso**, sopra **Cambia password**, vede la data di scadenza. Dai 20 giorni prima l'avviso diventa giallo.
{% endstep %}

{% step %}

## Alla scadenza

Accede con password ed eventuale secondo fattore. Authentik gli manda l'email «La tua password è scaduta» con un link valido **30 minuti** e una volta sola. Aprendo il link, anche da un altro dispositivo, conferma con **Continue** (testo in inglese, non traducibile), sceglie la nuova password ed entra.
{% endstep %}
{% endstepper %}

Se cambia la password prima della scadenza, il conteggio riparte da quel giorno e i promemoria si fermano.

**La nuova password deve:**

* avere almeno 12 caratteri;
* non essere facile da indovinare: va bene una frase di più parole;
* essere diversa da quella attuale;
* non contenere nome, cognome, email o termini prevedibili come il nome della piattaforma, mesi o anni;
* non comparire negli archivi di password rubate.

Non servono maiuscole, numeri o simboli obbligatori. Ogni regola ha un messaggio di errore in italiano.

## Durata più breve per un Ente

La durata è il flag `iam_password_expiry_days` (vedi [Limiti, MFA e manutenzione con GrowthBook](https://manuale.opencontent.it/manuali/manuale-operativo-interno/iam-console/limiti-mfa-e-manutenzione.md)). Il valore va da 90 a 365 giorni: un valore fuori intervallo viene riportato al limite più vicino. Il modo più semplice per impostarlo è il **Tenant Manager**, nell'ambiente giusto (QA o produzione).

{% stepper %}
{% step %}

## Trova il tenant della console

Nel Tenant Manager cerca il tenant **iam-console** dell'Ente.
{% endstep %}

{% step %}

## Imposta il valore

Apri il tab **Feature flag**, imposta `iam_password_expiry_days` con il numero di giorni e salva.
{% endstep %}

{% step %}

## Attendi il giorno dopo

Il controllo giornaliero aggiorna gli operatori dell'Ente alla sua prossima esecuzione, la mattina.
{% endstep %}
{% endstepper %}

**Come si applica:**

* un operatore che lavora per più Enti ha la durata **più breve** fra i suoi Enti;
* un aumento vale subito;
* una riduzione vale subito per chi ha la password recente. Chi ha la password più vecchia ha comunque **20 giorni** di preavviso e riceve i tre promemoria; dal cambio password successivo vale la nuova durata;
* se la scadenza si sposta (l'Ente cambia durata, l'operatore esce da un Ente), i promemoria ripartono per la nuova data.

| Esempio                                          | Scadenza                       |
| ------------------------------------------------ | ------------------------------ |
| Ente da 365 a 180 giorni, password di un mese    | a 180 giorni dal cambio        |
| Ente da 365 a 180 giorni, password di 200 giorni | fra 20 giorni (220 dal cambio) |
| Ente da 180 a 365 giorni                         | a 365 giorni dal cambio        |
| Operatore in due Enti, a 180 e a 365 giorni      | a 180 giorni dal cambio        |

{% hint style="warning" %}
Il valore va impostato sul tenant della **console** dell'Ente. Se scrivi la regola a mano in GrowthBook, la condizione va su `tenant_id` di quel tenant, non su `customer_id`. Se l'Ente non ha una console attiva, o ne ha più di una, la durata non viene applicata e il controllo giornaliero segnala un errore.
{% endhint %}

## Il controllo giornaliero

Ogni mattina la IAM Console legge tutti gli operatori attivi da Authentik. Per ciascuno:

1. calcola la durata in base ai suoi Enti;
2. scrive su Authentik la durata e la data di scadenza (attributo `password_expiry` dell'utente);
3. manda il promemoria, se è il momento.

Le email le spedisce Authentik, sempre e solo all'indirizzo dell'operatore. Un giorno saltato non fa perdere il promemoria: arriva al giorno successivo, con la data giusta. Se il controllo non gira per qualche giorno, la scadenza resta comunque applicata da Authentik.

Per sicurezza il controllo si ferma senza mandare nulla se in un giorno i nuovi promemoria sono troppi (più di 20 e più del 10% degli operatori). Il caso atteso è il primo giorno di attivazione; lo sblocca lo sviluppo.

Il controllo non manda promemoria a chi entra con le credenziali del proprio Ente (accesso federato): per loro la password OpenCity non scade.

## Domande frequenti

**L'operatore non ha ricevuto il promemoria.** In Authentik apri l'utente e guarda l'attributo `password_expiry`: `expires_on` è il giorno di scadenza, `reminder` l'ultimo promemoria registrato (`threshold` sono i giorni, `sent_at` la data). Se `reminder` c'è, di norma l'email è partita: controlla indirizzo e spam. Non ricevere il promemoria non impedisce di entrare: alla scadenza vale il percorso via email.

**Resta sulla schermata di attesa e l'email non arriva.** L'indirizzo email dell'operatore è sbagliato o manca. L'amministratore dell'Ente lo corregge e manda un link di recupero dalla console.

**Il link nell'email della password scaduta non funziona.** Vale 30 minuti e una volta sola. L'operatore accede di nuovo e riceve un link nuovo.

**La password risultava già scaduta prima di questo rilascio.** Chi era scaduto con la regola precedente ha la password bloccata e non riceve l'email di cambio. Serve un link di recupero dalla console o da Authentik.

**Ha il secondo fattore ma ha perso il dispositivo.** Il recupero della password chiede anche il secondo fattore. L'amministratore dell'Ente lo disattiva dalla console, se l'operatore lavora solo per quell'Ente; altrimenti lo fa lo staff OpenCity.

**La durata impostata non viene applicata.** Controlla nel Tenant Manager che il valore sia sul tenant **iam-console** dell'Ente, nell'ambiente giusto, e attendi l'esecuzione del giorno dopo. Se non basta, chiedi allo sviluppo i log del controllo giornaliero (`account_maintenance_done`, `account_maintenance_customer_unresolved`).
