Vai al contenuto
code-to-code

Apro l'indice…

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

Login e sicurezza6. Login e rotte protettep. 158

Login e rotte protette, la palestra

Cinque esercizi da scaricare, con i test

  • 90–120 minuti di lavoro

Cinque esercizi, dal ★ al ★★★, nel portale del personale della Linea Menta. Il portale ha i suoi utenti, ma le porte sono ancora aperte a tutti, o chiuse a tutti: tocca a te mettere il login e il controllore, e poi usarli. In ogni esercizio hai già pronto quasi tutto: scrivi una cosa sola.

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

Nello stesso zip c'è anche la storia del capitolo, Il badge del deposito: la trovi nella pagina dopo.

Prima di iniziare

Scompatta lo zip e segui il README.md che c'è dentro: venv, pip install, la chiave segreta nel file .env, code .. Il .env serve solo per accendere il server e provare dal vivo: i test usano una chiave loro, e funzionano anche senza.

Ogni esercizio, sempre gli stessi quattro passi:

  1. Apri il file in palestra/. In alto: la storia, cosa fai, come provi.
  2. Al posto della riga raise HTTPException(status_code=501, …) (o di pass) scrivi il codice. In commento, sopra, trovi cosa deve rispondere la rotta in ogni caso.
  3. pytest palestra/test_<nome>.py -v, oppure la provetta di VS Code.
  4. Rosso? Leggi l'ultima riga del messaggio: dice cosa fare. Bloccato da 15 minuti? Apri il primo aiutino, non la soluzione.

Gli utenti di prova (password finte, solo per provare):

UsernameNomePassword
luciaLucia Ferricapotreno-M12
sergioSergio Colombomacchinista-T28
ivoIvo Brambatimanutentore-B02
nadiaNadia Russoronda-di-notte

4 allenatori, poi il capopalestra

I test di una sfida sono verdi? Tocca il suo pallino: è battuta.

  1. 1Il loginPOST /login, uno stesso 401★allenatore
  2. 2Chi sonola rotta protetta, una riga★allenatore
  3. 3Il controlloreutente_corrente★★allenatore
  4. 4Il mio turnouna rotta protetta con il 404★★allenatore
  5. 5Postman, in Pythonil biglietto che viaggia★★★capopalestra

La medaglia · Login e rotte protette

0 su 5: si accende quando le hai battute tutte.


1 · Il login ★

palestra/login.py

Il portale ha i suoi utenti, ma nessuno riesce a entrare: POST /login risponde 501. Lucia Ferri, capotreno, prova con la sua password. Chi sbaglia, username o password, prende lo stesso 401.

JSON
{"username": "lucia", "password": "capotreno-M12"}
200  →  il biglietto (access_token e token_type)
401  →  "Username o password sbagliati"      (password sbagliata, oppure username che non c'è)

Come provi: pytest palestra/test_login.py -v

Aiutino 1
Le cose da fare sono tre, in quest'ordine: cercare l'utente nel dizionario, controllare la password, stampare il biglietto. Nel commento sopra la rotta ci sono le tre righe utili.
Aiutino 2
Per cercare un utente che potrebbe non esserci: quale lettura non si ferma se la chiave manca? Lo hai visto nel capitolo sui dizionari.
Aiutino 3
Un solo if per due guai: utente is None or not password_giusta(...). Il secondo pezzo si valuta solo se l'utente c'è.

2 · Chi sono ★

palestra/chi_sono.py

Il controllore del portale è pronto, ma nessuna porta lo usa: GET /me risponde 501 a tutti. Ivo Brambati, manutentore, vuole vedere chi è per il portale. Senza biglietto, o con uno falso: 401.

GET /me   con il biglietto di Ivo      →  200  {"username": "ivo", "nome": "Ivo Brambati"}
GET /me   senza biglietto              →  401  "Manca il biglietto"
GET /me   con un biglietto falso       →  401  "Biglietto non valido"

Come provi: pytest palestra/test_chi_sono.py -v

Aiutino 1
Il 401 non lo scrivi tu: lo manda utente_corrente, che c'è già. A te serve solo chiamarlo.
Aiutino 2
Si chiama con un parametro nella funzione della rotta, con Depends. La forma è nel commento sopra la rotta.
Aiutino 3
Quando il parametro c'è, utente è già l'utente vero: basta restituirlo. La freccia -> Utente toglie l'impronta da sola.

3 · Il controllore ★★

palestra/controllore.py

Al portale manca proprio il controllore: GET /me c'è già, ma utente_corrente risponde 501 a tutti. Scrivilo tu: dall'header al biglietto, dal biglietto all'utente, e un 401 per ogni modo di non andare bene.

nessun header Authorization (o non è un Bearer)  →  401  "Manca il biglietto"
biglietto disegnato a mano, scaduto, firmato con un'altra chiave, cambiato a mano
oppure biglietto buono ma l'utente non c'è più   →  401  "Biglietto non valido"
tutto a posto                                    →  l'utente salvato

Come provi: pytest palestra/test_controllore.py -v

Aiutino 1
Tre domande, nell'ordine: c'è un header? Il biglietto vale? L'utente esiste ancora? Ognuna, se la risposta è «no», è un raise HTTPException(status_code=401, …).
Aiutino 2
Il biglietto è header.credentials. Ma header può essere None: la prima domanda va fatta prima di scrivere header.credentials.
Aiutino 3
leggi_biglietto dà lo username, oppure None. Con utenti.get(username) anche None va bene: dà None e basta. Così le ultime due domande si possono fare con un if solo.

4 · Il mio turno ★★

palestra/turno.py

Sergio Colombo, macchinista, vuole sapere a che ora attacca. Il portale ha i turni (TURNI, nel file), ma la rotta non c'è. Ogni persona vede solo il suo turno: lo dice il biglietto. Nadia, di ronda, non ha un turno in elenco: per lei 404.

GET /turni/mio   con il biglietto di Sergio  →  200  {"username": "sergio", "turno": "T28, 14:00-22:00"}
GET /turni/mio   con il biglietto di Nadia   →  404  "Turno non trovato"
GET /turni/mio   senza biglietto             →  401  "Manca il biglietto"

Come provi: pytest palestra/test_turno.py -v

Aiutino 1
Il controllore è già scritto: la rotta lo usa con la stessa riga dell'esercizio 2. Da utente ti serve utente.username.
Aiutino 2
Il turno di una persona che potrebbe non averlo: TURNI.get(...). Se è None, 404 con il messaggio giusto.
Aiutino 3
L'ultimo test manda anche ?username=lucia con il biglietto di Sergio. Non c'è niente da fare: se la rotta non ha un parametro username, FastAPI ignora quella parte. Il test controlla che tu non ne abbia aggiunto uno.

5 · Postman, in Python ★★★

palestra/postman.py

Marta Villa, capostazione di Piazza Query, prova il portale da Postman. Fa il login, e uno script salva il biglietto in una variabile; poi ogni richiesta lo manda con Bearer. Qui rifai lo stesso giro in Python: una piccola Collezione, con le sue variabili. L'API è già scritta; scrivi i due metodi.

login(username, password)   →  fa POST /login, restituisce il codice della risposta;
                               se è 200, salva il biglietto in variabili["biglietto"]
chiedi(percorso)            →  fa GET sul percorso; se il biglietto c'è, lo manda in
                               «Authorization: Bearer <biglietto>»

Lo script di Postman, tradotto: pm.collectionVariables.set("biglietto", pm.response.json().access_token) diventa self.variabili["biglietto"] = risposta.json()["access_token"].

Come provi: pytest palestra/test_postman.py -v

Aiutino 1
self.client.post("/login", json={...}) e self.client.get(percorso, headers={...}) ti danno una risposta: ha .status_code e .json(). Il login restituisce solo il codice; chiedi restituisce tutta la risposta.
Aiutino 2
Il biglietto si salva solo se il login è andato bene. Una risposta 401 non ha access_token: se provi a leggerlo, il programma si ferma. E un login sbagliato non deve cancellare il biglietto buono di prima.
Aiutino 3
L'header è {"Authorization": f"Bearer {...}"}: la parola, uno spazio, il biglietto. Se la variabile non c'è, niente header: lo vuole il primo test.

Finiti i cinque? C'è la storia: un portale intero da costruire, un livello alla volta, e una domanda del commissario Mapelli alla fine. Se ti serve il motivo di un rosso, c'è Se qualcosa va storto.