Hittar aktiva TLS-serverblock och byter certifikat och nyckel med lokal kontroll av aktiveringen.
Så går det till
- Serviceagenten på servern hämtar uppgiften från appliancen över utgående HTTPS, port 443.
- Certifikat och nyckel kontrolleras och integrationen läser konfigurationen som den körande Nginx använder, med alla include-filer. Har filerna redan certifikatet och visar Nginx det, ändras ingenting. Om det misslyckas: Ogiltig PEM eller en nyckel som inte matchar certifikatet avvisas innan något skrivs.
- Certifikat och nyckel skrivs atomärt till CERT_PATH och KEY_PATH och de tidigare filerna sparas som backup. Med RELOAD=true (standard) testar nginx -t konfigurationen med de nya filerna. Om det misslyckas: Avvisar nginx -t konfigurationen läggs de tidigare filerna tillbaka och den körande tjänsten rörs inte.
- Nginx läses om. RELOAD_MAY_RESTART=true tillåter en nginx-omstart om två omläsningar fortfarande visar det tidigare certifikatet. Andra tjänster startas inte om.
- Kontroll: integrationen jämför certifikatet som Nginx visar lokalt med det nya certifikatets SHA-256-fingeravtryck. Om det misslyckas: Misslyckas omläsningen, eller slutar den lokala TLS-tjänsten svara, försöks återställning: de tidigare filerna läggs tillbaka och Nginx läses om. Resultatet säger om återställningen lyckades. Rollback lägger senare tillbaka det som senaste deploy ersatte.
Tekniska detaljer
- Anslutning
- Integrationen körs genom serviceagenten på servern. Serviceagenten ansluter över utgående HTTPS till appliancen, port 443 som standard. Ni öppnar ingen port in till servern.
- Tjänstens portar
- 443, 80
- Det här behöver ni
- Serviceagenten installerad på servern. Integrationen körs på servern under Linux-serviceagenten. Serviceagenten ska kunna läsa nginx-konfigurationen, skriva certifikat- och nyckelfilerna och köra nginx -t och nginx -s reload; vid övertagande även skriva sajtens konfigurationsfil och /etc/nginx/ssl. check-access kontrollerar åtkomsten och nginx -t.
- Åtgärder
- Discovery, Installation, Kontroll, Rollback
- Integrationer
-
nginx-ssh2.0.0 - Observera
-
- Övertagande: använder sajten ett certifikat som en ACME-klient på servern eller Nginx eget ACME-modul (Native ACME) förnyar, är valet av målet också valet att ta över det. Deploy skriver certifikatet till egna filer i /etc/nginx/ssl och ändrar sajtens ssl_certificate-rader till dem. ACME-klienten eller ACME-modulen behåller sina filer, inställningar och timers och förnyar vidare till filer som sajten inte längre använder. Resultatet säger att sajten är övertagen, och rollback ändrar tillbaka raderna. Vid Native ACME väljer LOCAL_TLS_SNI sajten. Certifikatkedjan består av de mellanliggande certifikat som kopplar serverns certifikat till ett rotcertifikat som webbläsaren litar på. ACME är det protokoll en CA använder för att utfärda certifikat automatiskt.
- CERT_PATH och KEY_PATH kommer från discovery, som visar de aktiva serverblocken och vilken certifikathantering vart och ett använder. Integrationen skriver bara under /etc/ssl, /etc/pki/tls, /etc/nginx/ssl, /etc/nginx/certs, /usr/local/etc/ssl och /usr/local/etc/nginx/ssl, eller där den aktiva konfigurationen nämner filen.
- RELOAD=false skriver filerna utan att läsa om Nginx. Aktivering är inte bekräftad och resultatet är en varning. RELOAD_MAY_RESTART är false som standard.
- LOCAL_TLS_HOST är 127.0.0.1 eller ::1. LOCAL_TLS_PORT och LOCAL_TLS_SNI kan anges för vald lyssnare. Kontrollen mäter det lokala certifikatets identitet; den bevisar inte extern åtkomst, hela tillitskedjan eller andra noder.
- Version 2.0.0 använder samma åtgärder och indatanamn som 1.4.0. CERT_PEM och KEY_PEM är binära indata; de tidigare CERT_PEM_BASE64 och KEY_PEM_BASE64 finns inte längre.