> 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/diagnosi-dei-problemi-frequenti.md).

# Diagnosi dei problemi frequenti

Sintomi frequenti, cause e cosa controllare nei log della IAM Console.

Per ogni problema trovi la causa più probabile e cosa controllare. Gli eventi tra parentesi sono i nomi che cerchi nei log della console (vedi [Monitoraggio e log](https://manuale.opencontent.it/manuali/manuale-operativo-interno/iam-console/monitoraggio-e-log.md)).

## Accesso alla console

| Sintomo                                                 | Causa probabile                                                                            | Cosa fare                                          |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------ | -------------------------------------------------- |
| La persona non riesce a entrare nella console dell'Ente | Non ha nessun ruolo della console: l'accesso lo danno solo i ruoli                         | Assegnale un ruolo dalla scheda **Ruoli**          |
| Entra ma non vede nessun operatore                      | Ha solo ruoli che non includono la consultazione, per esempio **Consultazione eventi**     | Assegnale **Consultazione** o un ruolo di gestione |
| Un membro dello staff non vede più tutti gli Enti       | Non è più nel gruppo `OC CVM`, oppure il gruppo è stato rinominato (`staff_group_missing`) | Controlla il gruppo in Authentik                   |

## Operatori e inviti

| Sintomo                                                               | Causa probabile                                                                                                                      | Cosa fare                                                                                      |
| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| "Limite di operatori raggiunto"                                       | L'Ente ha raggiunto `iam_max_operators`; contano anche gli inviti in attesa                                                          | Revoca gli inviti inutili o alza il limite in GrowthBook                                       |
| La persona aggiunta non ha ricevuto l'email per impostare la password | Email in spam o invio non riuscito (`notification_failed`)                                                                           | Dal dettaglio dell'operatore usa **Copia link recupero password** e manda il link alla persona |
| Il link per impostare la password non funziona più                    | Il link vale 24 ore e una volta sola; generarne uno nuovo invalida il precedente                                                     | Genera un link nuovo dal dettaglio dell'operatore e manda solo quello                          |
| Dopo "Aggiungi" compare **Creazione parziale**                        | L'account è stato creato ma il link per la password non è stato generato (`recovery_link_failed`)                                    | Usa **Copia link set-password** accanto alla riga e manda il link alla persona                 |
| "Copia link recupero password" non compare                            | Serve il ruolo **Link di recupero**; il link si genera solo per chi lavora soltanto per questo Ente e ha un livello inferiore al tuo | Se la persona lavora anche per altri Enti, il link lo genera lo staff da Authentik             |
| L'invito non arriva o è scaduto                                       | Riguarda solo inviti creati in passato o dalle API v1: la console non ne crea più                                                    | Rinnova l'invito dalla console, oppure revocalo e usa **Aggiungi**                             |
| "Impossibile revocare l'invito: un servizio non è raggiungibile"      | Authentik o il Tenant Manager non hanno risposto (`invitation_revoke_failed`)                                                        | Riprova: l'invito non è stato revocato                                                         |
| La persona si è registrata ma non è nel gruppo funzionale previsto    | L'iscrizione in attesa era di un invito scaduto o di un altro Ente (`enrollment_pending_group_skipped`, campo `reason`)              | Aggiungila al gruppo dalla console                                                             |

## Secondo fattore (MFA)

| Sintomo                                               | Causa probabile                                                                    | Cosa fare                    |
| ----------------------------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------- |
| Non si può attivare l'MFA                             | Limite `iam_max_mfa_operators` raggiunto (default 0)                               | Alza il limite in GrowthBook |
| Non si può disattivare l'MFA di un membro dello staff | Per lo staff è obbligatorio                                                        | Nessuna azione: è voluto     |
| Non si può disattivare l'MFA di un operatore          | L'operatore lavora anche per altri Enti: l'MFA è dell'account e varrebbe per tutti | Coinvolgi lo staff OpenCity  |

## Funzionamento della console

| Sintomo                                          | Causa probabile                                                                                 | Cosa fare                                                                                                   |
| ------------------------------------------------ | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| La manutenzione non si attiva o non si disattiva | Non è passato un minuto, oppure GrowthBook non è raggiungibile (`growthbook_unavailable`)       | Attendi e controlla `maintenance_on` / `maintenance_off`                                                    |
| La pagina Operatori è lenta                      | Le chiamate verso Authentik sono lente                                                          | Cerca `users_page_slow`: riporta i tempi di ogni fase                                                       |
| Accessi diversi tra Authentik e i permessi       | Riallineamento non ancora fatto o tenant saltato (`iam_member_reconcile_done`, campo `skipped`) | La console si riallinea ogni ora; i tenant saltati sono la console, quelli non attivi e quelli senza gruppo |
