Error: Hostname/IP does not match certificate's altnames: Host: 10.0.0.5. is not in the cert's altnames
Certificatul serverului e emis pentru un nume (de exemplu api.magazin.test), dar tu te conectezi prin alt nume sau prin IP. Folosește în URL exact numele din certificat, de obicei prin {{baseUrl}}, nu adresa IP.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un certificat HTTPS e valabil doar pentru numele enumerate în câmpul Subject Alternative Names (altnames). Clientul compară hostul din URL cu acea listă. Dacă nu se potrivește, refuză conexiunea, chiar dacă certificatul e altfel valid.
Mesajul îți spune exact ce host ai folosit (Host: 10.0.0.5.) și, în forma completă, pentru ce nume e emis certificatul (DNS:api.magazin.test).
Cazuri tipice:
- conectare prin IP în loc de nume (copiat din loguri sau din Docker);
- un alias intern (
api-test) care nu apare în certificat; - un subdomeniu nou, neadăugat încă în certificat;
- un load balancer care servește certificatul altui site.
Reparația normală e să folosești numele corect. Dacă ai nevoie de IP (de exemplu ca să ocolești DNS-ul), soluția e intrarea în fișierul hosts, nu dezactivarea verificării.
De ce apare: cauzele frecvente
1IP în loc de nume
GET https://10.0.0.5/healthGET {{baseUrl}}/health # https://api.magazin.testCertificatul conține numele, nu IP-ul.
2Alias intern absent din certificat
GET https://api-test/healthGET https://api.magazin.test/healthDoar numele din altnames sunt acceptate.
3Trebuie să ajungi la un server anume
GET https://10.0.0.5/health# /etc/hosts: 10.0.0.5 api.magazin.test
GET https://api.magazin.test/healthCu intrarea în hosts, numele rămâne cel din certificat, dar conexiunea merge la IP-ul dorit.
Repară eroarea, direct în pagină
Cererea „Listă produse” folosește IP-ul serverului: https://10.0.0.5/products. Certificatul serverului e emis pentru numele din baseUrl, nu pentru IP. Schimbă URL-ul ca să folosească {{baseUrl}}, salvează cererea și trimite-o: trebuie să primești 200.
Indiciu
Păstrează calea /products.
Reparația
{{baseUrl}}/productsDe ce merge
Cu numele serverului în URL, hostul se potrivește cu numele din certificat, deci verificarea trece. În simulator, IP-ul nu e accesibil deloc; pe un server real ai fi primit eroarea de altnames. Certificatul e emis pentru un nume de domeniu, iar adresa IP nu apare în lista lui de nume alternative. Cu numele de domeniu în URL, verificarea potrivește numele și conexiunea TLS reușește.
Alte forme ale mesajului
Error: Hostname/IP doesn't match certificate's altnamesERR_TLS_CERT_ALTNAME_INVALID
Cum o eviți pe viitor
- Ține adresele în environment, cu numele oficial al serverului.
- Nu copia IP-uri din loguri în cereri.
- La subdomenii noi, verifică certificatul înainte de primele teste.
- Folosește în cereri numele de domeniu pentru care a fost emis certificatul, nu adresa IP.
- Verifică lista de nume (SAN) a certificatului în browser.
Întrebări frecvente
Pot dezactiva verificarea?
Tehnic da, dar aceeași problemă o vor avea clienții reali dacă folosesc acel nume. Repară URL-ul sau certificatul.
Ce sunt altnames?
Lista de nume de domeniu (și uneori IP-uri) pentru care certificatul e valabil, din extensia Subject Alternative Name.
Erori înrudite
Error: connect ETIMEDOUT 10.0.0.5:443 Conexiunea la server nu s-a putut stabili în timp: adresa IP nu e accesibilă din rețeaua ta (firewall, VPN, IP privat) sau serverul e oprit. Verifică dacă folosești adresa corectă, de preferat numele public al serverului, nu un IP intern. 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. 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. Î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.
