Il biglietto, JWT, la palestra
Quattro esercizi da scaricare, con i test
- 60–90 minuti di lavoro
Quattro esercizi, dal ★ al ★★★, nel portale del personale della Linea Menta. Il portale nuovo deve stampare i biglietti e riconoscerli, e ha una chiave per firmarli: la sistemi tu, una funzione alla volta.
Gli esercizi da scaricare
Una cartella con i file da completare e i test già pronti. Come si usa: la guida in cinque passi.
Prima di iniziare
Scompatta lo zip e segui il README.md che c'è dentro: venv, pip install -r requirements.txt, code ., e la chiave, cioè il file .env (il comando è nel README e nel capitolo). Se è la prima volta, la pagina Come si usa un esercizio lo fa con te, un comando alla volta.
Ogni esercizio, sempre gli stessi quattro passi:
- Apri il file in
palestra/. In alto: la storia, cosa fai, come provi. - Al posto di
passscrivi il codice. La docstring ha gli esempi di cosa deve uscire. pytest palestra/test_<nome>.py -v, oppure la provetta di VS Code.- Rosso? Leggi l'ultima riga del messaggio. Bloccato da 15 minuti? Apri il primo aiutino, non la soluzione.
I test non usano il tuo .env: conftest.py scrive una chiave per i test prima di tutto. Il tuo .env serve quando lanci un file a mano, per esempio python palestra/stampa_biglietto.py.
3 allenatori, poi il capopalestra
I test di una sfida sono verdi? Tocca il suo pallino: è battuta.
- 1Il biglietto nella giacca
split,jwt.decodesenza controllare★allenatore - 2La macchinetta dei biglietti
jwt.encode,timedelta,timezone.utc★★allenatore - 3La lettera cambiata
jwt.decode,try,InvalidTokenError★★allenatore - 4La chiave del portale
os.environ.get,RuntimeError★★★capopalestra
La medaglia · Il biglietto: JWT
0 su 4: si accende quando le hai battute tutte.
1 · Il biglietto nella giacca ★
palestra/tre_pezzi.py
Ivo Brambati, manutentore, trova nella giacca un biglietto del portale del personale. Di chi è? Fino a quando valeva? La chiave Ivo non ce l'ha, ma per leggerlo non serve. Scrivi leggi_senza_chiave: restituisce il payload come dizionario. Prima controlla che sia un biglietto (tre pezzi separati da due punti): se no, ValueError.
leggi_senza_chiave(BIGLIETTO_NELLA_GIACCA) # {"sub": "ivo", "exp": 1795040100}
leggi_senza_chiave("scontrino-del-bar") # ValueError: Non è un biglietto: servono tre pezzi separati da due puntiIl biglietto della giacca è già nel file. Anche uno scaduto, o firmato con un'altra chiave, si legge: è leggere, non controllare.
Come provi: pytest palestra/test_tre_pezzi.py -v. A mano: python palestra/tre_pezzi.py stampa anche la data di scadenza.
Aiutino 1
jwt.decode con options={"verify_signature": False} apre il payload senza chiave.Aiutino 2
split(".") e poi len(pezzi), che deve essere 3. Altrimenti raise ValueError(…), con il messaggio che c'è nella docstring.Aiutino 3
jwt.decode: con "scontrino-del-bar" la libreria alzerebbe un suo errore, non il tuo ValueError.2 · La macchinetta dei biglietti ★★
palestra/stampa_biglietto.py
Il portale deve stampare i biglietti: dentro, chi è e quando scade. Lucia Ferri, capotreno, ne vuole uno da 30 minuti. Ernesto Pozzi, per le prove in deposito, uno da 5. Scrivi crea_biglietto(username, minuti=30). Il blocco della chiave in cima al file è già scritto: usa SECRET_KEY e ALGORITMO.
| Nel payload | Cosa |
|---|---|
sub | lo username, così com'è |
exp | adesso, in UTC, più minuti minuti |
crea_biglietto("lucia") # un biglietto da 30 minuti
crea_biglietto("ernesto", minuti=5) # un biglietto da 5 minutiI test aprono il biglietto con la chiave dei test, e controllano sub ed exp con una tolleranza di 5 secondi. E guardano come stai facendo i conti: ogni test gira con l'ora di Milano, anche se il tuo computer è in UTC.
Come provi: pytest palestra/test_stampa_biglietto.py -v. A mano (serve il .env): python palestra/stampa_biglietto.py.
Aiutino 1
datetime.now(timezone.utc) + timedelta(minutes=minuti).Aiutino 2
dati con "sub" ed "exp", poi return jwt.encode(dati, SECRET_KEY, algorithm=ALGORITMO). Il risultato è già una stringa.Aiutino 3
exp è sbagliato di circa 3600 secondi, cioè un'ora? Guarda timezone.utc. Di circa 1770? Guarda minutes: sono 30 minuti, non 30 secondi.3 · La lettera cambiata ★★
palestra/controlla_biglietto.py
Marta Villa, capostazione di Piazza Query, prende il suo biglietto e cambia il payload: al posto di marta ci mette lucia. Il portale se ne deve accorgere. E anche dei biglietti scaduti, e di quelli firmati con un'altra chiave. Scrivi leggi_biglietto(biglietto): lo username se il biglietto vale, None in ogni altro caso. Nessun errore deve uscire dalla funzione.
| Il biglietto | Il risultato |
|---|---|
| buono, di Marta | "marta" |
| scaduto da un minuto | None |
| firmato con un'altra chiave | None |
| con il payload di Lucia e la firma di Marta | None |
"biglietto-disegnato-a-mano" | None |
I test fanno i biglietti cattivi da soli, con jwt.encode. Per provare a mano (serve il .env): python palestra/controlla_biglietto.py rifà il trucco di Marta.
Come provi: pytest palestra/test_controlla_biglietto.py -v
Aiutino 1
try, jwt.decode, except jwt.InvalidTokenError.Aiutino 2
jwt.decode(biglietto, SECRET_KEY, algorithms=[ALGORITMO]): la chiave e una lista di algoritmi. Se dimentichi algorithms, ogni biglietto sembra non valido, anche quello buono.Aiutino 3
except basta, se prende la famiglia: jwt.InvalidTokenError. Se ne scegli uno più piccolo, qualche biglietto cattivo fa esplodere la funzione.Aiutino 4
dati.get("sub"), fuori dal try: lo username, o None se nel payload non c'è.4 · La chiave del portale ★★★
palestra/chiave.py
Ernesto Pozzi installa il portale sul computer del deposito e nel file .env scrive SECRET_KEY=1234. «Tanto è segreta.» Con una chiave così i biglietti si falsificano in un attimo: il portale non deve partire, e deve dire perché. Scrivi leggi_chiave(), che prende la chiave dall'ambiente.
| Nell'ambiente | Cosa fa |
|---|---|
non c'è SECRET_KEY | RuntimeError che comincia con Manca SECRET_KEY |
| c'è, ma vuota | lo stesso errore: vuota è come mancante |
| meno di 32 caratteri | RuntimeError che dice SECRET_KEY è troppo corta |
| 32 caratteri o più | la chiave, così com'è |
I messaggi esatti sono nella docstring. load_dotenv() è già nel file, e LUNGHEZZA_MINIMA è già una costante. I test non leggono il tuo .env: cambiano l'ambiente da soli, solo per la durata di un test (monkeypatch).
Come provi: pytest palestra/test_chiave.py -v. A mano: python palestra/chiave.py conta i caratteri della tua chiave del .env, senza stamparla.
Aiutino 1
if not chiave per «manca», un if len(chiave) < … per «corta».Aiutino 2
len(None) non esiste, e farebbe uscire un altro errore.Aiutino 3
os.environ.get("SECRET_KEY"): con le quadre una chiave che manca diventa un KeyError, non il tuo messaggio.Aiutino 4
< e non <=. Un test lo controlla.Aiutino 5
Finito? Confronta le tue con le soluzioni: per ogni esercizio ci sono il ragionamento, il codice e le trappole più comuni.