Installerar certifikatet för den valda Dovecot-tjänsten och kontrollerar det lokalt via TLS eller STARTTLS.
Så går det till
- Serviceagenten på servern hämtar uppgiften från appliancen över utgående HTTPS, port 443.
- Hittar Dovecots certifikatinställningar, lokala IMAP/POP-portar och synliga referenser från andra certifikatverktyg. Den valda inställningen kontrolleras före ändringen.
- Förbereder och validerar certifikat och nyckel. Om andra tjänster använder samma filer får bara den valda Dovecot-inställningen ett eget filpar; gemensamma filer och förnyelsejobb bevaras.
- Byter filerna och läser bara om Dovecot. Om det misslyckas: Vid ett delvis genomfört filbyte eller förlust av en tidigare fungerande lokal TLS-anslutning återställs filerna och den berörda konfigurationen. Rollback kontrolleras mot föregående tillstånd; en obekräftad återställning rapporteras som fel.
- Jämför det lokalt serverade certifikatets fingeravtryck via TLS eller IMAP/POP STARTTLS. Det nya certifikatet ger ett lyckat resultat; redan korrekt tillstånd ger ett lyckat resultat utan ändring. Saknad lokal kontroll ger en varning. Om det gamla certifikatet fortfarande serveras efter en extra omläsning rapporteras fel utan blind rollback.
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
- 110, 143, 993, 995
- Det här behöver ni
- Serviceagenten installerad på servern. Kontot måste kunna skriva certifikat- och nyckelfiler med befintliga rättigheter och läsa om Dovecot. Sudo kan begränsas till fasta Dovecot-kommandon. En delad certifikatinställning kräver också läs- och skrivåtkomst till den valda konfigurationen. Utan root kan nya filer ägas av kontot; grupp och rättigheter bevaras och ändringen visas som en varning.
- Åtgärder
- Discovery, Installation, Kontroll, Rollback
- Integrationer
-
dovecot-ssh1.3.1 - Observera
-
- Discovery läser konfigurationsfilen som den körande Dovecot startades med (masterprocessens -c, annars systemd-enheten, annars den fil doveconf anger), med dess !include-filer. De fasta sökvägarna under /etc/dovecot används bara när tjänsten inte kan svara. Deploy och rollback godtar även filer utanför standardkatalogerna när den aktiva konfigurationen använder just det certifikatet och den nyckeln och doveconf bekräftar det. Certifikatkedjan består av de mellanliggande certifikat som kopplar serverns certifikat till ett rotcertifikat som webbläsaren litar på.
- Fingeravtrycket visar vilket certifikat som serveras, inte om namn och tillitskedja är giltiga. En annan lokal inställnings certifikat ger en varning vid installation. Discovery kan bara visa de certifikatverktyg som den kan se.
- Kräver Bash, OpenSSL, GNU coreutils och flock. Utökad discovery och övertagande av delad inställning kräver Python 3.6 eller senare. Konfigurationssökvägar och återställningsjournaler läses även på Alpine/musl med dessa verktyg installerade. Val av tjänst och lokal TLS-port är valfria.
- dovecot-ssh 2.0.0 är nästa version, byggd för sslbrain v4 och släppt tillsammans med den; till dess installerar appliancen 1.3.1 enligt beskrivningen ovan. 2.0.0 kör samma skript genom serviceagenten på servern eller över SSH. Över SSH krävs root eller ett konto som får köra sudo -n bash utan lösenord, eftersom hela åtgärden körs som root. Den skriver de filer som Dovecots konfiguration anger och använder bara Bash, OpenSSL, doveconf och doveadm. Förnyar en Let's Encrypt-klient på servern certifikatet tar den över det: Dovecot pekar på sslbrains egna filer, klientens filer och förnyelse lämnas som de är, och rollback pekar Dovecot tillbaka.