401 Unauthorized cu WWW-Authenticate: Basic
Serverul cere autentificare Basic (utilizator și parolă), iar cererea nu o trimite sau credențialele sunt greșite. Antetul WWW-Authenticate: Basic realm=... îți spune schema. Alege Basic Auth în tabul Authorization și completează utilizatorul și parola.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când un server răspunde 401 cu antetul WWW-Authenticate: Basic realm="Magazin", îți spune explicit ce schemă de autentificare așteaptă: Basic, adică utilizator și parolă codate Base64 în antetul Authorization: Basic .... Browserul ar deschide o fereastră de login; Postman doar afișează răspunsul.
Cauze:
- cererea nu are deloc autentificare (No Auth sau Inherit de la o colecție fără Basic);
- ai pus Bearer în loc de Basic;
- utilizatorul sau parola sunt greșite (inclusiv spații, majuscule în parolă);
- parola conține caractere speciale și ai construit antetul manual, greșit.
În tabul Authorization alegi Basic Auth, completezi Username și Password (de preferat din variabile), iar Postman calculează antetul. Antetul generat îl vezi în Headers (hidden) sau în Console.
De ce apare: cauzele frecvente
1Lipsește autentificarea
GET {{baseUrl}}/auth/basic
Authorization: No AuthAuthorization: Basic Auth
Username: ana@magazin.test
Password: {{parola}}Serverul cere schema Basic.
2Schema greșită
Authorization: Bearer Token {{token}}Authorization: Basic AuthAntetul WWW-Authenticate spune schema așteptată.
3Antet construit greșit de mână
Authorization: Basic ana@magazin.test:Parola123!Authorization: Basic YW5hQG1hZ2F6aW4udGVzdDpQYXJvbGExMjMhCredențialele trebuie codate Base64; Postman o face automat.
Repară eroarea, direct în pagină
Cererea „Autentificare Basic” (GET {{baseUrl}}/auth/basic) primește 401 cu WWW-Authenticate: Basic realm="Magazin". Setează în tabul Authorization tipul Basic Auth, cu utilizatorul ana@magazin.test și parola Parola123!, salvează și trimite: trebuie să primești 200.
Indiciu
Antetul WWW-Authenticate spune schema cerută.
Reparația
Authorization → Basic Auth: Username ana@magazin.test, Password Parola123!. Salvează și trimite.
De ce merge
Postman unește utilizatorul și parola cu :, le codează Base64 și trimite Authorization: Basic ..., exact schema cerută de server prin antetul WWW-Authenticate. Antetul WWW-Authenticate: Basic spune ce schemă așteaptă serverul. Cu Basic Auth și datele corecte, Postman trimite antetul codificat în base64, iar serverul te autentifică.
Alte forme ale mesajului
WWW-Authenticate: Basic realm="Restricted"401 Authorization Required
Cum o eviți pe viitor
- Citește antetul
WWW-Authenticatela orice 401: spune schema cerută. - Folosește Basic Auth din tabul Authorization, cu parola într-o variabilă.
- Folosește Basic doar peste HTTPS: Base64 nu e criptare.
- Folosește tipul Basic Auth din Postman, care codifică automat utilizatorul și parola.
Întrebări frecvente
Base64 ascunde parola?
Nu. Base64 se decodează instant; protecția vine doar de la HTTPS.
Ce înseamnă realm?
Un nume pentru zona protejată, afișat de browser în fereastra de login.
Erori înrudite
401 Unauthorized Serverul nu știe cine ești: tokenul lipsește, e expirat sau invalid, sau cheia API nu e trimisă. Obține un token nou (login) și verifică în Console că antetul Authorization chiar pleacă cu cererea. Missing Authorization Header Cererea nu trimite antetul Authorization, deși endpointul îl cere: de obicei cererea are No Auth în loc de Inherit auth from parent, sau tokenul colecției e gol. Setează autentificarea cererii pe Inherit (sau Bearer {{token}}) și verifică antetul în Console. Invalid authentication credentials Cheia API (sau credențialele) e prezentă, dar serverul nu o recunoaște: e greșită, expirată, revocată sau aparține altui mediu. Verifică valoarea exactă din environment (spații, caractere lipsă) și cere o cheie validă pentru mediul curent. Învață Postman de la zero, cu exerciții la fiecare lecție
Curs API Testing cu Postman: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
