Wechseln zu:Navigation, Suche
Wiki

UTM/AUTH/Zertifikate-ACME: Unterschied zwischen den Versionen

Aus Securepoint Wiki
Keine Bearbeitungszusammenfassung
Markierung: Manuelle Zurücksetzung
KKeine Bearbeitungszusammenfassung
Zeile 4: Zeile 4:
{{#vardefine:headerIcon|spicon-utm}}
{{#vardefine:headerIcon|spicon-utm}}
{{:UTM/AUTH/Zertifikate.lang}} <!-- Die Variablen für ACME-Zertifikate sind im ganzen Dokument verstreut und werden mehrfach verwendet -->
{{:UTM/AUTH/Zertifikate.lang}} <!-- Die Variablen für ACME-Zertifikate sind im ganzen Dokument verstreut und werden mehrfach verwendet -->
{{:UTM/AUTH/Zertifikate-ACME.lang}}


{{var | noinclude--ACME Zertifikate--desc
| Ab v12 können auf der UTM auch ACME Zertifikate (zunächst von Let's Encrypt) verwendet werden.<br>Dazu ist Verwendung eines spDyn Accounts erforderlich.
| As of v12, ACME certificates (initially from Let's Encrypt) can also be used on the UTM.<br>The use of an spDyn account is required for this. }}
{{var | noinclude--neu-v12
| Unterstützung von ACME Zertifikaten (Let's Encrypt) in v12
| Support of ACME certificates (Let's Encrypt) in v12 }}
{{var | noinclude--head
| Unterstützung von ACME Zertifikaten (Let's Encrypt)
| Support of ACME certificates (Let's Encrypt) }}
{{var | noinclude--display
| ACME Zertifikate
| ACME certificates }}
{{var | neu--Wildcard-SANs
| Es sind auch [[#{{#var:SAN--hinzufügen--cap}} | Wildacard SANs]] möglich
| [[#{{#var:SAN--hinzufügen--cap}} | Wildacard SANs]] are also possible }}
{{var | neu--ACME Zertifikat Zone CNAME
| Hinweis bei [[#Konfiguration_prüfen | DNS Fehler bei ACME Zertifikat und Nameserver]] in gleicher Zone einer Domain
| Note for [[#Check_configuration | DNS error for ACME certificate and name server]] in the same zone of a domain }}
{{var | Fehlerbehandlung
| Fehlerbehandlung
| Error handling }}
{{var | Fehlerbehandlung--desc
| Folgende Statuswerte können auftreten
| The following status values can occur }}
{{var | Hinweis
| Hinweis
| Note }}
{{var | Valid
| Gültig
| Valid }}
{{var | Valid--desc
| Das ACME Zertifikat ist gültig
| The ACME certificate is valid }}
{{var | Not yet verified
| Noch nicht überprüft
| Not yet verified }}
{{var | Not yet verified--desc
| Das ACME Zertifikat muss noch überprüft werden
| The ACME certificate still needs to be verified }}
{{var | Internal error
| Interner Fehler
| Internal error }}
{{var | Internal error--desc
| Ein interner Fehler ist aufgetreten
| An internal error has occurred }}
{{var | Internal error--Hinweis
| Mögliche Ursachen:
* Kaputte Hardware
* Softwarefehler
* Konfigurationsfehler
| Possible causes:
* Broken hardware
* Software error
* Configuration error }}
{{var | Connection error
| Verbindungsfehler
| Connection error }}
{{var | Connection error--desc
| Keine Verbindung möglich/vorhanden
| No connection possible / present }}
{{var | Connection error--Hinweis
| Die Verbindungseinstellungen überprüfen
| Check the connection settings }}
{{var | Invalid
| Ungültig
| Invalid }}
{{var | Invalid--desc
| Das ACME Zertifikat ist ungültig und kann nicht verwendet werden
| The ACME certificate is invalid and cannot be used }}
{{var | DNS error
| DNS-Fehler
| DNS error }}
{{var | DNS error--desc
| Ein DNS-Fehler ist aufgetreten
| A DNS error has occurred }}
{{var | DNS error--Hinweis
| Mögliche Ursachen:
* falscher Token
* DNS Auflösung gestört
* Zonen Weiterleitung im DNS konfiguriert
* lokale DNS-Zone im DNS konfiguriert
| Possible causes:
* wrong token
* DNS resolution disrupted
* zone forwarding configured in DNS
* local DNS zone configured in DNS }}
{{var | Banned
| Widerrufen
| Banned }}
{{var | Banned--desc
| Das ACME Zertifikat ist widerrufen worden
| The ACME certificate has been revoked }}
{{var | Banned--Hinweis
| Entweder wurde es manuell widerrufen, oder es hat seine Gültigkeit verloren. Zum Beispiel ist das ACME Zertifikat ausgelaufen und wurde nicht verlängert.
| Either it has been manually revoked, or it has lost its validity. For example, the ACME certificate expired and was not renewed. }}
{{var | Initializing
| Initialisieren
| Initializing }}
{{var | Initializing--desc
| Die Überprüfung des ACME Zertifikats wird eingeleitet
| The verification of the ACME certificate is initiated }}
{{var | Initializing--Hinweis
| Dies kann mehrere Minuten in Anspruch nehmen. Der Status wird regelmäßig aktualisiert.
| This can take several minutes. The status is updated regularly. }}
{{var | Deferred
| Aufgeschoben
| Deferred }}
{{var | Deferred--desc
| Die Überprüfung des ACME Zertifikats wird verschoben
| The verification of the ACME certificate is postponed }}
{{var | Deferred--Hinweis
| Die Aktualisierung des Status wird einige Zeit in Anspruch nehmen, da das Limit der Anfragen bereits erreicht wurde
| Refreshing the status will take some time, since the limit of requests was already reached }}
{{var | Initialized
| Initialisiert
| Initialized }}
{{var | Initialized--desc
| Das ACME Zertifikat wird überprüft
| The ACME certificate is being verified }}
{{var | neu--Verlängerung ACME
| Aktualisierung der [[#Verlängerung_der_ACME_Zertifikate | Verlängerung der ACME-Zertifikate]]
| Updating [[#Renewal_of_ACME_certificates | renewal of ACME certificates]] }}
{{var | neu--Reiter ACME
| [[#Allgemein | Aktualisierung vom Reiter ACME]]
| [[#General | Update from ACME tab]] }}
{{var | neu--Nameserver ACME
| [[#ACME_Zertifikate_(Let's_Encrypt) | Nameserver für ACME-Challenges]]
| [[#ACME_Certificates_(Let's_Encrypt) | Nameserver for ACME-Challenges]] }}
{{var | neu--Fehlerbehandlung
{{var | neu--Fehlerbehandlung
| [[#Fehlerbehandlung | Fehlerbehandlung]]
| Neuer Abschnitt: [[#Statuswerte | Statuswerte]]
| [[#Error_handling | Error handling]] }}
| New section: [[#Status values | Status values]] }}
{{var | neu--Schlüssellänge
| Neue Default-Länge für Zertifikats-Schlüssel: 3072 Bit
| New default length for certificate keys: 3072 Bit }}


</div><noinclude>{{Select_lang}}{{TOC2}}
</div><noinclude>{{Select_lang}}{{TOC2}}
{{Header|12.4|
{{Header|12.5.1|
* {{#var:neu--Fehlerbehandlung}}
* {{#var:neu--Schlüssellänge}}
* {{#var:neu--Nameserver ACME}}
* {{#var:neu--Fehlerbehandlung}} <small>(07.2023)</small>
|[[UTM/AUTH/Zertifikate-ACME_v12.4 | 12.4 ]]
| display={{#var:noinclude--display}} }}
| display={{#var:noinclude--display}} }}


Zeile 165: Zeile 38:
| {{b|{{#var:Systemweite Nameserver ACME}} }} || {{ButtonAn|{{#var:ja}} }} || {{#var:Systemweite Nameserver ACME--desc}}
| {{b|{{#var:Systemweite Nameserver ACME}} }} || {{ButtonAn|{{#var:ja}} }} || {{#var:Systemweite Nameserver ACME--desc}}
|-
|-
| {{b|{{#var:Nameserver ACME}} }}<br><small>{{#var:Nameserver ACME eingeblendet}}</small> || {{ic|{{cb|85.209.185.50}}{{cb|85.209.185.51}}{{cb|2a09:9c40:1:53::1}}{{cb|2a09:9c40:1:53::2}}|cb}} || {{#var:Nameserver ACME--desc}}
| {{b|{{#var:Nameserver ACME}} }}<br><small>{{#var:Nameserver ACME eingeblendet}}</small> || {{ic|{{cb|85.209.185.50}}{{cb|85.209.185.51}}{{cb|2a09:9c40:1:53::1}}{{cb|2a09:9c40:1:53::2}}|cb|class=mw5}} || {{#var:Nameserver ACME--desc}}
|- class="Leerzeile"
|- class="Leerzeile"
|
|
Zeile 288: Zeile 161:
|
|
|- class="Leerzeile"
|- class="Leerzeile"
| colspan="3"| {{h-3|{{#var:Fehlerbehandlung}}|{{#var:Fehlerbehandlung}}|NOTOC={{{NOTOC|}}} }}
| colspan="3"| {{h-3|{{#var:Statuswerte}}|{{#var:Statuswerte}} {{Hinweis-box||gr|12.5|status=neu}}|NOTOC={{{NOTOC|}}} }}
|- class="Leerzeile"
|- class="Leerzeile"
| colspan="3"| {{#var:Fehlerbehandlung--desc}}
| colspan="3"| {{#var:Statuswerte--desc}}
|-
|-
! class="mw12"| Status !! class="mw12"|  {{#var:desc}} !! {{#var:Hinweis}}
! class="mw12"| Status !! class="mw12"|  {{#var:desc}} !! {{#var:Hinweis}}

Version vom 7. September 2023, 14:15 Uhr








































S
























































































































De.png
En.png
Fr.png









Erstellen und Verwalten von Zertifikaten

Letzte Anpassung zur Version: 12.5.1

Neu:
  • Neue Default-Länge für Zertifikats-Schlüssel: 3072 Bit
  • Neuer Abschnitt: Statuswerte (07.2023)
notempty
Dieser Artikel bezieht sich auf eine Resellerpreview



ACME Zertifikate (Let's Encrypt)

→ Authentifizierung →ZertifikateReiter ACME


Beschriftung Wert Beschreibung UTM v12.6 Zertifikate ACME Nameserver.png
╭╴Allgemein ╶╮
Aktiviert: Ja Aktiviert die Nutzung von ACME-Zertifikaten.
Weitere Informationen siehe unten ACME Dienst aktivieren.
Systemweite Nameserver für ACME-Challenges verwenden: Ja Sollten die Adressen für die Server zur Verlängerung der ACME-Challenges nicht über den systemweiten Nameserver aufgelöst werden können (z.B. wg. konfigurierter Relay- oder Foreward-Zonen) können bei Deaktivierung Nein alternative Nameserver eingetragen werden.
Nameserver für ACME-Challenges:
Bei deaktivierten systemweiten Nameserver für ACME-Challenges nutzbar		 »85.209.185.50»85.209.185.51»2a09:9c40:1:53::1»2a09:9c40:1:53::2 Hier lassen sich die Nameserver für die ACME-Challenges eintragen.


ACME Dienst aktivieren

ACME Dienst aktivieren

Um ACME Zertifikate nutzen zu können, muss dies unter Authentifizierung Zertifikate  Bereich ACME Aktiviert: Ja aktiviert werden.

  • Sobald der Dienst aktiviert wurde und dies mit
    gespeichert wurde, wird der Link zu den Nutzungsbedingungen geladen und es lassen sich die Einstellungen aufrufen.
  • Mit der Schaltfläche Aktivieren Ja und dem Hinterlegen einer E-Mail Adresse für Benachrichtigungen durch den ACME Dienstanbieter (hier: Let's Encrypt) lassen sich die Angaben unter
    speichern.
  • Daraufhin wird ein Dialog eingeblendet mit einem Link zu den Nutzungsbedingungen, die akzeptiert Ja werden müssen.


Token generieren

Token generieren

spDYN Für die Erzeugung der Zertifikate ist zunächst der ACME-Token im spDYN Portal zu generieren.
Innerhalb des spDYN-Portals ist der entsprechende Host zu öffnen.

  • spDyn Host aufrufen
  • Im Dropdown Menü für Token den ACME Challenge Token wählen
  • Token generieren
    notempty
    Der Token wird einmal bei der Generierung angezeigt und kann nicht erneut angezeigt werden.

    Der Token sollte notiert und sicher aufbewahrt werden.

Verlängerung der ACME Zertifikate

Verlängerung der ACME Zertifikate
notempty
Neu ab 12.4
 Die Verlängerung der ACME/Let's Encrypt Zertifikate findet über die verwendeten Nameserver, welche unter Authentizifierung Zertifikate  Bereich ACME (siehe oben) konfiguriert werden, statt.


ACME-Zertifikate

ACME-Zertifikate
Nach Abschluss der vorherigen Schritte kann nun das eigentliche Zertifikat erzeugt werden. Ein Klick im Bereich Zertifikate auf ACME-Zertifikat hinzufügen öffnet den entsprechenden Dialog.
Beschriftung Wert Beschreibung UTM v12.6 Zertifikate ACME hinzufuegen.png
ACME-Zertifikat hinzufügen

ACME-Zertifikat hinzufügen

UTM Dialog → Authentifizierung →ZertifikateReiter Zertifikate Schaltfläche ACME-Zertifikat hinzufügen
Name ttt-Point Name zur Identifizierung des Zertifikates
Schlüssellänge: 2048 Schlüssellänge des Zertifikates. Mögliche Werte:
ACME Account Let's Encrypt ACME Account der verwendet werden soll
Subject Alternative Name konfigurieren mit SAN hinzufügen

Subject Alternative Name hinzufügen

Subject Alternative Name »ttt-point.spdns.org Der Subject Alternative Name (SAN) wird im Zertifikat hinterlegt und entspricht der aufgerufenen URL UTM v12.6 Zertifikate ACME SAN.png
Subject Alternative Name hinzufügen
»*.ttt-point.spdns.org
  • Es können auch Wildcard-SANs verwendet werden.
  • Für die Verwendung mit einem Captive Portal werden Wildcard-Zertifikate benötigt
    Wird für das Captive Portal im Nameserver eine Forward-Zone benötigt und für diese dann ein A-Record eingetragen, wird dieser nicht mehr im öffentlichen DNS aufgelöst.
    Die Überprüfung und Verlängerung eines ACME-Zertifikates auf diesen Namen schlägt dann fehl.
    • Alias ttt-point.spdns.org Ist der SAN ein spDYN Hostname wird er automatisch als Alias übernommen.
    (Auch bei Wildcard-Domännen ohne * )
    Token ••••••••••••• Der Token aus dem spDYN-Portal (s.o.) belegt dem ACME-Dienst, daß man über den Hostnamen verfügen darf.
    zeigt den Token an.
    Beim Einfügen des Tokens aus der Zwischenablage kann es vorkommen, daß vor oder nach dem eigentlichen Token Leerzeichen enthalten sind. Diese müssen entfernt werden
    Speichern

    Konfiguration prüfen

    Konfiguration prüfen
    Status Noch nicht geprüft Vor der eigentlichen Generierung des Zertifiaktes muss zunächst die Konfiguration geprüft werden. Dies erfolgt durch einen Klick auf die Schaltfläche Konfiguration prüfen. UTM v12.6 Zertifikate ACME SAN initialisiert.png
    initialisieren
    Initialisiert    		 Die Überprüfung kann mehrere Minuten in Anspruch nehmen. Dabei wird der Dialog regelmäßig aktualisiert.
    Gültig Ist die Überprüfung erfolgreich wird der Status Gültig angezeigt.
    DNS Fehler Mögliche Ursachen:
    • falscher Token
    • DNS Auflösung gestört
    • Zonen Weiterleitung im DNS konfiguriert
    • lokale DNS-Zone im DNS konfiguriert
    • Falls im Nameserver der UTM eine Zone für eine Domain liegt, welche auch das ACME-Zertifikat nutzt, schlägt die DNS Auflösung fehl. Lösung: Für diese Zone einen CNAME-Eintrag für diese Domain erstellen.
      • Unter Menu/Anwendungen/Nameserver/Zonen nach der Zone suchen
      • auf Bearbeiten klicken
      • Im Fenster auf +Eintrag hinzufügen klicken
      • unter Name: einen passenden Namen eintragen
      • bei Typ: CNAME auswählen
      • bei Wert: die Domaine eintragen
    Subject Alternative Name für eine externe DNS-Zone konfigurieren mit SAN hinzufügen

    SAN für externe DNS-Zone hinzufügen

    Subject Alternative Name ttt-point.anyideas.org Der Subject Alternative Name (SAN) aus der externen DNS-Zone UTM v12.6 Zertifikate ACME SAN extern.png
    Alias ttt-point.spdns.org Der Alias muss auch für die externe DNS auf den spDYN Namen lauten.
    DNS-Provider Beim DNS-Provider, der die externe Zone hostet (hier: ttt-point.anyideas.org) muss ein zusätzlicher CNAME-Record mit dem Prefix _acme-challenge und dem anschließenden Hostnamen angelegt werden und entsprechend auf den zugehörigen spDYN-Record mit vorangestellten _acme-challenge verwiesen. _acme-challenge.ttt-point.spdns.org. (Mit "." am Ende!)
    Ein beispielhafter Auszug aus einem Zonefile für die Konfiguration der beiden Hostnamen mx.ttt-point.de und exchange.ttt-point.de sieht wie folgt aus:
    _acme-challenge.mx.ttt-point.anyideas.org. IN CNAME _acme-challenge.ttt-point.spdns.org.
_acme-challenge.exchange.ttt-point.anyideas.org. IN CNAME _acme-challenge.ttt-point.spdns.org.

  • Der Hostname muss im öffentlichen DNS auflösbar sein.
    Die Erstellung von Zertifkaten für .local, .lan, etc. Zonen ist nicht möglich.
  • Die UTM muss den Hostnamen über externe Nameserver korrekt auflösen können.
    notempty
    Ist die interne und die externe/öffentliche Domain identisch, sollte ein Wildcard-ACME-Zertifikat verwendet werden.
    Beispiel: Hostname für das Captive Portal: portal.ttt-point.de → ACME Zertifikat: *.ttt-point.de
    • Konfiguration prüfen Weitere SANs können hinzugefügt und geprüft werden, solang die Schaltfläche
    noch nicht betätigt wurde.    		 UTM v12.6 Zertifikate ACME SAN überprüft.png
    Status Gültig Sind alle benötigten SAN erfolgreich geprüft, kann das Zertifikat gespeichert werden. UTM v12.6 Zertifikate ACME SAN gültig.png
    Speichern notempty
    Nach dem Speichern des Zertifikates lassen sich keine Änderungen mehr vornehmen. Es kann lediglich bei bestehenden SANs der Alias und der Token geändert werden.
  • Werden zusätzliche oder andere SANs benötigt muss ein neues Zertifikat angelegt und das Bestehende widerrufen werden.

    • Erstellung des ACME Zertifikates

    Erstellung des ACME Zertifikates
    Speichern Wurden die vorherigen Schritte erfolgreich abgeschlossen wird durch einen Klick auf Speichern der eigentliche Prozess zur Validierung und Generierung des Zertifikates angestoßen.


    Dieser Vorgang kann einige Zeit in Anspruch nehmen. Um den Status zu aktualiseren ist der Dialog manuell neu zu laden.

    		UTM v12.6 Zertifikate ACME SAN final.png

    Statuswerte

    Statuswerte
    Folgende Statuswerte können auftreten
    Status Beschreibung Hinweis / Fehlerbehandlung
    Gültig Das ACME Zertifikat ist gültig
    Noch nicht überprüft Das ACME Zertifikat muss noch überprüft werden
    Interner Fehler Ein interner Fehler ist aufgetreten Mögliche Ursachen:
    • Kaputte Hardware
    • Softwarefehler
    • Konfigurationsfehler
    Verbindungsfehler Keine Verbindung möglich/vorhanden Die Verbindungseinstellungen überprüfen
    Ungültig Das ACME Zertifikat ist ungültig und kann nicht verwendet werden
    DNS-Fehler Ein DNS-Fehler ist aufgetreten Mögliche Ursachen:
    • falscher Token
    • DNS Auflösung gestört
    • Zonen Weiterleitung im DNS konfiguriert
    • lokale DNS-Zone im DNS konfiguriert
    • Falls im Nameserver der UTM eine Zone für eine Domain liegt, welche auch das ACME-Zertifikat nutzt, schlägt die DNS Auflösung fehl. Lösung: Für diese Zone einen CNAME-Eintrag für diese Domain erstellen.
      • Unter Menu/Anwendungen/Nameserver/Zonen nach der Zone suchen
      • auf Bearbeiten klicken
      • Im Fenster auf +Eintrag hinzufügen klicken
      • unter Name: einen passenden Namen eintragen
      • bei Typ: CNAME auswählen
      • bei Wert: die Domaine eintragen
    Widerrufen Das ACME Zertifikat ist widerrufen worden Entweder wurde es manuell widerrufen, oder es hat seine Gültigkeit verloren. Zum Beispiel ist das ACME Zertifikat ausgelaufen und wurde nicht verlängert.
    Initialisieren Die Überprüfung des ACME Zertifikats wird eingeleitet Dies kann mehrere Minuten in Anspruch nehmen. Der Status wird regelmäßig aktualisiert.
    Aufgeschoben Die Überprüfung des ACME Zertifikats wird verschoben Die Aktualisierung des Status wird einige Zeit in Anspruch nehmen, da das Limit der Anfragen bereits erreicht wurde
    Initialisiert Das ACME Zertifikat wird überprüft Die Überprüfung des ACME Zertifikats wird eingeleitet
    Abgerufen von „https://wiki.securepoint.de/index.php?title=UTM/AUTH/Zertifikate-ACME&oldid=87434“