Gå til indhold

← Alle integrationer

Linux · Webserver

Finder indlæste TLS VirtualHosts og skifter det valgte RSA- eller ECDSA-certifikat med kontrolleret genindlæsning.

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. Discovery finder indlæste VirtualHosts og deres ordnede certifikat- og nøgleslots. Vælg stierne til det RSA- eller ECDSA-slot, der skal ændres.
  3. Certifikat og nøgle valideres og stages ved målfilerne. Kendte nøglekonflikter afvises før ændringer; tidligere filer gemmes beskyttet til gendannelse.
  4. Filerne skiftes, konfigurationen kontrolleres, og Apache genindlæses. Gendannelse sker kun, når den tidligere fungerende tjeneste observeres brudt efter skiftet. En kørende tjeneste genindlæses med de gendannede filer; kun en stoppet tjeneste startes.
  5. Kontrol bruger tjenestens hovedproces og lokale TLS-svar for det valgte slot. Et accepteret reload uden tilstrækkeligt bevis rapporteres med advarsel.

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. SSH-konto med adgang til at læse indlæst konfiguration og certifikater, skrive de valgte filer og deres mapper samt køre faste configtest-, reload- og startkommandoer via afgrænset sudo.
Platform
Apache 2.4 og nyere
Handlinger
Discovery, Installation, Kontrol; ingen rollback-handling
Integrationer
apache-ssh 1.4.1
Bemærk
  • Discovery spørger den kørende Apache, hvor konfigurationen ligger: processens -f og -d, ellers systemd-enheden, ellers apache2 -V eller httpd -V. Include og IncludeOptional følges. Deploy accepterer også filer uden for standardmapperne, når en VirtualHost i den aktive konfiguration bruger netop de filer. Certifikatkæden er de mellemcertifikater, der forbinder serverens certifikat med et rodcertifikat, som browseren stoler på.
  • SSH-login kan bruge adgangskode eller privat nøgle. Filskrivning sker som denne konto; sudo giver kun adgang til faste tjenestekommandoer. Ukendt indlæst konfiguration markeres ufuldstændig.
  • Installationen fører journal i mappen <certifikatfil>.sslbrain-state ved siden af certifikatfilen. Mappen skal ejes af den konto, installationen kører som, og have rettighederne 0700; ellers stopper installationen med »State directory must be owned by deployment identity with mode 0700«, før noget ændres. Ret ejer og rettigheder på serveren, og prøv igen.
  • Lokale TLS-vært-, port- og SNI-felter er valgfrie; ellers bruges kendte indlæste lyttere. RELOAD=false skriver kun filer og advarer om ubekræftet aktivering. Deploy-kontrollen viser tilstedeværende mellemcertifikater; verify rapporterer kædetillid og navnematch hver for sig. Ubekræftet aktivering blokerer ikke en senere fornyelse, men uafklaret gendannelse rapporteres som fejl.
  • For et mod_md-administreret navn kan det valgfrie TARGET_SERVER_NAME vælge overtagelse. Certifikatet skal dække alle navne; kun den valgte deklaration skifter til statiske filer og manuel fornyelse. Kontoen skal kunne skrive konfigurationsfilen og dens mappe. Andre administrerede navne bevares. Fornyelse af eksisterende statiske mod_md-filer kræver ingen konfigurationsændring.
  • Alpine/musl og BusyBox-miljøer understøtter de samme valgte certifikatstier. Installer Bash, OpenSSL, GNU coreutils og flock fra util-linux; BusyBox erstatter ikke Bash. Stiernes længde og tilladte tegn kontrolleres også på Alpine.
  • apache-ssh 2.0.0 er den næste version, bygget til sslbrain v4 og udgivet sammen med den; indtil da installerer appliancen 1.4.1 som beskrevet ovenfor. 2.0.0 kører de samme scripts gennem service-agenten på serveren eller over SSH. Over SSH kræver den root eller en konto, der må køre sudo -n bash uden adgangskode, fordi hele handlingen kører som root. Den beholder input, mod_md-overtagelsen og gendannelsen og lægger en angivet kæde i certifikatfilen, når CHAIN_PATH ikke er sat.

Næste skridt