FAQ Verbindungsprobleme

Leitfaden zur Fehlerbehebung bei ERP-Verbindungsproblemen.

Fehlgeschlagene Verbindungstests

F: Verbindungstest schlägt mit „Connection refused“ fehl

A: Der ERP-Server akzeptiert keine Verbindungen.

Prüfen:

1. ERP-Server läuft
2. Korrekter Hostname/IP-Adresse
3. Korrekte Portnummer
4. Firewall lässt ausgehende Verbindung zu

F: Verbindungstest überschreitet Zeitlimit (Timeout)

A: Netzwerkpfad zum ERP ist blockiert oder zu langsam.

Versuchen:

1. ERP-Server vom TaprNext-Host aus anpingen
2. Firewall-Regeln prüfen
3. VPN-Verbindung prüfen (falls erforderlich)
4. Timeout-Einstellung erhöhen

F: Verbindung funktioniert manchmal, schlägt ein andermal fehl

A: Intermittierende Netzwerk- oder Lastprobleme.

Prüfen:

1. Netzwerkstabilität
2. Last/Verfügbarkeit des ERP-Servers
3. Rate Limiting der ERP-API
4. Zeitpunkt des Token-Ablaufs

Authentifizierungsfehler

F: 401 Unauthorized-Fehler

A: Anmeldedaten sind ungültig oder abgelaufen.

Bei API-Key-Authentifizierung:

1. API-Schlüssel auf Korrektheit prüfen
2. Prüfen, ob der Schlüssel nicht widerrufen wurde
3. Bei Bedarf neuen Schlüssel erzeugen

Bei OAuth:

1. Verbindung erneut autorisieren
2. Prüfen, ob das Token nicht abgelaufen ist
3. Sicherstellen, dass die OAuth-App weiterhin autorisiert ist

F: 403 Forbidden-Fehler

A: Dem Benutzer fehlen Berechtigungen.

Im ERP prüfen:

1. Benutzer hat API-Zugriff
2. Benutzer kann Rechnungen erstellen/buchen
3. Erforderliche Scopes sind freigegeben

Für D365:

• App-Registrierung hat die korrekten API-Berechtigungen
• Zugewiesene Sicherheitsrollen prüfen

Für SAP:

• Autorisierung des Kommunikationsbenutzers prüfen
• Berechtigungen für Geschäftspartner prüfen

F: Anmeldedaten funktionieren im ERP, aber nicht in TaprNext

A: Anderes Authentifizierungsverfahren oder fehlende Konfiguration.

Prüfen:

1. Korrekter Auth-Typ (API-Schlüssel vs. OAuth)
2. Alle erforderlichen Felder sind ausgefüllt
3. Keine überzähligen Leerzeichen in den Anmeldedaten
4. Korrekte API-Endpoint-URL

SSL/TLS-Probleme

F: „SSL certificate verification failed“

A: Zertifikatsproblem auf dem ERP-Server.

Prüfen:

1. Zertifikat ist nicht abgelaufen
2. Zertifikat stimmt mit dem Hostnamen überein
3. Zertifikatskette ist vollständig

Bei selbstsignierten Zertifikaten:

1. Zertifikat exportieren
2. In den vertrauenswürdigen Zertifikaten von TaprNext hinterlegen
3. Oder Verifizierung deaktivieren (für Produktivumgebungen nicht empfohlen)

F: „TLS handshake failed“

A: TLS-Versionskonflikt.

Prüfen:

1. ERP unterstützt TLS 1.2 oder höher
2. Keine Konflikte bei Cipher Suites
3. Kein Netzwerkgerät fängt die Verbindung ab

Firewall- und Netzwerkprobleme

F: Verbindung vom Browser aus möglich, aber nicht von TaprNext

A: Server-seitige Firewall oder Netzwerkkonfiguration.

Prüfen:

1. IP des TaprNext-Servers ist freigeschaltet (Whitelist)
2. Ausgehende Ports sind offen (443, 8080 usw.)
3. Kein Proxy blockiert die Verbindung
4. VPN-Anforderungen sind erfüllt

F: Verbindung funktioniert lokal, aber nicht in der Produktion

A: Andere Netzwerkkonfiguration.

Vergleichen:

1. DNS-Auflösung
2. Firewall-Regeln
3. Proxy-Einstellungen
4. VPN-/Tunnel-Anforderungen

Rotation von Anmeldedaten

F: Wie oft sollten API-Schlüssel rotiert werden?

A: Folgen Sie Ihrer Sicherheitsrichtlinie, typischerweise:

• Alle 90 Tage in der Produktion
• Sofort bei Kompromittierung
• Nach Personalwechseln

F: Wie rotiere ich ohne Ausfallzeit?

A:

1. Neue Anmeldedaten im ERP erzeugen
2. TaprNext-Einstellungen aktualisieren
3. Verbindung testen
4. Alte Anmeldedaten widerrufen

F: OAuth-Token läuft ständig ab

A: Refresh-Token ist möglicherweise ungültig.

Versuchen:

1. OAuth trennen und erneut verbinden
2. Mit frischer Zustimmung erneut autorisieren
3. OAuth-App-Konfiguration prüfen

Verbindungen testen

Kurze Test-Checkliste

1. Grundlegende Erreichbarkeit — Erreichen Sie die ERP-URL im Browser?
2. Authentifizierung — Funktionieren die Anmeldedaten direkt gegen die ERP-API?
3. Berechtigungen — Kann der Benutzer im ERP direkt Rechnungen erstellen?
4. Netzwerkpfad — Stehen Firewalls, Proxys oder VPNs im Weg?

Verbindungstest in TaprNext

1. Navigieren Sie zu Tapr Settings > ERP Connection
2. Klicken Sie auf Test Connection
3. Ergebnis prüfen:
   • ✓ Erfolgreich verbunden
   • ✗ Fehlermeldung mit Details

Verwandte Themen

• Fehlerreferenz — Vollständiger Fehlerkatalog
• ERPNext-Verbindung — ERPNext-Einrichtung
• D365-Verbindung — D365-Einrichtung