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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
La HTTPS, clientul verifică dacă certificatul serverului e semnat de o autoritate de încredere. Un certificat self-signed e semnat chiar de server, deci nu există nicio autoritate care să garanteze pentru el. Postman refuză conexiunea și afișează această eroare.
E frecvent pe:
- servere de dezvoltare locale cu HTTPS (
https://localhost:8443); - medii de test interne, unde echipa a generat singură certificatul;
- aparate și servicii interne.
Variante de rezolvare, de la cea mai bună la cea mai rapidă:
1. folosești un mediu cu certificat valid; 2. adaugi certificatul CA intern în Settings → Certificates → CA Certificates; 3. dezactivezi SSL certificate verification (global sau din Settings-ul cererii), doar pentru mediul de test.
În Newman, echivalentul opțiunii 3 este --insecure (-k), iar al opțiunii 2, --ssl-extra-ca-certs.
De ce apare: cauzele frecvente
1Certificat generat local
GET https://localhost:8443/health
# certificat creat cu openssl, fără CASettings → Certificates → CA Certificates: ca-local.pem
# sau, doar local: SSL certificate verification OFFPostman trebuie să știe de autoritatea care a semnat certificatul.
2Newman în CI pe mediul de test
newman run c.json -e test.jsonnewman run c.json -e test.json --ssl-extra-ca-certs ca-firma.pemCA-ul intern se dă explicit lui Newman.
3Mediu greșit ales
Environment: Test-vechi (certificat self-signed)Environment: Dev (certificat valid)Uneori există deja un mediu echivalent cu certificat corect.
Repară eroarea, direct în pagină
Simulatorul nu verifică certificate, așa că exersezi aici reparația recomandată: să lucrezi pe un mediu cu certificat valid. Environment-ul selectat, „Test-vechi”, trimite spre un server intern cu certificat self-signed, inaccesibil din simulator. Selectează environment-ul „Dev” și trimite „Health”: trebuie să primești 200.
Indiciu
Schimbă environment-ul, nu cererea.
Reparația
Selectează Dev și trimite. Pe un calculator real, dacă trebuie neapărat să folosești serverul cu certificat self-signed, adaugi CA-ul în Settings → Certificates sau, doar pentru test, dezactivezi SSL certificate verification din Settings-ul cererii.
De ce merge
Mediul Dev are un certificat emis de o autoritate de încredere, deci verificarea trece fără să slăbești securitatea. Dezactivarea verificării rezolvă simptomul, dar pe un mediu greșit ales e doar o ocolire. Dezactivarea verificării SSL e acceptabilă doar pe medii de test controlate, unde știi cine a emis certificatul. Pe producție, soluția corectă rămâne un certificat valid sau adăugarea autorității interne în setările Postman.
Alte forme ale mesajului
Error: self-signed certificateSSL Error: Self signed certificateError: DEPTH_ZERO_SELF_SIGNED_CERT
Cum o eviți pe viitor
- Nu dezactiva verificarea SSL global și permanent; fă-o doar pentru mediul de test și cât e nevoie.
- Cere echipei CA-ul intern și adaugă-l în Postman și în Newman.
- În producție, un certificat self-signed e o problemă de raportat, nu de ocolit.
Întrebări frecvente
E periculos să dezactivez verificarea?
Pe un mediu de test controlat, riscul e mic. Pe rețele publice sau în producție te expune la interceptarea traficului, deci nu.
De ce browserul îmi arată doar un avertisment?
Browserul te lasă să accepți manual riscul. Postman și Newman refuză automat, ca să nu treacă neobservat.
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: 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: 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.
