curl: (60) SSL certificate problem: unable to get local issuer certificate
curl nu poate construi lanțul de încredere de la certificatul site-ului până la o autoritate pe care o cunoaște. Cel mai des, serverul trimite doar certificatul lui, fără certificatul intermediar (în nginx: cert.pem în loc de fullchain.pem); alteori lipsește pe client pachetul ca-certificates sau CA-ul firmei. Nu folosi -k: repară lanțul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un certificat TLS e semnat de o autoritate intermediară (de exemplu R11 de la Let's Encrypt), iar intermediarul e semnat de o autoritate rădăcină aflată în lista de încredere a sistemului (/etc/ssl/certs). Ca să verifice site-ul, curl trebuie să găsească tot lanțul. unable to get local issuer certificate înseamnă că nu a găsit emitentul unui certificat din lanț, nici în ce a trimis serverul, nici în lista locală.
De obicei vina e pe server: e configurat cu certificatul simplu (cert.pem), fără intermediar. Browserele ascund uneori problema, pentru că țin minte intermediarii văzuți pe alte site-uri, dar curl, Python requests, Java sau aplicațiile mobile o raportează imediat. Alte cauze: pe client lipsește sau e veche lista de autorități (ca-certificates, imagini Docker minimale), ori un proxy al firmei înlocuiește certificatele cu cele semnate de un CA intern, pe care calculatorul nu îl cunoaște. Mesajul complet se termină cu More details here: https://curl.se/docs/sslcerts.html.
De ce apare: cauzele frecvente
1nginx trimite certificatul fără intermediar
ssl_certificate /etc/letsencrypt/live/magazin-exemplu.ro/cert.pem;ssl_certificate /etc/letsencrypt/live/magazin-exemplu.ro/fullchain.pem;cert.pem conține doar certificatul site-ului; fullchain.pem conține certificatul plus intermediarul, deci clientul poate urca până la rădăcina pe care o cunoaște.
2Clientul nu are lista de autorități
# imagine Docker minimală
curl https://api.exemplu.roapt-get update && apt-get install -y ca-certificates
curl https://api.exemplu.roFără pachetul ca-certificates, curl nu are nicio rădăcină de încredere, deci niciun lanț nu poate fi verificat.
3CA-ul intern al firmei nu e instalat
curl -k https://intranet.firma-exemplu.rosudo cp ca-firma.crt /usr/local/share/ca-certificates/
sudo update-ca-certificates
curl https://intranet.firma-exemplu.ro-k dezactivează orice verificare. Adăugarea CA-ului intern în lista sistemului rezolvă problema pentru toate programele, păstrând verificarea.
Repară eroarea, direct în pagină
Clienții API-ului tău primesc curl: (60) SSL certificate problem: unable to get local issuer certificate, deși certificatul Let's Encrypt e valid. Configurarea nginx a site-ului este /etc/nginx/sites-available/magazin. Repară directiva care alege fișierul certificatului, ca serverul să trimită și certificatul intermediar. Fișierele certbot sunt în /etc/letsencrypt/live/magazin-exemplu.ro. Parola pentru sudo este academia.
Indiciu
certbot creează și un fișier care conține certificatul împreună cu lanțul: fullchain.pem.
Reparația
Vezi ce fișier folosește nginx și înlocuiește-l cu lanțul complet:
grep ssl_certificate /etc/nginx/sites-available/magazin
sudo sed -i 's#/cert.pem;#/fullchain.pem;#' /etc/nginx/sites-available/magazin
grep ssl_certificate /etc/nginx/sites-available/magazin ssl_certificate /etc/letsencrypt/live/magazin-exemplu.ro/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/magazin-exemplu.ro/privkey.pem;Pe server urmează sudo nginx -t && sudo systemctl reload nginx.
De ce merge
cert.pem conține doar certificatul site-ului, semnat de intermediarul Let's Encrypt. Clienții care nu au intermediarul (curl, aplicațiile, Python) nu pot lega certificatul de rădăcina din lista lor și opresc conexiunea. fullchain.pem conține certificatul urmat de intermediar, deci nginx trimite tot lanțul la fiecare conexiune. Cheia (privkey.pem) rămâne aceeași, pentru că certificatul nu s-a schimbat.
Alte forme ale mesajului
SSL certificate problem: unable to get local issuer certificatecurl: (60) SSL certificate problem: unable to get issuer certificaterequests.exceptions.SSLError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1007)verify error:num=20:unable to get local issuer certificate
Cum o eviți pe viitor
- În nginx folosește mereu
fullchain.pempentrussl_certificateșiprivkey.pempentru cheie. - După fiecare instalare de certificat, verifică lanțul cu
openssl s_client -connect site:443 -servername site(cautăVerify return code: 0 (ok)) sau cu un test online de TLS. - În imaginile Docker, instalează
ca-certificates. - Nu pune
curl -k,verify=Falsesau echivalente în cod: ascund problema și te expun la interceptări.
Întrebări frecvente
În browser site-ul merge. De ce curl se plânge?
Browserele completează uneori singure lanțul, din intermediarii pe care i-au văzut deja sau pe care îi descarcă. curl și majoritatea bibliotecilor nu fac asta, deci văd lanțul incomplet trimis de server.
Pot folosi curl -k ca să merg mai departe?
Pentru un test de un minut, pe propriul server, da. În scripturi și aplicații, nu: -k acceptă orice certificat, inclusiv pe cel al cuiva care îți interceptează traficul.
Erori înrudite
curl: (60) SSL certificate problem: self-signed certificate Serverul folosește un certificat semnat de el însuși, pe care nicio autoritate cunoscută nu îl garantează. Pentru un server intern, dă-i lui curl certificatul sau CA-ul intern cu --cacert (sau adaugă-l în sistem cu update-ca-certificates); pentru un site public, pune un certificat Let's Encrypt. Nu folosi -k. curl: (60) SSL certificate problem: certificate has expired Data de expirare a certificatului (Not After) a trecut, deci clienții îl refuză. Reînnoiește-l pe server (sudo certbot renew), reîncarcă serverul web și asigură-te că reînnoirea rulează automat; dacă certificatul e bun, verifică și ceasul calculatorului. nginx: [emerg] cannot load certificate "/etc/ssl/certs/magazin.crt": BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory:calling fopen(/etc/ssl/certs/magazin.crt, r) error:10000080:BIO routines::no such file) nginx nu găsește fișierul certificatului la calea din ssl_certificate: calea e scrisă greșit, fișierul a fost mutat sau încă nu există. Verifică cu ls calea exactă, corecteaz-o în configurare și rulează sudo nginx -t înainte de reload. Î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.
