zertifikate:pki:server-zertifikate
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
| Beide Seiten der vorigen RevisionVorhergehende Überarbeitung | |||
| zertifikate:pki:server-zertifikate [2026/04/10 07:41] – [Automatisiert per ACME [EMPFOHLEN]] Carl Meffert | zertifikate:pki:server-zertifikate [2026/04/10 11:27] (aktuell) – gelöscht Carl Meffert | ||
|---|---|---|---|
| Zeile 1: | Zeile 1: | ||
| - | [[zertifikate: | ||
| - | |||
| - | |||
| - | ====== TLS- / SSL- / Serverzertifikate ====== | ||
| - | |||
| - | Zweck: Transportverschlüsselung (TLS/SSL) für die Kommunikation mit HTTPS, FTPS, RDP, SMTPS, LDAPS, usw. zu Servern | ||
| - | |||
| - | <note important> | ||
| - | |||
| - | <note tip> | ||
| - | |||
| - | ===== Automatisiert per ACME ===== | ||
| - | |||
| - | Mithilfe eines [[https:// | ||
| - | |||
| - | Falls Ihr Server ACME nicht unterstützt oder Sie aus anderen Gründen ein manuell erstelltes Zertifikat benötigen, finden Sie die Anleitung [[zertifikate: | ||
| - | |||
| - | Um ACME an der HSM verwenden zu können, benötigen Sie: | ||
| - | - Ihre Key-ID (KID) / Account-ID (22 Zeichen) | ||
| - | - Ihren HMAC-Key (86 Zeichen) | ||
| - | - die ACME-Server-URL | ||
| - | - Es werden **keine** extern erreichbaren Ports benötigt! | ||
| - | |||
| - | <note tip> | ||
| - | Eine '' | ||
| - | </ | ||
| - | |||
| - | ==== Linux / Unix: acme.sh ==== | ||
| - | |||
| - | {{https:// | ||
| - | |||
| - | Für Linux- und Unix-basierte Systeme wird als ACME-Client [[https:// | ||
| - | |||
| - | |||
| - | |||
| - | - **acme.sh automatisch installieren: | ||
| - | - **acme.sh-Alias aktualisieren/ | ||
| - | - **Standard-CA auf ACME-Server-URL setzen:** '' | ||
| - | - **ACME-Account registrieren: | ||
| - | - **Zertifikat ausstellen lassen:** '' | ||
| - | - **Zertifikat installieren: | ||
| - | |||
| - | Die eingegebenen Parameter werden standardmäßig in '' | ||
| - | |||
| - | === Beispiel === | ||
| - | |||
| - | * Key-ID: '' | ||
| - | * HMAC-Key: '' | ||
| - | * ACME-Server-URL(Harica): | ||
| - | * Domain: '' | ||
| - | * Servertyp: Apache | ||
| - | * System: Ubuntu | ||
| - | * Zertifikatspfad: | ||
| - | * Schlüsselpfad: | ||
| - | |||
| - | <code bash beispiel.sh> | ||
| - | curl https:// | ||
| - | . ~/.profile | ||
| - | acme.sh --set-default-ca --server https:// | ||
| - | acme.sh --register-account --eab-kid GFYlXahAbkl9aLbqmq8icf --eab-hmac-key aJWvKJMVTzd1gQfSMbEhLKAKq5xmFI9WCPkM2u24M6IaVaR7dbzSRmXFRPuccdeAPEslOeBIswakMPiaPeOibB | ||
| - | acme.sh --issue -d webserver1.hs-schmalkalden.de -w /dev/null | ||
| - | acme.sh -i -d webserver1.hs-schmalkalden.de --cert-file / | ||
| - | </ | ||
| - | |||
| - | === Erweiterte Verwendungen === | ||
| - | |||
| - | == Manuelle Installation == | ||
| - | |||
| - | Die automatische Online-Installation legt den für die spätere Automatisierung benötigten Cronjob und einen Alias im Profil ('' | ||
| - | |||
| - | <note warning> | ||
| - | |||
| - | <code bash> | ||
| - | acme.sh --set-default-ca --server https:// | ||
| - | |||
| - | touch: cannot touch '/ | ||
| - | ./ | ||
| - | grep: / | ||
| - | grep: / | ||
| - | ./ | ||
| - | grep: / | ||
| - | [Wed Apr 17 14:51:01 UTC 2024] Changed default CA to: https:// | ||
| - | </ | ||
| - | |||
| - | == Zusätzliches Zusenden per E-Mail == | ||
| - | |||
| - | Bei der automatischen Installation von acme.sh, beim Registrieren des ACME-Accounts oder beim Ausstellen des ersten Zertifikates kann eine E-Mail-Adresse angegeben werden, um beim Ausstellen und Erneuern das Zertifikat zusätzlich per E-Mail zu senden. Dazu müssen die Befehle folgendermaßen modifiziert werden: | ||
| - | |||
| - | - **Automatische Installation: | ||
| - | - **ACME-Accountregistrierung oder Zertifikatsausstellung: | ||
| - | |||
| - | == Subdomain-, Wildcard- & Multidomain-Zertifikate == | ||
| - | |||
| - | Grundsätzlich können ACME-Accounts für ihre zugewiesenen Domains auch Zertifikate für Subdomains beliebiger Tiefe inkl. Wildcard ausstellen lassen. Ein ACME-Account, | ||
| - | |||
| - | Um Multidomain-Zertifikate ausstellen zu lassen, genügt es, den Domain-Parameter '' | ||
| - | |||
| - | In Kombination bedeutet dies, dass der Befehl '' | ||
| - | |||
| - | == Zertifikatsinstallation mit CA-Zertifikat oder Fullchain == | ||
| - | |||
| - | Beim Installationbefehl können als Pfadangaben neben dem Zertifikat und dem Schlüssel selber außerdem noch das CA-Zertifikat und/oder die komplette Kette angegeben werden: | ||
| - | |||
| - | - **CA-Zertifikat: | ||
| - | - **Fullchain (Nötig bei nginx):** '' | ||
| - | |||
| - | ==== Windows: win-acme ==== | ||
| - | |||
| - | {{https:// | ||
| - | |||
| - | Für Windows-Systeme wird als ACME-Client [[https:// | ||
| - | |||
| - | **Beispiel: | ||
| - | |||
| - | * Key-ID: '' | ||
| - | * HMAC-Key: '' | ||
| - | * ACME-Server-URL(Harica): | ||
| - | * Domain: '' | ||
| - | * Servertyp: RDP-Dienst (z.B. bei Terminalserver oder VM) | ||
| - | * System: Windows Server 2019 | ||
| - | |||
| - | Folgende Schritte sind für die Einrichtung von '' | ||
| - | |||
| - | - '' | ||
| - | - Das entpackte Verzeichnis sollte zuerst in seinen korrekten Zielpfad (bspw. '' | ||
| - | - Anschließend muss '' | ||
| - | - In der Datei '' | ||
| - | - Zur eigentlichen Einrichtung muss jetzt folgende Befehlskette in der PowerShell oder CMD im Verzeichnis von '' | ||
| - | - Da es sich beim Beispiel um den RDP-Dienst einer Windows-Maschine handelt, wird als Installationsskript die mitgelieferte Datei '' | ||
| - | - Skripte für weitere Dienste befinden sich derzeit noch in der Erprobung | ||
| - | - Es können auch eigene Skripte verwendet werden. (Siehe [[https:// | ||
| - | .\wacs.exe ` | ||
| - | --source manual ` | ||
| - | --accepttos ` | ||
| - | --certificatestore My ` | ||
| - | --baseuri https:// | ||
| - | --eab-key-identifier GFYlXahAbkl9aLbqmq8icf ` | ||
| - | --eab-key aJWvKJMVTzd1gQfSMbEhLKAKq5xmFI9WCPkM2u24M6IaVaR7dbzSRmXFRPuccdeAPEslOeBIswakMPiaPeOibB ` | ||
| - | --host rdpserver.bereich.hs-schmalkalden.de[, | ||
| - | --installation script ` | ||
| - | --script " | ||
| - | --scriptparameters " | ||
| - | - Dies sollte ein Zertifikat für die angegebene Domain ausgestellt und installiert sowie eine geplante Aufgabe zur automatischen Erneuerung angelegt haben. | ||
| - | |||
| - | === Überprüfung / Weitere Informationen === | ||
| - | - Zertifikat überprüfen: | ||
| - | - Geplante Aufgabe überprüfen / ändern: '' | ||
| - | - Logs und Einstellungen: | ||
| - | - Weitere Installationsskripte / allgemeine Verwendung: [[https:// | ||
| - | |||
| - | === Erweiterte Verwendungen === | ||
| - | |||
| - | == Domain-Controller / Management-Server: | ||
| - | |||
| - | Hierzu wird vom Rechenzentrum folgendes PowerShell-Installationsskript zur Verfügung gestellt: | ||
| - | |||
| - | <code powershell HSM_ImportRemoteRDListener.ps1> | ||
| - | param( | ||
| - | [Parameter(Position=0, | ||
| - | [string]$cn, | ||
| - | [Parameter(Position=1, | ||
| - | [string]$thumbprint, | ||
| - | [Parameter(Position=2, | ||
| - | [string]$path, | ||
| - | [Parameter(Position=3, | ||
| - | [string]$pwd | ||
| - | ) | ||
| - | |||
| - | $destPath = " | ||
| - | $destLocalPath = " | ||
| - | $destUNCPath = " | ||
| - | |||
| - | Copy " | ||
| - | |||
| - | wmic / | ||
| - | |||
| - | Start-Sleep 2 | ||
| - | |||
| - | wmic / | ||
| - | </ | ||
| - | **Erläuterung: | ||
| - | - Zunächst wird die ausgestellte PFX-Zertifikatsdatei temporär über die administrative Freigabe von Laufwerk C im Home-Verzeichnis des ausführenden Nutzers auf der Zielmaschiene platziert. | ||
| - | - Anschließend wird das Zertifikat in den entfernten Zertifikatsspeicher importiert und die temporäre Datei gelöscht. | ||
| - | - Es wird zwischenzeitlich 2 Sekunden gewartet, da WMIC-Aufrufe asynchron ausgeführt werden. | ||
| - | - Abschließend wird das neue Zertifikat über seinen Fingerprint für den RDP-Dienst eingerichtet. | ||
| - | |||
| - | Der Aufruf von '' | ||
| - | <code powershell beispiel.ps1> | ||
| - | .\wacs.exe ` | ||
| - | --source manual ` | ||
| - | --accepttos ` | ||
| - | --baseuri https:// | ||
| - | --eab-key-identifier GFYlXahAbkl9aLbqmq8icf ` | ||
| - | --eab-key aJWvKJMVTzd1gQfSMbEhLKAKq5xmFI9WCPkM2u24M6IaVaR7dbzSRmXFRPuccdeAPEslOeBIswakMPiaPeOibB ` | ||
| - | --host fqdn.ihres.rdpservers.hs-schmalkalden.de ` | ||
| - | --installation script ` | ||
| - | --script " | ||
| - | --scriptparameters "' | ||
| - | </ | ||
| - | |||
| - | Beachten Sie, dass im Gegensatz zum obrigen Beispiel der Parameter '' | ||
| - | |||
| - | ==== Proxmox WebGUI==== | ||
| - | FIXME | ||
| - | <note important> | ||
| - | Unter dem Zertifikatsanbieter Harica noch nicht getestet! | ||
| - | |||
| - | Bei Proxmox gibt es zudem zurzeit keine Möglichkeit Drittanbieter über dei WEB-UI als ACME-Directory einzugeben. Die Anleitung ist daher eher theoretischer Natur. | ||
| - | </ | ||
| - | |||
| - | Proxmox bietet einen eingebauten ACME-Client, | ||
| - | |||
| - | - Wählen Sie in Ihrem Proxmox-Knoten Ihr '' | ||
| - | - | ||
| - | - Es öffnet sich ein Dialog '' | ||
| - | - Tragen Sie eine E-Mail-Adresse ein, die für Benachrichtigungen bspw. bei Zertifikatsausstellungen im Zusammenhang mit diesem Account dient (<fc # | ||
| - | - Wählen Sie '' | ||
| - | - Als '' | ||
| - | - Lesen und akzeptieren (<fc # | ||
| - | - Fügen Sie Ihre Account-Zugangsdaten '' | ||
| - | - Bestätigen Sie den Dialog mit dem Button '' | ||
| - | - Anschließend wird Ihnen ein Fenster mit dem Prozessstatus angezeigt. Dieses Fenster können Sie bei Abschluss oben rechts schließen (<fc # | ||
| - | - | ||
| - | - Nun wählen Sie den Knoten aus, dem Sie diesen Account zuweisen wollen (<fc # | ||
| - | - Navigieren Sie dort zum Menü '' | ||
| - | - Wählen Sie den soeben erstellten Account bei '' | ||
| - | - Fügen Sie nun mit dem Button '' | ||
| - | - Es öffnet sich der Dialog '' | ||
| - | - Belassen Sie dort den '' | ||
| - | - Fügen Sie den '' | ||
| - | - Schließen Sie den Dialog mit dem Button '' | ||
| - | - | ||
| - | - Wie Sie jetzt zur Bestätigung sehen können sollten, wurde die Domain erfolgreich hinzugefügt (<fc # | ||
| - | - Sie können weitere Domains hinzufügen, | ||
| - | - Wenn Sie alle gewünschten Domains hinzugefügt haben, beantragen Sie Ihre Zertifikate erstmalig manuell mit dem Button '' | ||
| - | - Nach Abschluss des Ausstellungsprozesses wird das Web-GUI neugestartet. {{ : | ||
| - | - Sie sollten nun zur Bestätigung Ihr ausgestelltes Zertifikat in der darüberliegenden Übersicht unter der Datei '' | ||
| - | - Vergessen Sie als Abschluss nicht, etwaige Zertifikatsausnahmen zu entfernen! | ||
| - | |||
zertifikate/pki/server-zertifikate.1775806881.txt.gz · Zuletzt geändert: von Carl Meffert
