Gå til indhold

← Alle integrationer

Linux · Webserver

Finder aktive TLS-server-blokke og skifter certifikat og nøgle med lokal kontrol af aktiveringen.

Service-agenten på serveren henter opgaven fra appliancen over udgående HTTPS på port 443 og installerer certifikatet lokalt på serveren. Appliancen forbinder aldrig til serveren.

Sådan forløber det

  1. Service-agenten på serveren henter opgaven fra appliancen over udgående HTTPS, port 443.
  2. Certifikat og nøgle kontrolleres, og integrationen læser den konfiguration, den kørende Nginx bruger, med alle include-filer. Har filerne allerede certifikatet, og viser Nginx det, ændres intet. Hvis det fejler: Ugyldig PEM eller en nøgle, der ikke passer til certifikatet, afvises, før noget skrives.
  3. Certifikat og nøgle skrives atomisk til CERT_PATH og KEY_PATH, og de tidligere filer gemmes som backup. Med RELOAD=true (standard) tester nginx -t konfigurationen med de nye filer. Hvis det fejler: Afviser nginx -t konfigurationen, lægges de tidligere filer tilbage, og den kørende tjeneste røres ikke.
  4. Nginx genindlæses. RELOAD_MAY_RESTART=true tillader én nginx-genstart, hvis to genindlæsninger stadig viser det tidligere certifikat. Andre tjenester genstartes ikke.
  5. Kontrol: integrationen sammenligner det certifikat, Nginx viser lokalt, med det nye certifikats SHA-256-fingeraftryk. Hvis det fejler: Fejler genindlæsningen, eller holder den lokale TLS-tjeneste op med at svare, forsøges gendannelse: de tidligere filer lægges tilbage, og Nginx genindlæses. Resultatet siger, om gendannelsen lykkedes. Rollback lægger senere det tilbage, som sidste deploy erstattede.

Tekniske detaljer

Forbindelse
Integrationen kører gennem service-agenten på serveren. Service-agenten forbinder over udgående HTTPS til appliancen, port 443 som standard. I åbner ingen port ind til serveren.
Tjenestens porte
443, 80
Det skal I bruge
Service-agenten installeret på serveren. Integrationen kører på serveren under Linux-service-agenten. Service-agenten skal kunne læse nginx-konfigurationen, skrive certifikat- og nøglefilerne og køre nginx -t og nginx -s reload; ved overtagelse også skrive sitets konfigurationsfil og /etc/nginx/ssl. check-access kontrollerer adgangen og nginx -t.
Handlinger
Discovery, Installation, Kontrol, Rollback
Integrationer
nginx-ssh 2.0.0
Bemærk
  • Overtagelse: bruger sitet et certifikat, som en ACME-klient på serveren eller Nginx' eget ACME-modul (Native ACME) fornyer, er valget af målet også valget at overtage det. Deploy skriver certifikatet til egne filer i /etc/nginx/ssl og retter sitets ssl_certificate-linjer til dem. ACME-klienten eller ACME-modulet beholder sine filer, indstillinger og timere og fornyer videre til filer, sitet ikke længere bruger. Resultatet siger, at sitet er overtaget, og rollback retter linjerne tilbage. Ved Native ACME vælger LOCAL_TLS_SNI sitet. Certifikatkæden er de mellemcertifikater, der forbinder serverens certifikat med et rodcertifikat, som browseren stoler på. ACME er den protokol, en CA bruger til at udstede certifikater automatisk.
  • CERT_PATH og KEY_PATH kommer fra discovery, som viser de aktive server-blokke og hvilken certifikathåndtering, hver bruger. Integrationen skriver kun under /etc/ssl, /etc/pki/tls, /etc/nginx/ssl, /etc/nginx/certs, /usr/local/etc/ssl og /usr/local/etc/nginx/ssl, eller hvor den aktive konfiguration nævner filen.
  • RELOAD=false skriver filerne uden at genindlæse Nginx. Aktivering er ikke bekræftet, og resultatet er en advarsel. RELOAD_MAY_RESTART er false som standard.
  • LOCAL_TLS_HOST er 127.0.0.1 eller ::1. LOCAL_TLS_PORT og LOCAL_TLS_SNI kan angives til den valgte listener. Kontrollen måler det lokale certifikats identitet; den beviser ikke ekstern adgang, hele tillidskæden eller andre noder.
  • Version 2.0.0 bruger samme handlinger og inputnavne som 1.4.0. CERT_PEM og KEY_PEM er binære input; de tidligere CERT_PEM_BASE64 og KEY_PEM_BASE64 findes ikke længere.

Næste skridt