aethercert
Dokumentation

SSL-Zertifikat manuell austauschen: 30 Anleitungen

Schritt-für-Schritt-Anleitungen zum manuellen Austausch von SSL/TLS-Zertifikaten auf IIS, Exchange, AD FS, RDS, NGINX, Apache, F5, NetScaler, FortiGate, vCenter, Proxmox und mehr.

Ein Zertifikat auszutauschen ist nicht auf jedem System derselbe Vorgang. Manche Produkte lesen PEM-Dateien, manche nutzen einen Windows-Zertifikatspeicher, andere halten Zertifikatsobjekte hinter einer Verwaltungs-API. Der Schritt, der das Zertifikat tatsächlich aktiviert, kann eine geänderte IIS-Bindung sein, ein Graceful Reload, ein rollierender Neustart, ein Policy-Deployment oder eine clusterweite Aktualisierung.

Diese Anleitungen beschreiben den Austausch von Hand, ganz ohne aethercert. Jede folgt demselben Aufbau: was vorbereitet sein muss, was das Produkt mit einem Zertifikat macht, die Schritte zum Austausch, die Prüfung über das Netzwerk, der Rollback und was typischerweise schiefgeht. Am Ende steht jeweils ein kurzer Hinweis, was das passende aethercert-Deployment-Ziel automatisiert, sowie die Herstellerdokumentation, auf der die Anleitung beruht.

Nehmen Sie die Anleitung für das System, das TLS terminiert. Steht ein Load Balancer vor einem Webserver und terminiert dort, ist die Anleitung für den Load Balancer die richtige.

Microsoft und Windows

ProduktAnleitung
Windows-ZertifikatspeicherWindows-Zertifikatspeicher
IISMicrosoft IIS
Exchange ServerMicrosoft Exchange Server
AD FSMicrosoft AD FS
Remotedesktop-ListenerRemote Desktop (RDP)
RemotedesktopdiensteRemotedesktopdienste (RDS)
WinRMWindows Remote Management
SQL ServerMicrosoft SQL Server
Skype for BusinessSkype for Business Server
Hyper-V ReplicaHyper-V Replica
Omnissa (VMware) HorizonOmnissa Horizon Connection Server
Citrix StoreFrontCitrix StoreFront

Webserver und Container

ProduktAnleitung
NGINXNGINX
Apache HTTP ServerApache HTTP Server
Jeder andere Linux-DienstEigener Linux-Dienst
HAProxyHAProxy
DockerDocker-Container
Eigenes SkriptEigenes Deployment-Skript

Load Balancer, Firewalls und Appliances

ProduktAnleitung
F5 BIG-IPF5 BIG-IP
Kemp / Progress LoadMasterProgress Kemp LoadMaster
Citrix NetScalerCitrix NetScaler
Fortinet FortiGateFortinet FortiGate
Palo Alto NetworksPalo Alto Networks PAN-OS
Cisco Secure FirewallCisco Secure Firewall Management Center
Sophos FirewallSophos Firewall
WatchGuard FireboxWatchGuard Firebox

Virtualisierung und Orchestrierung

ProduktAnleitung
VMware vCenter ServerVMware vCenter Server
Nutanix PrismNutanix Prism
Proxmox VEProxmox VE
KubernetesKubernetes

Was fast überall gilt

Einige Punkte tauchen in den meisten Anleitungen auf, deshalb stehen sie hier einmal zentral.

  • Importieren heißt nicht aktivieren. Fast jedes Produkt braucht einen zweiten Schritt - eine Bindung, einen Objektverweis, einen Dienstneustart. Wer ihn auslässt, hat weiter das alte Zertifikat im Einsatz, obwohl alles erledigt aussieht.

  • Die Kette ausliefern, nicht nur das Serverzertifikat. Ein Zertifikat, das im eigenen Browser funktioniert, weil dieser das Zwischenzertifikat schon zwischengespeichert hat, scheitert bei einem Client, der es nicht hat.

  • Über das Netzwerk und per Hostname prüfen. Ein Blick in den Speicher oder auf die Datei beweist, dass der Import geklappt hat - nicht, was der Dienst ausliefert.

    openssl s_client -connect app.example.com:443 -servername app.example.com -showcerts
  • Altes Zertifikat und alten Schlüssel behalten, bis jeder Knoten geprüft ist. Zusammen mit der vorherigen Bindungskennung macht das einen Rollback erst möglich.

  • Jeden Knoten bearbeiten. Ein Load Balancer leitet gern weiter auf genau den einen Server, den Sie vergessen haben.

Stattdessen automatisieren

Jede Anleitung endet mit einem Hinweis, was das passende aethercert-Deployment-Ziel übernimmt. Den Katalog, die Felder jeder Vorlage und den Stand der Verifizierung finden Sie unter Deployment-Ziele.

Auf dieser Seite