Le password, se qualcosa va storto
Gli errori delle impronte, e quelli che non fanno rumore
Gli errori che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai.
Ricorda come si legge un traceback: dal basso. L'ultima riga dice cosa, la riga con i ^^^ dice quale pezzo, la riga File … line … dice dove. Tutto il resto è nel capitolo Leggere un traceback.
Questo capitolo ha due tipi di guai. Quelli con il traceback, qui sotto, sono i più semplici: ti dicono dove. Quelli senza, dopo la tabella, sono quelli che contano: con le password, un programma che «funziona» può essere il più pericoloso.
Gli errori con il traceback
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
pwdlib.exceptions.UnknownHashError: This hash can't be identified… | A password_giusta è arrivato come «impronta» qualcosa che non lo è. Due cause: gli argomenti sono invertiti, oppure nel dizionario c'è la password in chiaro (o un sha256) al posto dell'impronta | Prima la password, poi l'impronta: password_giusta(password, impronta). Poi stampa utenti: un'impronta vera comincia con $argon2id$ |
ModuleNotFoundError: No module named 'pwdlib' | Python non trova pwdlib: il venv è spento, o è di un altro esercizio, o il pip install non è finito | source .venv/bin/activate, dalla cartella dello zip, poi pip install -r requirements.txt. Più in generale: pytest e il venv |
pwdlib.exceptions.HasherNotAvailable: The argon2 hash algorithm is not available… | pwdlib c'è, ma senza argon2: è stato installato senza le quadre | pip install -r requirements.txt: nel file c'è già pwdlib[argon2] |
zsh: no matches found: pwdlib[argon2] | Hai scritto il pip install a mano sul Mac: zsh legge le quadre come un modello di nomi di file | Le virgolette: pip install "pwdlib[argon2]". Oppure, meglio, pip install -r requirements.txt |
KeyError: 'mapelli' | Hai letto con le quadre uno username che non c'è nel dizionario | utenti.get(username), poi if utente is None:. Chi scrive uno username sbagliato non deve piantare il terminale: è una password sbagliata come le altre |
AttributeError: 'NoneType' object has no attribute 'password_hash' | get ha risposto None, e sei andato avanti come se avesse trovato l'utente | Subito dopo il get: if utente is None: e decidi cosa fare (nel controllo, False) |
pydantic_core._pydantic_core.ValidationError: … password_hash Field required | Stai costruendo un UtenteSalvato senza l'impronta, di solito con **dati.model_dump(): il corpo ha la password, ma non l'impronta | Scrivi i campi uno per uno: username=…, nome=…, password_hash=calcola_hash(dati.password) |
RuntimeError: dictionary changed size during iteration | Aggiungi o togli chiavi dal dizionario che stai scorrendo. Nel trasloco: nuovo = vecchio | Un dizionario nuovo: nuovo = {} |
assert 501 == 201 | C'è ancora la riga «da fare» | Al posto del raise HTTPException(status_code=501, …), il tuo codice |
assert 422 == 201 (o l'altro codice che ti aspettavi) | FastAPI ha rifiutato il corpo prima di entrare nella funzione. Con le password, di solito è una password di meno di 8 caratteri | Leggi il detail della risposta: loc dice dove (body, password), msg dice cosa (String should have at least 8 characters) |
assert None == … o assert None is True | La funzione non restituisce niente: c'è ancora pass, manca il return, o c'è un print al posto del return. Oppure un ramo dell'if finisce senza return | return alla fine di ogni strada della funzione |
Gli errori che non danno errori
I più difficili non hanno traceback: il programma gira, la risposta è 201, e c'è qualcosa che non va. Con le password sono questi.
L'impronta che esce. La rotta dichiara -> UtenteSalvato invece di -> Utente. Tutto funziona, e nella risposta c'è anche password_hash. Il test della palestra lo prende, e ti mostra l'impronta proprio dentro il messaggio:
E AssertionError: La risposta è un Utente: username e nome. Mai la password, mai l'impronta: guarda la freccia del def
E assert {'username': ...d4YVmw9eSahc'} == {'username': ...ommaso Greco'}
E Omitting 2 identical items, use -vv to show
E Left contains 1 more item:
E {'password_hash': '$argon2id$v=19$m=65536,t=3,p=4$yJjdPegXcEY4LxwFDzfwqA$fdzHhxKhBL6bvAVbcnvqVLnzH7dH4iXd4YVmw9eSahc'}«Left contains 1 more item»: nella risposta c'è un campo in più. Per cercarlo da solo: guarda il corpo della risposta (curl, o Execute in /docs) e conta i campi.
La password in chiaro nel dizionario. password_hash=dati.password: il nome del campo promette un'impronta, ma dentro c'è la password. La risposta è giusta, il 201 pure. Si scopre solo guardando il dizionario: print(utenti) (e poi si toglie), oppure con un test. Un'impronta vera comincia con $argon2id$; se leggi la password, hai trovato la trappola. Più avanti, quando metterai alla prova password_giusta, ti darà UnknownHashError: è il primo rumore che il bug fa, e arriva lontano da dove è nato.
L'utente sostituito. Un POST /utenti senza la domanda «lo username c'è già?»: chi si iscrive per secondo con lucia prende il posto della vera Lucia, con la sua password. Risposta: 201. Per accorgertene serve un test che prima iscrive Lucia, poi riprova, e controlla che la seconda volta la risposta sia 409.
Una password che «va bene» per tutti. Un trasloco che mette nel dizionario nuovo anche chi ha la password vuota: l'impronta della password vuota esiste, e password_giusta("", impronta) dà True. Chi non ha scelto una password entra con una password vuota.
La password nei posti sbagliati. Un print(dati) lasciato nella rotta, un registro che stampa il corpo della richiesta, una password in un messaggio d'errore: l'impronta in un dizionario è al sicuro, la password in chiaro in un file di testo no. Nell'esempio D degli esercizi spiegati il print è dichiarato provvisorio proprio per questo. Se una password vera è già finita da qualche parte, la si cambia: non basta cancellare la riga.
Un test lento non è un test rotto
I test di questo capitolo impiegano qualche decimo di secondo l'uno, invece dei millisecondi a cui sei abituato. Non è un guasto: argon2 è lento apposta. Ogni calcola_hash costa circa due centesimi di secondo, e ogni test ne fa un po'. Se invece un test ci mette secondi interi, guarda se hai un calcola_hash dentro un for dentro un altro for: è il segnale per pensarci.
Se il problema non è il codice
pytest: command not found, No module named pytest, il pannello Testing vuoto, No module named 'impronte': non è il tuo codice, è l'ambiente. Ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente.
Il login vero, con il biglietto, arriva nei prossimi capitoli: il biglietto e il login con le rotte protette. Lì il Pronto soccorso ha le voci «Postman e login».