Passa al contenuto principale

JC4.2 - Errori 401, 403 e 503: cosa vogliono dire

In una frase. Tre numeri dicono dove si è fermata una richiesta: all'ingresso (401), sul permesso (403) o davanti a un servizio spento (503).

Un errore con un numero sembra un guasto. Quasi sempre è una risposta precisa: dice chi ha fermato la richiesta e perché. Saper leggere questi tre numeri evita di chiamare l'assistenza quando basta rientrare o aspettare un minuto.

Numero Vuol dire Cosa fai
401 Il Gateway non sa chi sei: il lasciapassare manca o è scaduto Rientra con utente e password
403 Sei entrato, ma il tuo livello non basta per quella cosa Chiedi il livello a chi amministra
503 Il servizio che deve rispondere non è acceso o non è ancora pronto Aspetta un minuto e riprova

401: rientra. L'app ti riporta da sola alla pagina di accesso. Scrivi utente e password e riprendi.

La pagina di accesso: è qui che l'app ti riporta dopo un errore 401

La pagina di accesso: è qui che l'app ti riporta dopo un errore 401

403: è una questione di livello. Compare l'avviso Accesso negato. Non è un guasto e riprovare non serve: quella operazione chiede un livello più alto del tuo. Chi amministra può dartelo dalla pagina dei ruoli. I livelli sono in Cosa può fare ogni livello (libro «JB - Accesso e permessi», pagina «JB3.2 - Cosa può fare ogni livello»).

503: aspetta un minuto. Compare l'avviso Errore server 503. Il Gateway funziona, ma il servizio a cui è destinata la richiesta non è nell'elenco del Monitor servizi. Subito dopo un aggiornamento è normale: i servizi stanno ripartendo e si iscrivono uno alla volta. Se dopo qualche minuto l'errore c'è ancora, avvisa chi gestisce il server e di' quale pagina stavi aprendo: basta per capire quale servizio è fermo.

Nota. Il 401 e il 503 li decide il Gateway. Il 403 lo decide il servizio che riceve la richiesta, perché è lui che sa quale livello serve per ogni operazione.

Per chi sviluppa.
• Gli avvisi li mostra frontend/shell/src/shared/auth/error.interceptor.ts: 401 porta a /auth/login, 403 dà «Accesso negato», da 500 in su «Errore server» con il numero.
• 401 con un lasciapassare che sembra buono: controlla emittente, chiavi e SSO_CLIENT_AMMESSI (docs/devops/auth/AUTENTICAZIONE.md).
• 401 fra due servizi: la chiamata non porta il lasciapassare. Le regole sono in docs/devops/chiamate-fra-servizi.md.
• 502 al posto di 503: è fermo il Gateway, non un servizio.