Traefik DNS Challenge Provider (basiert auf LEGO)

Wichtig

Damit diese Integration genutzt werden kann MUSS erst ein DNS API Benutzer anhand der Anleitung (Benutzer im Kundenportal erstellen) erstellt sein!

Für Traefik existiert ebenfalls eine DNS Challenge Schnittstelle, welche mit der Servercow DNS API kommunizieren kann.

Dies ist möglich, da Traefik (ebenfalls ein GO Produkt) den LEGO Let's Encrypt Client verwendet und damit auch dessen DNS Challenge Provider.

Allerdings ist die Dokumentation dazu etwas spärlich weshalb wir diese hier mitliefern.

Achtung

Diese Anleitung erklärt NICHT die generelle Konfiguration von Traefik! Ein Grundwissen über die Konfiguration von Traefik ist vorausgesetzt!

Um eine DNS Challenge als Provider anzugeben muss diese in die traefik.yml oder traefik.toml eingefügt werden:

traefik.ymltraefik.toml

#...
certificatesResolvers:
myresolver:
    acme:
    # ...
    dnsChallenge:
        provider: servercow
        delayBeforeCheck: 0
    # ...

# ...
[certificatesResolvers.myresolver.acme]
# ...
[certificatesResolvers.myresolver.acme.dnsChallenge]
    provider = "servercow"
    delayBeforeCheck = 0
# ...

Hinweis

Damit der DNS Provider auch funktioniert. Müssen dem Traefik noch Umgebungsvariablen mitgegeben werden. Dies kann bei einer lokalen Installation einfach via export erfolgen, die gängigere Methode den Traefik zu installieren ist jedoch Docker, weswegen wir die Variablen deklaration auch anhand dieses Beispieles zeigen.

Fügen Sie einfach den Abschnitt environment in Ihrer Traefik docker-compose.yml mit diesem Inhalt hinzu oder erstellen Sie ihn:

docker-compose.yml

    #...
    environment:
      SERVERCOW_USERNAME: "IHR_API_NUTZER"
      SERVERCOW_PASSWORD: "IHR_API_NUTZER_PASSWORT"
    #...

Werden Traefik diese Informationen mitgegeben, wird er diese Credentials nutzen, um die Zertifikate per DNS Challenge über die Servercow API zu beziehen.

Erinnerung

Dienste, welche durch Traefik erreicht werden sollen müssen erst noch die DNS Challenge als Zertifikatsresolver aktivieren (per Label oder config).

Hat alles geklappt bezieht Traefik nun die Zertifikate per DNS Challenge über die Servercow DNS API.

Debugging

Wir empfehlen bei dem ersten Zertifikats Durchlauf den Debugging Modus des Traefik in der traefik.yml/traefik.toml zu aktivieren, damit Fehlermeldungen genauer analysiert werden können.