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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Certificatul serverului e semnat corect de o autoritate, dar autoritatea de la capătul lanțului (rădăcina) e self-signed și nu se află în lista de încredere a lui Postman.
Cele două situații tipice:
- firma are propriul CA intern pentru mediile de test;
- un proxy corporativ sau un antivirus inspectează traficul HTTPS: decriptează și re-criptează cu certificatul lui, iar Postman vede lanțul proxy-ului.
Diferența față de „self signed certificate”: acolo certificatul serverului e semnat de el însuși; aici serverul are un lanț, dar rădăcina lui e necunoscută.
Reparația corectă: obții certificatul CA (de la echipa de infrastructură sau exportat din sistem) și îl adaugi în Settings → Certificates → CA Certificates. Pentru Newman: --ssl-extra-ca-certs ca.pem sau variabila NODE_EXTRA_CA_CERTS.
De ce apare: cauzele frecvente
1CA intern neadăugat
newman run c.json -e staging.jsonnewman run c.json -e staging.json --ssl-extra-ca-certs ca-firma.pemNewman are nevoie explicit de CA-ul firmei.
2Proxy cu inspecție HTTPS
# rețeaua firmei rescrie certificatele
GET https://api.magazin.test/healthSettings → Certificates → CA Certificates: proxy-firma.pemPostman trebuie să aibă încredere în certificatul proxy-ului care semnează din nou traficul.
3Mediu intern în loc de cel public
Environment: Staging-internEnvironment: Dev (certificat public)Dacă testul nu cere mediul intern, un mediu cu certificat public evită problema.
Repară eroarea, direct în pagină
Simulatorul nu verifică certificate, așa că exersezi alternativa sigură. Environment-ul „Staging-intern” trimite spre un server cu lanț de certificate semnat de CA-ul intern al firmei, inaccesibil de aici. Selectează environment-ul „Dev” (certificat public) și trimite „Listă produse”: trebuie să primești 200.
Indiciu
Selectorul de environment e în dreapta-sus.
Reparația
Selectează Dev și trimite. Dacă ai nevoie de Staging-intern pe un calculator real: Settings → Certificates → CA Certificates cu certificatul CA al firmei, iar în Newman --ssl-extra-ca-certs ca-firma.pem.
De ce merge
Pe Dev, lanțul certificatului se termină într-o autoritate publică, deja cunoscută de Postman. Pentru mediul intern, soluția corectă e să adaugi CA-ul firmei, nu să dezactivezi verificarea. Lanțul de certificate se termină într-o autoritate pe care Postman nu o cunoaște, de obicei un proxy sau o rețea de firmă. Cu verificarea ajustată sau CA-ul adăugat, conexiunea TLS se stabilește și cererea ajunge la API.
Alte forme ale mesajului
Error: SELF_SIGNED_CERT_IN_CHAINself signed certificate in certificate chain
Cum o eviți pe viitor
- Păstrează CA-ul firmei într-un loc cunoscut și documentează cum se adaugă în Postman și Newman.
- În CI, setează
NODE_EXTRA_CA_CERTSîn imaginea runner-ului. - Evită
--insecureca soluție permanentă. - Cere echipei de infrastructură fișierul CA intern și adaugă-l în Settings → Certificates, în loc să oprești verificarea.
Întrebări frecvente
De unde iau certificatul CA?
De la echipa de infrastructură sau din magazinul de certificate al sistemului (Keychain pe macOS, certmgr pe Windows), exportat ca PEM.
Merge cu NODE_TLS_REJECT_UNAUTHORIZED=0?
Merge, dar dezactivează verificarea pentru tot procesul. E mai sigur să adaugi doar CA-ul necesar.
Erori înrudite
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: 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. Error: tunneling socket could not be established, cause=connect ECONNREFUSED 127.0.0.1:8888 Postman încearcă să treacă prin proxy-ul configurat (aici 127.0.0.1:8888), dar proxy-ul nu răspunde. Oprește proxy-ul din Settings → Proxy dacă nu ai nevoie de el, pornește-l (de exemplu Fiddler, Charles) sau corectează adresa proxy-ului firmei. Î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.
