Error: unable to verify the first certificate
Serverul trimite doar certificatul lui, fără certificatele intermediare, iar Postman nu poate construi lanțul până la o autoritate de încredere. Reparația e pe server (să trimită lanțul complet); temporar, adaugi intermediarul ca CA în Postman.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un certificat HTTPS e de obicei semnat de o autoritate intermediară, semnată la rândul ei de o rădăcină cunoscută. Serverul trebuie să trimită certificatul lui plus intermediarii. Dacă îi lipsesc intermediarii, clientul nu poate face legătura cu rădăcina și apare mesajul „unable to verify the first certificate”.
Particularitatea: browserele pot merge totuși, pentru că descarcă singure intermediarul sau îl au în cache. Postman și Newman (bazate pe Node.js) nu fac asta, deci eroarea apare doar acolo, iar echipa crede că „e o problemă de Postman”.
E de fapt o configurare greșită a serverului (de exemplu cert.pem în loc de fullchain.pem în nginx). Merită raportată: și alți clienți (aplicații mobile, integrări) vor avea aceeași problemă. Cu openssl s_client -connect host:443 -showcerts vezi câte certificate trimite serverul.
De ce apare: cauzele frecvente
1Serverul trimite doar certificatul final
ssl_certificate /etc/ssl/cert.pem;ssl_certificate /etc/ssl/fullchain.pem;fullchain conține și intermediarii, deci clientul poate construi lanțul.
2Ocolire temporară în Newman
newman run c.json -e test.jsonnewman run c.json -e test.json --ssl-extra-ca-certs intermediar.pemCu intermediarul dat explicit, Newman completează singur lanțul.
Repară eroarea, direct în pagină
Simulatorul nu verifică certificate, deci exersezi verificarea care te ajută să raportezi problema. Environment-ul selectat, „Staging”, trimite spre un server cu lanț incomplet, inaccesibil de aici. Selectează „Dev” și trimite „Health”: trebuie să primești 200, ca să confirmi că API-ul în sine funcționează și problema ține doar de certificatul de pe Staging.
Indiciu
Compară același endpoint pe două medii.
Reparația
Selectează Dev și trimite Health. În raportul pentru Staging scrii: lanțul de certificate e incomplet (serverul trimite un singur certificat), cu rezultatul openssl s_client -showcerts.
De ce merge
Comparația arată că problema nu e în API, ci în configurarea HTTPS a mediului Staging. Asta schimbă destinatarul raportului (infrastructură, nu dezvoltatorii API-ului) și grăbește rezolvarea. Serverul nu trimite tot lanțul de certificate, deci clientul nu poate verifica legătura dintre certificat și autoritate. Reparația definitivă e pe server; în Postman, ajustarea setărilor doar te deblochează pentru test.
Alte forme ale mesajului
Error: UNABLE_TO_VERIFY_LEAF_SIGNATUREunable to get local issuer certificate
Cum o eviți pe viitor
- Verifică lanțul cu un instrument SSL (openssl, SSL Labs) la fiecare certificat nou.
- Raportează problema ca bug de infrastructură: afectează toți clienții care nu sunt browsere.
- Nu dezactiva verificarea ca soluție permanentă.
- Testează certificatul serverului cu
openssl s_client -showcertsca să vezi dacă lipsesc certificatele intermediare.
Întrebări frecvente
De ce merge în Chrome?
Chrome poate descărca intermediarul lipsă sau îl are deja în cache din alte vizite. Node.js, folosit de Newman, nu face asta.
E vina lui Postman?
Nu. Serverul are lanțul incomplet; Postman doar aplică verificarea standard.
Erori înrudite
Error: self-signed certificate in certificate chain Lanțul de certificate al serverului se termină într-o autoritate (CA) pe care Postman nu o cunoaște: de obicei CA-ul intern al firmei sau un proxy care inspectează HTTPS. Adaugă certificatul CA în Settings → Certificates (și --ssl-extra-ca-certs în Newman). Error: self signed certificate Serverul folosește un certificat HTTPS semnat de el însuși, pe care Postman nu îl consideră de încredere. Pentru un mediu local sau de test poți dezactiva „SSL certificate verification” sau, mai bine, adaugi certificatul CA în Settings → Certificates; în producție, certificatul trebuie reparat. Error: certificate has expired Certificatul HTTPS al serverului a expirat, iar Postman refuză conexiunea. Reparația e pe server: certificatul trebuie reînnoit. Verifică și ceasul calculatorului: o dată greșită face un certificat valid să pară expirat. Î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.
