# API Troubleshooting

### Grundregel

- Bei Problemen zuerst sicherstellen, dass aB-Agenta auf die aktuelle Version aktualisiert ist. Viele Fehlerursachen sind bereits in neueren Versionen behoben.

### Logdatei prüfen

- Im Unterordner logs liegt abserverservicefx.log. Viele Fehlerursachen können hier gefunden werden.

### Service startet nicht

- Fehlkonfiguration → Einstellungen auf Korrektheit und Vollständigkeit prüfen
- Antivirus unterbindet Ausführung des Service → Ausnahme definieren

#### Service via localhost nicht erreichbar

- Port schon belegt → anderen Port ausprobieren

#### Service im LAN nicht erreichbar

- Port in Windows-Firewall gesperrt → Port öffnen via Button in Service-Einstellungen
- Port in Drittanbieter Software Firewall gesperrt → Port manuell öffnen

#### Service im WAN nicht erreichbar

- Port in Hardware-Firewall gesperrt → öffnen
- Router zwischen LAN und WAN → Port weiterleiten
- Verweist die Domain auf die korrekte öffentliche IP-Adresse?
- Ist die öffentliche IP-Adresse erreichbar?

#### Let’s Encrypt Zertifikat kann nicht ausgestellt werden

- Let’s Encrypt Port in lokaler oder Hardware-Firewall gesperrt → öffnen
- Let’s Encrypt <u>muss</u> im WAN auf Port 80 erreichbar sein. Ggf. entsprechende Port-Weiterleitung einrichten
- Service hat keine Schreibrechte auf Zertifikatsspeicher → Service als Benutzer mit Admin-Rechten betreiben

#### Anmeldung scheitert trotz korrekten Anmeldedaten

- Datenordner wurde aus Client Perspektive angegeben → aus Server Perspektive angeben
- Nicht ausreichende Zugriffsrechte auf Datenordner → Rechte für den Benutzer erteilen, der den Service ausführt
- Datenordner liegt im LAN auf Netzwerkfreigabe → der Benutzer „Lokales System“ kann nicht auf Netzwerkfreigaben zugreifen. Melden Sie den Service mit einem anderen Benutzer mit lokalen Administrator-Rechten an.
- Datenordner liegt auf Netzlaufwerk → Netzlaufwerke sind meistens für einzelne Benutzer definiert. Verwenden Sie stattdessen einen UNC-Pfad.
- Antivirus sperrt Zugriff auf Datenordner → Ausnahme definieren
- Datenordner wurde nicht (korrekt) im Service freigegeben → In Service-Einstellungen den Datenordner korrekt in **Ordner-Freigabe** eingeben. Schreibweise muss mit Datenordnereinstellung übereinstimmen. Siehe Log-Datei für erwartete Schreibweise.
- SQL-Server wurde nicht (korrekt) im Service freigegeben → In Service-Einstellungen die SQL-Server-Instanz korrekt in **SQL-Server-Freigabe** eingeben. Schreibweise muss mit Datenordnereinstellung übereinstimmen. Siehe Log-Datei für erwartete Schreibweise.

#### Kein Zugriff auf Dokumente

- Nicht ausreichende Zugriffsrechte auf ggf. *abweichenden Dokumentenordner* (Arbeitsplatzeinstellungen) → Rechte für den Benutzer erteilen, der den Service ausführt
- ggf. *abweichender Dokumentenordner* liegt im LAN auf Netzwerkfreigabe → der Benutzer „Lokales System“ kann nicht auf Netzwerkfreigaben zugreifen. Melden Sie den Service mit einem anderen Benutzer mit lokalen Administrator-Rechten an.