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.
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:
- Apri il file in
palestra/. In alto: la storia, cosa fai, come provi. - Al posto della riga
raise HTTPException(status_code=501, …)(o dipass) scrivi il codice. In commento, sopra, trovi cosa deve rispondere la rotta in ogni caso. pytest palestra/test_<nome>.py -v, oppure la provetta di VS Code.- 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):
| Username | Nome | Password |
|---|---|---|
lucia | Lucia Ferri | capotreno-M12 |
sergio | Sergio Colombo | macchinista-T28 |
ivo | Ivo Brambati | manutentore-B02 |
nadia | Nadia Russo | ronda-di-notte |
4 allenatori, poi il capopalestra
I test di una sfida sono verdi? Tocca il suo pallino: è battuta.
- 1Il login
POST /login, uno stesso 401★allenatore - 2Chi sonola rotta protetta, una riga★allenatore
- 3Il controllore
utente_corrente★★allenatore - 4Il mio turnouna rotta protetta con il 404★★allenatore
- 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.
{"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
Aiutino 2
Aiutino 3
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
utente_corrente, che c'è già. A te serve solo chiamarlo.Aiutino 2
Depends. La forma è nel commento sopra la rotta.Aiutino 3
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 salvatoCome provi: pytest palestra/test_controllore.py -v
Aiutino 1
raise HTTPException(status_code=401, …).Aiutino 2
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
utente ti serve utente.username.Aiutino 2
TURNI.get(...). Se è None, 404 con il messaggio giusto.Aiutino 3
?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
access_token: se provi a leggerlo, il programma si ferma. E un login sbagliato non deve cancellare il biglietto buono di prima.Aiutino 3
{"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.