Il badge del deposito
Un'indagine della Linea Menta, a cinque livelli
- 90–120 minuti di lavoro
Milano, una settimana dopo la notte della Chiave Rossa. Linea Menta.
Ernesto Pozzi, il capo deposito, ha preso una decisione: i badge di plastica, quelli che si prestano e si copiano, vanno nel cestino. Da lunedì le porte di Vecchia Fiera (il cancello, l'officina, la sala-comandi) si aprono solo con un biglietto del nuovo portale del personale.
«Il portale lo costruisce lei», dice a chi sta leggendo. «Le persone si registrano, fanno il login, e la porta guarda il biglietto. Poi il commissario Mapelli vorrà vedere se regge.»
Mapelli ha già pronto un test. Le telecamere della stazione hanno registrato, una notte, una serie di tentativi: qualcuno ha provato ad aprire la sala comandi. Il commissario li rifarà contro il portale, uno per uno, e guarderà il registro.
Gli esercizi da scaricare
Una cartella con i file da completare e i test già pronti. Come si usa: la guida in cinque passi.
Lo zip è lo stesso della palestra: la storia è nella cartella storia/.
La mappa
la sala comandi è l'ultima porta, in fondo alla stazione
┌─────────────┐ ┌─────────────┐ ┌──────────────────┐
│ cancello │ ───▶ │ officina │ ───▶ │ sala-comandi │
└─────────────┘ └─────────────┘ └──────────────────┘
▲ ▲ ▲
└─────────── ogni porta guarda il biglietto─┘
(e scrive nel registro)
Porta Codice ── Via Variabile ── Largo Lista ── Ponte Ciclo ── Piazza Query
╲ ╱
Vecchia FieraI file
| File | Cosa c'è | Si tocca? |
|---|---|---|
main.py | L'API delle porte: gli stampi, il dizionario utenti, le PORTE, il registro, e i cinque livelli da scrivere | Sì, solo questo |
sicurezza.py | Gli attrezzi della sicurezza: calcola_hash, password_giusta, crea_biglietto, leggi_biglietto, controllore | No, si legge |
dati.py | Il personale (con password di prova, finte), la chiave vecchia, i tentativi della notte | No, si legge |
notte.py | La notte di prova: rifà i tentativi contro la tua API e stampa le risposte | No, si lancia |
test_main.py | I test, livello per livello. Usano personale di prova, non quello della notte: nessun test ti dice la soluzione | No |
verifica.py | Il commissario controlla il nome che gli dai | No |
Il registro è una lista di dizionari, uno per ogni porta aperta:
{"porta": "cancello", "username": "nadia"}Come si gioca
Un livello alla volta, sempre così:
- Leggi la consegna del livello e la cosa nuova.
- In
main.py, al posto della riga del 501, scrivi il codice. pytest storia -v -k livello_1(poilivello_2, …) finché è verde.- Quando hai finito i cinque livelli:
python storia/notte.py. Se un livello risponde ancora 501, la notte si ferma e ti dice quale.
Livello 1 · La registrazione
«Prima di tutto, le persone devono esserci.»
POST /personale: riceve username, nome e password; salva la persona nel dizionario utenti e risponde 201 con username e nome. Se lo username c'è già: 409, Username già preso.
La cosa nuova: niente. È la registrazione del capitolo sulle password: nel dizionario va l'impronta, mai la password, e la risposta non la mostra.
Aiutino 1
-> Utente, è lo stampo che toglie l'impronta. Quello che salvi, invece, è un UtenteSalvato.Aiutino 2
calcola_hash(dati.password). Prima del salvataggio, controlla che lo username non ci sia già: in utenti.Livello 2 · Il login
«Adesso devono poter entrare.»
POST /login: riceve username e password. Se sono giusti: 200 e il biglietto. Altrimenti 401, Username o password sbagliati, lo stesso messaggio per lo username che non c'è e per la password sbagliata.
La cosa nuova: crea_biglietto(utente.username) e il biglietto di risposta. È il login della teoria, l'esercizio 1 della palestra.
Aiutino 1
if per due guai: utente is None or not password_giusta(...). L'utente si cerca con utenti.get(...), non con le quadre.Aiutino 2
Biglietto(access_token=…, token_type="bearer"). Nel biglietto va lo username: è con quello che il controllore ritroverà l'utente.Livello 3 · Il controllore
«Una porta deve sapere chi si presenta.»
utente_corrente e GET /me. Senza header: 401, Manca il biglietto. Con un biglietto che non vale, o di una persona che non c'è più: 401, Biglietto non valido. Altrimenti /me risponde con username e nome di chi ha il biglietto.
La cosa nuova: il controllore e Depends. Sono gli esercizi 2 e 3 della palestra, insieme.
Aiutino 1
Aiutino 2
header.credentials è il biglietto, ma header può essere None. leggi_biglietto dà lo username o None; utenti.get(username) accetta anche None.Aiutino 3
/me è una riga: il parametro utente: UtenteSalvato = Depends(utente_corrente) e il return utente.Livello 4 · Aprire una porta
«Ora la porta vera.»
POST /porte/{porta}/apri: una rotta protetta. Con un biglietto buono e una porta che c'è (una di PORTE): 200, con la porta e il nome di chi l'ha aperta (aperta_da); in più, una riga nel registro, con la porta e lo username. Con un biglietto buono ma una porta che non c'è: 404, Porta non trovata. Senza biglietto: 401, prima di tutto.
La cosa nuova: chi apre lo dice il biglietto. La richiesta non ha un corpo, e se ne avesse uno non conterebbe: lo username va preso da utente, mai da fuori. E l'ordine delle domande: prima «chi sei?» (401), poi «la porta c'è?» (404).
Aiutino 1
/me: un parametro utente: UtenteSalvato = Depends(utente_corrente). Il 401 lo manda il controllore, prima che la funzione parta.Aiutino 2
porta not in PORTE), poi la riga nel registro con registro.append(...), poi la risposta con Apertura(...).Livello 5 · Il registro
«E chi vuole sapere chi è passato?»
GET /registro: una rotta protetta che restituisce il registro. Con ?porta=sala-comandi restituisce solo le righe di quella porta. Con una porta che non c'è: 404, Porta non trovata.
La cosa nuova: un parametro di query opzionale, porta, accanto al controllore. Si guarda se c'è: se c'è, si filtra.
Aiutino 1
porta: str | None = Query(default=None) è già nel commento. Se vale None, nessun filtro: restituisci tutto il registro.Aiutino 2
riga["porta"] == porta. Prima, il 404 se la porta non esiste.La notte di prova
Hai finito i cinque livelli? Il commissario Mapelli rifà i tentativi delle telecamere:
python storia/notte.pyLa notte registra il personale (da dati.py) nella tua API, poi prova, nell'ordine in cui le telecamere li hanno visti: un login sbagliato, un login giusto con la porta aperta, e quattro tentativi alla sala comandi, ognuno con un biglietto diverso (e un corpo di richiesta che non dice la verità). In fondo stampa il registro della sala comandi.
Se un livello risponde ancora 501, la notte si ferma e te lo dice: per esempio, con il livello 1 da fare, python storia/notte.py scrive
Il personale si registra.
Fermo: POST /personale risponde ancora 501. Finisci il livello 1: pytest storia -v -k livello_1Il finale
Guarda il registro che la notte ti stampa, e leggi con calma le risposte dei tentativi: ognuno è un 401 che ha un perché. Poi rispondi alla domanda di Mapelli:
«Chi è entrato davvero nella sala comandi?»
Quando hai un nome:
python storia/verifica.py "Nome Cognome"Se è sbagliato, per le piste più probabili il commissario ti dice dove hai preso la strada sbagliata.