...
Eroare Securitate cibernetică · Certificate TLS și HTTPS

nginx: [emerg] no "ssl_certificate" is defined for the "listen ... ssl" directive in /etc/nginx/sites-enabled/magazin:2

Pe scurt

Blocul server ascultă cu TLS (listen 443 ssl), dar nu spune ce certificat și ce cheie să folosească, deci nginx nu pornește. Adaugă în același bloc ssl_certificate cu fullchain.pem și ssl_certificate_key cu privkey.pem, apoi rulează sudo nginx -t.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

[emerg] înseamnă eroare fatală: nginx -t pică, iar restart sau reload nu se aplică. Mesajul spune că la linia indicată (sites-enabled/magazin:2) există un listen ... ssl, dar nici în acel bloc server, nici moștenit din blocul http, nu există un ssl_certificate. Fără certificat, nginx nu poate face handshake-ul TLS pentru acel port.

Apare când scrii manual blocul pentru HTTPS înainte de a avea certificatul, când ai șters liniile certbot dintr-o configurare (# managed by Certbot), când ai copiat un bloc de pe alt server sau când directivele sunt scrise în alt bloc server decât cel cu listen 443 ssl. Uneori directivele există, dar sunt comentate cu #. Certbot pune certificatele în /etc/letsencrypt/live/<domeniu>/: fullchain.pem pentru ssl_certificate și privkey.pem pentru ssl_certificate_key.

De ce apare: cauzele frecvente

1Blocul HTTPS fără certificat

Greșit
BASH
server {
    listen 443 ssl;
    server_name magazin-exemplu.ro;
    root /var/www/magazin;
}
Corect
BASH
server {
    listen 443 ssl;
    server_name magazin-exemplu.ro;
    ssl_certificate /etc/letsencrypt/live/magazin-exemplu.ro/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/magazin-exemplu.ro/privkey.pem;
    root /var/www/magazin;
}

Pentru fiecare port cu ssl, nginx trebuie să știe ce certificat trimite și cu ce cheie semnează. Directivele se pun în același bloc server.

2Certificatul încă nu există

Greșit
BASH
# blocul 443 scris înainte de certbot
listen 443 ssl;
Corect
BASH
# întâi doar blocul pe 80, apoi:
sudo certbot --nginx -d magazin-exemplu.ro

certbot --nginx obține certificatul și adaugă singur blocul HTTPS cu directivele corecte.

Repară tu

Repară eroarea, direct în pagină

Ai adăugat în /etc/nginx/sites-available/magazin un bloc pe listen 443 ssl, dar sudo nginx -t dă no "ssl_certificate" is defined for the "listen ... ssl" directive. Certificatul Let's Encrypt există în /etc/letsencrypt/live/magazin-exemplu.ro/. Adaugă în bloc certificatul cu lanțul complet și cheia privată. Parola lui elev este academia.

Indiciu

ssl_certificate primește fullchain.pem, iar ssl_certificate_key primește privkey.pem; le poți adăuga după linia server_name cu sed '/server_name/a ...'.

Alte forme ale mesajului

  • nginx: [emerg] no "ssl_certificate" is defined for the "listen ... ssl" directive in /etc/nginx/nginx.conf:40
  • nginx: configuration file /etc/nginx/nginx.conf test failed
  • no "ssl_certificate" is defined in server listening on SSL port while SSL handshaking

Cum o eviți pe viitor

  • Obține certificatul înainte să scrii blocul HTTPS, sau lasă certbot --nginx să-l scrie.
  • Nu șterge liniile marcate # managed by Certbot fără să înțelegi ce fac.
  • Pune ssl_certificate și ssl_certificate_key imediat sub listen 443 ssl în fiecare bloc.
  • Rulează sudo nginx -t înainte de fiecare reload, ca o greșeală să nu oprească site-urile care merg.

Întrebări frecvente

Pot pune certificatul o singură dată, în blocul http?

Da, directivele moștenite din http se aplică tuturor blocurilor server. Are sens doar dacă toate site-urile folosesc același certificat (de exemplu un wildcard); altfel, fiecare bloc are certificatul lui.

Ce se întâmplă cu site-urile care mergeau?

Dacă rulezi reload, nginx refuză configurarea nouă și continuă cu cea veche, deci site-urile rămân online. La restart însă procesul se oprește și nu mai pornește, iar toate site-urile cad.

Erori înrudite

← Toate erorile Securitate cibernetică

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.