Vai al contenuto
code-to-code

Apro l'indice…

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

Login e sicurezza5. Il biglietto: JWTp. 127

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.

login-jwt.zip12 KB

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:

  1. Apri il file in palestra/. In alto: la storia, cosa fai, come provi.
  2. Al posto di pass scrivi il codice. La docstring ha gli esempi di cosa deve uscire.
  3. pytest palestra/test_<nome>.py -v, oppure la provetta di VS Code.
  4. 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.

  1. 1Il biglietto nella giaccasplit, jwt.decode senza controllare★allenatore
  2. 2La macchinetta dei bigliettijwt.encode, timedelta, timezone.utc★★allenatore
  3. 3La lettera cambiatajwt.decode, try, InvalidTokenError★★allenatore
  4. 4La chiave del portaleos.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.

Python
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 punti

Il 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
È l'esempio B degli esercizi spiegati. jwt.decode con options={"verify_signature": False} apre il payload senza chiave.
Aiutino 2
I pezzi si contano: split(".") e poi len(pezzi), che deve essere 3. Altrimenti raise ValueError(…), con il messaggio che c'è nella docstring.
Aiutino 3
Il controllo va prima di 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 payloadCosa
sublo username, così com'è
expadesso, in UTC, più minuti minuti
Python
crea_biglietto("lucia")              # un biglietto da 30 minuti
crea_biglietto("ernesto", minuti=5)  # un biglietto da 5 minuti

I 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
È l'esempio D degli esercizi spiegati: la scadenza è datetime.now(timezone.utc) + timedelta(minutes=minuti).
Aiutino 2
Due righe: un dizionario dati con "sub" ed "exp", poi return jwt.encode(dati, SECRET_KEY, algorithm=ALGORITMO). Il risultato è già una stringa.
Aiutino 3
Un test rosso dice che 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 bigliettoIl risultato
buono, di Marta"marta"
scaduto da un minutoNone
firmato con un'altra chiaveNone
con il payload di Lucia e la firma di MartaNone
"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
È l'esempio C degli esercizi spiegati, quasi identico: 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
Un solo except basta, se prende la famiglia: jwt.InvalidTokenError. Se ne scegli uno più piccolo, qualche biglietto cattivo fa esplodere la funzione.
Aiutino 4
Il risultato giusto è 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'ambienteCosa fa
non c'è SECRET_KEYRuntimeError che comincia con Manca SECRET_KEY
c'è, ma vuotalo stesso errore: vuota è come mancante
meno di 32 caratteriRuntimeError 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
È l'esempio E degli esercizi spiegati: un if not chiave per «manca», un if len(chiave) < … per «corta».
Aiutino 2
L'ordine conta. Prima «manca», poi «corta»: len(None) non esiste, e farebbe uscire un altro errore.
Aiutino 3
Al posto delle quadre, os.environ.get("SECRET_KEY"): con le quadre una chiave che manca diventa un KeyError, non il tuo messaggio.
Aiutino 4
«Almeno 32» vuol dire che 32 bastano: < e non <=. Un test lo controlla.
Aiutino 5
Leggi la chiave dentro la funzione, non in cima al file: i test cambiano l'ambiente a ogni chiamata, e una lettura fatta una volta sola non se ne accorge.

Finito? Confronta le tue con le soluzioni: per ogni esercizio ci sono il ragionamento, il codice e le trappole più comuni.