...
Eroare Securitate cibernetică · nginx: permisiuni, 403 și Content-Security-Policy

user "ana" was not found in "/etc/nginx/.htpasswd"

Pe scurt

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

Greșit
BASH
htpasswd -c -B -b /etc/nginx/.htpasswd ana "$PAROLA_ANA"
htpasswd -c -B -b /etc/nginx/.htpasswd mihai "$PAROLA_MIHAI"
Corect
BASH
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

Greșit
BASH
auth_basic_user_file /etc/nginx/htpasswd;
# utilizatorii sunt în /etc/nginx/.htpasswd
Corect
BASH
auth_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ă

Greșit
BASH
# în fișier: Ana:$2y$05$...
# la login: ana
Corect
BASH
htpasswd -B /etc/nginx/.htpasswd ana

Numele de utilizator din HTTP Basic țin cont de majuscule.

Repară tu

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ă.

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 -c o 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 grupul www-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

← Toate erorile Securitate cibernetică

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.