Vai al contenuto
code-to-code

Apro l'indice…

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

Login e sicurezza6. Login e rotte protettep. 162

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.

login-rotte-protette.zip35 KB

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 Fiera

I file

FileCosa c'èSi tocca?
main.pyL'API delle porte: gli stampi, il dizionario utenti, le PORTE, il registro, e i cinque livelli da scrivereSì, solo questo
sicurezza.pyGli attrezzi della sicurezza: calcola_hash, password_giusta, crea_biglietto, leggi_biglietto, controlloreNo, si legge
dati.pyIl personale (con password di prova, finte), la chiave vecchia, i tentativi della notteNo, si legge
notte.pyLa notte di prova: rifà i tentativi contro la tua API e stampa le risposteNo, si lancia
test_main.pyI test, livello per livello. Usano personale di prova, non quello della notte: nessun test ti dice la soluzioneNo
verifica.pyIl commissario controlla il nome che gli daiNo

Il registro è una lista di dizionari, uno per ogni porta aperta:

Python
{"porta": "cancello", "username": "nadia"}

Come si gioca

Un livello alla volta, sempre così:

  1. Leggi la consegna del livello e la cosa nuova.
  2. In main.py, al posto della riga del 501, scrivi il codice.
  3. pytest storia -v -k livello_1 (poi livello_2, …) finché è verde.
  4. 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
La freccia della funzione, -> Utente, è lo stampo che toglie l'impronta. Quello che salvi, invece, è un UtenteSalvato.
Aiutino 2
L'impronta si fa con 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
Un solo if per due guai: utente is None or not password_giusta(...). L'utente si cerca con utenti.get(...), non con le quadre.
Aiutino 2
La risposta è 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
Tre domande, nell'ordine: c'è un header? Il biglietto vale? La persona esiste ancora? Per ognuna, se la risposta è no, 401.
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
La protezione è la stessa riga di /me: un parametro utente: UtenteSalvato = Depends(utente_corrente). Il 401 lo manda il controllore, prima che la funzione parta.
Aiutino 2
Dentro la funzione, prima il 404 (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
Per filtrare, il setaccio del capitolo sulle liste: una lista di righe, tenendo quelle con 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:

Terminale
python storia/notte.py

La 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_1

Il 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:

Terminale
python storia/verifica.py "Nome Cognome"

Se è sbagliato, per le piste più probabili il commissario ti dice dove hai preso la strada sbagliata.