Vai al contenuto
code-to-code

Apro l'indice…

↑ ↓ per scegliere, Invio per aprire, Esc per chiudere

Login e sicurezza1. Chi sei, cosa puoi farep. 6

Chi sei, cosa puoi fare, esercizi spiegati

Cinque esempi, una domanda alla volta

  • 20 minuti di lettura

Cinque esempi, dal più semplice. Ognuno ha lo stesso ritmo:

  1. Prevedi: leggi la richiesta e scrivi su un foglio che codice risponde il server. Prima di aprire la risposta.
  2. In italiano: cosa succede, a parole.
  3. Passo per passo: le tre domande del server, una alla volta.
  4. Cosa portiamo a casa: la cosa da ricordare.

I primi quattro sono richieste all'app degli abbonati della Linea Menta. Gli abbonati sono tre:

UsernameNomeTessera
rosaRosa BelliniA-101
teoTeo GalbiatiA-205
ugoUgo PirolaA-307

Le richieste sono fatte con curl -i, che mostra anche la prima riga della risposta, quella con il codice: lo trovi nel capitolo Postman e curl.


A · Teo senza biglietto

Teo apre l'app sul telefono, ma non ha ancora fatto il login. L'app chiede lo stesso la sua tessera:

Terminale
curl -i http://127.0.0.1:8000/tessere/A-205
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
HTTP/1.1 401 Unauthorized
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 31
content-type: application/json

{"detail":"Manca il biglietto"}

401: il server non sa chi sei.

In italiano. Nella richiesta non c'è l'header Authorization: nessun biglietto. Per il server, chi chiede è uno sconosciuto. Si ferma alla prima domanda, e non guarda nemmeno se la tessera A-205 esiste.

E se il biglietto c'è, ma è inventato?

Terminale
curl -i http://127.0.0.1:8000/tessere/A-205 -H "Authorization: Bearer biglietto-inventato"
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
HTTP/1.1 401 Unauthorized
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 33
content-type: application/json

{"detail":"Biglietto non valido"}

Ancora 401, con un altro messaggio. Un biglietto che non vale, per il server, è come non averlo.

Passo per passo.

DomandaSenza bigliettoCon biglietto-inventato
1 · Chi sei?non lo so: manca il biglietto → 401non lo so: il biglietto non vale → 401
2 · La tessera c'è?non ci arrivanon ci arriva
3 · Puoi?non ci arrivanon ci arriva

Cosa portiamo a casa. 401 vuol dire «il problema è il biglietto»: manca, è falso, è scaduto. La cura è sempre la stessa: il login, e un biglietto nuovo.


B · Teo con il biglietto: la sua tessera, e quella di Rosa

Teo fa il login, con il suo username e la sua password:

Terminale
curl -s -X POST http://127.0.0.1:8000/login -H "Content-Type: application/json" -d '{"username": "teo", "password": "tram-delle-sette"}'
{"access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ0ZW8iLCJleHAiOjE3OTUxMTMxNDV9.g0nzbW3WcGE04zrl7xO7ZcWKI0nfrh0SFG4lJsSbYvA","token_type":"bearer"}

Quella stringa lunga in access_token è il biglietto di Teo. Com'è fatta dentro lo vedi nel capitolo Il biglietto: JWT; per ora ti basta sapere che è di Teo e che vale 30 minuti.

Per non incollarla a ogni richiesta, la mettiamo in una variabile del terminale, BIGLIETTO. Poi $BIGLIETTO la usa:

Terminale
BIGLIETTO=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi…     # incolla il biglietto intero, senza virgolette

Adesso Teo chiede due tessere: prima la sua, poi quella di Rosa.

Terminale
curl -i http://127.0.0.1:8000/tessere/A-205 -H "Authorization: Bearer $BIGLIETTO"
curl -i http://127.0.0.1:8000/tessere/A-101 -H "Authorization: Bearer $BIGLIETTO"
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
HTTP/1.1 200 OK
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 67
content-type: application/json

{"numero":"A-205","titolare":"teo","abbonamento":"mensile, zona 1"}
HTTP/1.1 403 Forbidden
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 38
content-type: application/json

{"detail":"Questa tessera non è tua"}

La sua: 200. Quella di Rosa: 403.

In italiano. Lo stesso biglietto, la stessa persona, due risposte diverse. Il server sa chi è, in tutte e due le richieste: è Teo. Cambia la tessera. La A-205 è sua: 200. La A-101 c'è, ma è di Rosa: 403.

Passo per passo.

DomandaGET /tessere/A-205GET /tessere/A-101
1 · Chi sei?Teo: il biglietto valeTeo: il biglietto vale
2 · La tessera c'è?sì, è di teosì, è di rosa
3 · Puoi?teo è teo: sì → 200teo non è rosa: no → 403

Cosa portiamo a casa. Il biglietto dice chi sei, non cosa puoi fare. Cosa puoi fare dipende da chi sei e da cosa chiedi.


C · La tessera che non c'è

Teo, sempre con il suo biglietto, sbaglia un numero e chiede la tessera A-999, che non esiste:

Terminale
curl -i http://127.0.0.1:8000/tessere/A-999 -H "Authorization: Bearer $BIGLIETTO"
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
HTTP/1.1 404 Not Found
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 32
content-type: application/json

{"detail":"Tessera non trovata"}

In italiano. Chi sei: Teo, il biglietto vale. La tessera c'è? No. Il server si ferma alla seconda domanda: 404. Alla terza, «puoi?», non arriva nemmeno: per sapere di chi è una tessera, la tessera deve esserci.

Adesso la stessa richiesta, ma senza biglietto:

Terminale
curl -i http://127.0.0.1:8000/tessere/A-999
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
HTTP/1.1 401 Unauthorized
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 31
content-type: application/json

{"detail":"Manca il biglietto"}

401, non 404. La prima domanda viene prima: a uno sconosciuto il server non dice se la tessera A-999 esiste.

Passo per passo.

DomandaA-999, con il bigliettoA-999, senza biglietto
1 · Chi sei?Teonon lo so → 401
2 · La tessera c'è?no → 404non ci arriva
3 · Puoi?non ci arrivanon ci arriva

Un 404 può arrivare anche da un'altra parte. Qui Teo sbaglia l'indirizzo, non il numero: tesere, con una esse sola.

Terminale
curl -i http://127.0.0.1:8000/tesere/A-205 -H "Authorization: Bearer $BIGLIETTO"
HTTP/1.1 404 Not Found
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 22
content-type: application/json

{"detail":"Not Found"}

Il codice è lo stesso, il messaggio no. Not Found, in inglese, lo scrive FastAPI da solo: nessuna rotta ha quell'indirizzo, e la tua funzione non è nemmeno partita. Tessera non trovata lo scrive la tua rotta: è partita, ha cercato, non ha trovato.

Cosa portiamo a casa. Davanti a un 404, leggi il detail. Se è Not Found, controlla l'indirizzo; se è il tuo messaggio, la cosa che cerchi non c'è.


D · Il login sbagliato

Ugo Pirola fa il login due volte. La prima sbaglia la password: scrive ponte-ciclo-24 invece di ponte-ciclo-42. La seconda scrive la password giusta, ma come username usa nome e cognome:

Terminale
curl -i -X POST http://127.0.0.1:8000/login -H "Content-Type: application/json" -d '{"username": "ugo", "password": "ponte-ciclo-24"}'
curl -i -X POST http://127.0.0.1:8000/login -H "Content-Type: application/json" -d '{"username": "ugo.pirola", "password": "ponte-ciclo-42"}'
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
HTTP/1.1 401 Unauthorized
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 42
content-type: application/json

{"detail":"Username o password sbagliati"}
HTTP/1.1 401 Unauthorized
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 42
content-type: application/json

{"detail":"Username o password sbagliati"}

Due risposte identiche, lettera per lettera.

In italiano. Il login fa una domanda sola: chi sei? Ugo non è riuscito a dimostrarlo, né la prima volta né la seconda: 401. E il server non dice quale pezzo era sbagliato.

Con lo username giusto e la password giusta, invece:

Terminale
curl -i -X POST http://127.0.0.1:8000/login -H "Content-Type: application/json" -d '{"username": "ugo", "password": "ponte-ciclo-42"}'
HTTP/1.1 200 OK
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 162
content-type: application/json

{"access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1Z28iLCJleHAiOjE3OTUxMTMxNDV9.foTkhKaQRirRW1EFeYH_Sp84noFC8zKx5bOSN_d_V7A","token_type":"bearer"}

Passo per passo. Al login la domanda è una sola, «chi sei?». Per rispondere, il server controlla due cose, e vuole un sì da tutte e due:

Il login di UgoLo username c'è?La password è la sua?Risposta
ugo, ponte-ciclo-24sìno401
ugo.pirola, ponte-ciclo-42nonon c'è niente con cui confrontarla401
ugo, ponte-ciclo-42sìsì200, e il biglietto

Come fa il server a controllare una password senza tenerla scritta da nessuna parte lo vedi nel capitolo Le password.

Cosa portiamo a casa. Al login, username o password sbagliati: 401, e lo stesso messaggio. Il server non aiuta chi prova a indovinare.


E · Le tre domande, in Python

Le tre domande si possono scrivere in Python, senza server e senza login: una funzione che riceve chi chiede e cosa chiede, e restituisce il codice. chi è None quando il biglietto manca o non vale: come si legge un biglietto lo vedi nel capitolo 6.

Questo lo puoi provare tu: salvalo in un file, tre_domande.py, e lancialo con python3 tre_domande.py.

Python
titolari = {"A-101": "rosa", "A-205": "teo", "A-307": "ugo"}


def codice_della_risposta(chi: str | None, numero: str) -> int:
    if chi is None:                    # 1. chi sei? Non lo so
        return 401
    titolare = titolari.get(numero)
    if titolare is None:               # 2. la tessera c'è? No
        return 404
    if titolare != chi:                # 3. puoi? Non è tua
        return 403
    return 200


print(codice_della_risposta("teo", "A-205"))
print(codice_della_risposta(None, "A-205"))
print(codice_della_risposta("teo", "A-101"))
print(codice_della_risposta("teo", "A-999"))
print(codice_della_risposta(None, "A-999"))
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
200
401
403
404
401

Il dizionario che la funzione consulta:

titolari = {"A-101": "rosa", "A-205": "teo", "A-307": "ugo"}titolaridict"A-101""rosa""A-205""teo""A-307""ugo"
I titolari delle tessere

In italiano. Tre if, uno per domanda, nell'ordine del disegno. Ogni return ferma la funzione: le domande dopo non si fanno. Se nessun if scatta, la risposta è 200.

Il disegno.

inizio codice_della_risposta(chi, numero) se chi is None sì: restituisci 401 titolare = titolari.get(numero) se titolare is None sì: restituisci 404 se titolare != chi sì: restituisci 403 restituisci 200codice_della_risposta(chi,numero)chi is Nonerestituisci 401titolare =titolari.get(numero)titolare is Nonerestituisci 404titolare != chirestituisci 403restituisci 200nosìnosìnosì
Le tre domande, in ordine

Passo per passo.

Chiamatachi is None?titolaretitolare != chi?Risultato
"teo", "A-205"no"teo"no200
None, "A-205"sì——401
"teo", "A-101"no"rosa"sì403
"teo", "A-999"noNone—404
None, "A-999"sì——401

E se l'ordine cambia? Proviamo a chiedere «puoi?» prima di «la tessera c'è?», leggendo la tessera con le quadre. Un file nuovo, ordine_sbagliato.py:

Python
titolari = {"A-101": "rosa", "A-205": "teo", "A-307": "ugo"}


def codice_della_risposta(chi: str | None, numero: str) -> int:
    if chi is None:
        return 401
    if titolari[numero] != chi:        # prima «puoi?»…
        return 403
    return 200


print(codice_della_risposta("teo", "A-101"))
print(codice_della_risposta("teo", "A-999"))
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
403
Traceback (most recent call last):
  …
    if titolari[numero] != chi:        # prima «puoi?»…
       ~~~~~~~~^^^^^^^^
KeyError: 'A-999'

Con A-101 va bene. Con A-999 la funzione esplode: per chiedere di chi è la tessera, la tessera deve esserci. In un'API, il client riceverebbe un 500.

E se la tessera si cerca per prima, prima ancora di chiedere chi sei? Un altro file, prima_il_404.py:

Python
titolari = {"A-101": "rosa", "A-205": "teo", "A-307": "ugo"}


def codice_della_risposta(chi: str | None, numero: str) -> int:
    titolare = titolari.get(numero)
    if titolare is None:               # prima «la tessera c'è?»…
        return 404
    if chi is None:                    # …poi «chi sei?»
        return 401
    if titolare != chi:
        return 403
    return 200


print(codice_della_risposta(None, "A-101"))
print(codice_della_risposta(None, "A-102"))
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
401
404

Nessun errore, e proprio per questo è pericoloso. Uno sconosciuto, senza biglietto, prova due numeri: 401 per A-101, 404 per A-102. Adesso sa che la A-101 esiste e la A-102 no. Provando tutti i numeri, avrebbe l'elenco delle tessere.

Cosa portiamo a casa. L'ordine non è un dettaglio: chi sei, la cosa c'è, puoi. Ogni domanda usa la risposta di quella prima.


Pronto? Nella palestra ti aspettano otto richieste al portale del personale della Linea Menta: per ognuna, il codice lo prevedi tu.