Zum Inhalt

Knowledge Base · Kategorie 15

Fehlerbehebung

10 Artikel

Schlägt eine Ausstellung oder Erneuerung fehl, zeigt TLSPilot den Fehler mit den Details der CA im Ergebnisdialog, und der Tooltip von Next action zeigt Fix error, then Force renew. Die folgenden Tabellen sind nach Bereich sortiert. Für jedes Symptom zeigen sie die Meldung von TLSPilot, die Ursache und die Lösung. Texte in spitzen Klammern, zum Beispiel <name>, füllt TLSPilot aus. Wo Sie die Meldungen finden, beschreibt Kapitel Fehlerbehebung: Logs und Diagnose.

Artikel in dieser Kategorie

  1. 15.1

    Fehlerbehebung: ACME

    Bei einem Fehler der Bestellung zeigt TLSPilot den Fehlertyp der CA, zum Beispiel urn:ietf:params:acme:error:rateLimited, gefolgt von den Details.

  2. 15.2

    Fehlerbehebung: DNS-01

    Bei DNS-01 erstellt TLSPilot beim DNS-Provider einen TXT-Record _acme-challenge.<name>, wartet auf die Propagation, lässt ihn von der CA validieren und löscht ihn wieder.

  3. 15.3

    Fehlerbehebung: HTTP-01 und TLS-ALPN-01

    Bei HTTP-01 ruft die CA http://<public-name>/.well-known/acme-challenge/… ab. TLSPilot veröffentlicht die Datei mit der für das Zertifikat gewählten Option: Listener on this management host (port 80), Local webroot on this management host, Remote Windows web server (WinRM) oder Remote Linux web server (SSH).

  4. 15.4

    Fehlerbehebung: Deployment-Ziele

    Ein fehlgeschlagenes Deployment wird als Event 1302 protokolliert, ein fehlgeschlagener Health-Check als Event 1322.

  5. 15.5

    Fehlerbehebung: RBAC, Entra ID und Break-the-glass

    Zugriffsfehler werden im Kanal Audit protokolliert. Mitglieder der lokalen Gruppe Administrators auf dem Management-Host können sich immer als Break-the-glass-Owner anmelden, solange diese Einstellung eingeschaltet ist.

  6. 15.6

    Fehlerbehebung: WebUI und HTTPS-Bindung

    Die WebUI läuft als Windows-Dienst iTrainTLSPilotWebService. Ihr Log ist %ProgramData%\iTrain\TLSPilot\logs\webservice-<date>.log.

  7. 15.7

    Fehlerbehebung: Dienst und täglicher Zyklus

    Der Management-Dienst iTrainTLSPilotMgmtService führt den täglichen Zyklus aus. Sein Log ist %ProgramData%\iTrain\TLSPilot\logs\service-<date>.log (30 Tage aufbewahrt).

  8. 15.8

    Fehlerbehebung: Lizenz und Aktivierung

    Lizenz-Events werden im Kanal Operational protokolliert (1530–1538). Die Aktivierung braucht HTTPS-Zugriff auf license.itrain.ch.

  9. 15.9

    Fehlerbehebung: PowerShell-Modul

    Das Modul braucht Windows PowerShell 5.1 oder neuer und verbindet sich mit der Management-API, standardmässig http://127.0.0.1:5188, siehe Kapitel Modul importieren und Verbindung prüfen.

  10. 15.10

    Fehlerbehebung: Logs und Diagnose

    TLSPilot schreibt Events in die Windows-Ereignisanzeige und in Logdateien. Die Logs sind auch in der Desktop Admin Console unter Tools → View logs & audit… verfügbar, siehe Kapitel Logging, sowie mit Get-TLSPilotLog.