Konnektor-Fehler beheben¶

Häufige Fehler und Lösungen¶

Authentifizierungsfehler¶

Fehlermeldung: Authentication failed oder 401 Unauthorized

Konnektor	Prüfen
SharePoint	Client Secret abgelaufen? Im Azure Portal erneuern
Confluence	Passwort geändert oder Konto gesperrt? Benutzername und Passwort im Konnektor neu hinterlegen
GitHub	PAT abgelaufen? Neuen Token erstellen

Lösung: Konnektor bearbeiten → Neue Zugangsdaten (Token, Passwort oder Secret) eingeben → Verbindung testen → Speichern.

Zugriffsfehler¶

Fehlermeldung: 403 Forbidden oder Access denied

Die Zugangsdaten haben nicht ausreichend Berechtigungen
SharePoint: App Registration benötigt Sites.Read.All Permission
GitHub: PAT benötigt repo oder contents:read Scope
Confluence: Benutzer benötigt Lesezugriff auf den Space

Netzwerkfehler¶

Fehlermeldung: Connection timeout oder DNS resolution failed

Prüfen Sie, ob die Quell-URL erreichbar ist
Bei On-Premise-Confluence/GitHub: VPN oder Firewall-Regeln prüfen
Wenden Sie sich an Ihren IT-Administrator

Keine neuen Dokumente nach Sync¶

Ursache	Lösung
Pfad-Filter zu restriktiv	Konnektor bearbeiten und Pfad-Filter anpassen
Keine neuen/geänderten Dateien	Erwartet — nur geänderte Dateien werden synchronisiert
Nicht unterstütztes Dateiformat	Siehe Unterstützte Dateiformate

Gelöschte oder verschobene Dateien werden weiterhin gefunden¶

Lösen Sie auf der Konnektor-Detailseite „Komplett neu synchronisieren" aus. Die Aktion gleicht den Bestand mit dem Quellsystem ab und entfernt Dokumente, die dort nicht mehr vorhanden sind oder nicht mehr zu Ordnerpfad und Dateimustern passen (seit Release 0.83.12). Details: Synchronisation starten und überwachen.

Zugriffsgruppen speichern oder Konnektor löschen schlägt fehl¶

Kann die Wissensdatenbank eine Änderung der Zugriffsgruppen oder das Entfernen der Dokumente gerade nicht übernehmen, zeigt das Customer Portal eine Fehlermeldung an. Die Änderung wird dann nicht gespeichert bzw. der Konnektor nicht gelöscht — es entsteht also kein Zustand, in dem Einstellungen und Wissensdatenbank auseinanderlaufen. Versuchen Sie es nach einigen Minuten erneut; bleibt der Fehler bestehen, wenden Sie sich an Ihren Administrator.

Konnektor neu einrichten¶

Wenn ein Konnektor dauerhaft Probleme macht:

Löschen Sie den fehlerhaften Konnektor
Erstellen Sie einen neuen mit korrigierten Einstellungen
Führen Sie eine vollständige Synchronisation durch

Tipp

Nutzen Sie immer den Verbindungstest vor dem Speichern, um Konfigurationsfehler frühzeitig zu erkennen.