user "ana" was not found in "/etc/nginx/.htpasswd"
La autentificarea HTTP Basic, nginx nu găsește numele în fișierul de parole indicat de auth_basic_user_file. De obicei fișierul a fost suprascris cu htpasswd -c la adăugarea altui utilizator, sau nginx citește alt fișier. Adaugă utilizatorii fără -c (doar primul îl creează).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Cu auth_basic și auth_basic_user_file /etc/nginx/.htpasswd;, nginx cere nume și parolă, apoi caută numele în fișier, câte un nume:hash pe linie. Mesajul din logul de erori spune că numele trimis de browser (ana) nu există în acel fișier, iar clientul primește din nou 401 Authorization Required.
Cauza clasică: htpasswd -c creează fișierul de la zero. Dacă îl folosești la fiecare utilizator adăugat, fiecare comandă îl suprascrie, iar la final rămâne doar ultimul. Alte cauze: nginx citește alt fișier decât cel editat (cale greșită în auth_basic_user_file), numele diferă ca majuscule (Ana față de ana), sau fișierul a fost scris pe Windows și liniile au \r la final.
Când numele e găsit, dar parola nu se potrivește, apare alt mesaj: user "ana": password mismatch.
De ce apare: cauzele frecvente
1htpasswd -c la fiecare utilizator
htpasswd -c -B -b /etc/nginx/.htpasswd ana "$PAROLA_ANA"
htpasswd -c -B -b /etc/nginx/.htpasswd mihai "$PAROLA_MIHAI"htpasswd -c -B -b /etc/nginx/.htpasswd ana "$PAROLA_ANA"
htpasswd -B -b /etc/nginx/.htpasswd mihai "$PAROLA_MIHAI"-c recreează fișierul gol. Folosit doar la primul utilizator, ceilalți se adaugă la fișierul existent.
2nginx citește alt fișier
auth_basic_user_file /etc/nginx/htpasswd;
# utilizatorii sunt în /etc/nginx/.htpasswdauth_basic_user_file /etc/nginx/.htpasswd;Calea din configurație trebuie să fie exact fișierul în care ai adăugat utilizatorii.
3Numele scris cu majusculă
# în fișier: Ana:$2y$05$...
# la login: anahtpasswd -B /etc/nginx/.htpasswd anaNumele de utilizator din HTTP Basic țin cont de majuscule.
Repară eroarea, direct în pagină
Scriptul adauga-utilizatori.sh creează conturile pentru zona protejată /admin/. După rulare, Ana primește 401, iar logul nginx arată user "ana" was not found in "/etc/nginx/.htpasswd". Doar Mihai poate intra. Repară scriptul ca, la rulare, fișierul să conțină ambii utilizatori.
Indiciu
Opțiunea care creează fișierul de la zero trebuie folosită o singură dată.
Reparația
Scoate -c din a doua comandă:
sed -i '/mihai/s/htpasswd -c /htpasswd /' adauga-utilizatori.sh
cat adauga-utilizatori.sh#!/bin/bash
htpasswd -c -B -b /etc/nginx/.htpasswd ana "$PAROLA_ANA"
htpasswd -B -b /etc/nginx/.htpasswd mihai "$PAROLA_MIHAI"De ce merge
htpasswd -c creează fișierul de la zero. A doua comandă îl recrea, deci ștergea linia Anei și lăsa doar pe Mihai, iar nginx nu mai găsea numele ana. Cu -c doar la primul utilizator, a doua comandă adaugă linia lui Mihai la fișierul existent. -B păstrează hash-urile bcrypt.
Alte forme ale mesajului
2026/01/15 10:00:03 [error] 1215#1215: *9 user "ana" was not found in "/etc/nginx/.htpasswd", client: 10.0.0.5, server: magazin-exemplu.ro, request: "GET /admin/ HTTP/1.1", host: "magazin-exemplu.ro"401 Authorization Required
Cum o eviți pe viitor
- Folosește
htpasswd -co singură dată, la crearea fișierului; după aceea, fără-c. - Folosește
-B(bcrypt) pentru hash-uri. - Verifică după fiecare schimbare cu
cut -d: -f1 /etc/nginx/.htpasswd. - Pune fișierul cu
640, proprietar root și grupulwww-data, ca nginx să-l poată citi, dar alții nu. - HTTP Basic doar peste HTTPS: parola circulă codificată, nu criptată.
Întrebări frecvente
Cum văd ce utilizatori are fișierul?
cut -d: -f1 /etc/nginx/.htpasswd afișează doar numele, fără hash-uri.
Trebuie să repornesc nginx după ce adaug un utilizator?
Nu. nginx citește fișierul la fiecare cerere, deci utilizatorul nou poate intra imediat.
Erori înrudite
access forbidden by rule, client: 10.0.0.5, server: magazin-exemplu.ro, request: "GET /admin/ HTTP/1.1", host: "magazin-exemplu.ro" nginx a răspuns 403 pentru că o regulă deny (din allow/deny) se potrivește cu adresa clientului. Regulile se verifică în ordine și câștigă prima potrivită: pune allow pentru rețelele permise înainte de deny all. open() "/var/www/magazin/index.html" failed (13: Permission denied) nginx (utilizatorul www-data) nu are drept să citească fișierul cerut sau să intre într-un folder de pe cale, așa că răspunde cu 403 Forbidden. Dă drept de citire doar cât trebuie: fișierele 644, folderele 755 (sau un grup comun), niciodată 777. 400 Bad Request: The plain HTTP request was sent to HTTPS port Clientul a vorbit HTTP simplu cu un port care așteaptă TLS (de obicei 443), iar nginx răspunde cu 400. Folosește https:// în adresă, fără :443 după http://, sau pe server redirecționează portul 80 spre HTTPS. Învață Securitate cibernetică de la zero, cu exerciții la fiecare lecție
Curs Cybersecurity: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
