Connectors

Verbinde externe Datenquellen und importiere Inhalte automatisch in deinen Vault.

Was sind Connectors?

Connectors sind periodische Datenquellen die Inhalte aus externen Systemen in einen Vault ingesten. Du konfigurierst Credentials, Filter und Zeitplan — alles laeuft im Hintergrund. Neue und geaenderte Inhalte werden automatisch erkannt und durch die Extraction-Pipeline verarbeitet.

Verfuegbare Connector-Typen

RSS / Atom Feed

Periodisch Artikel aus RSS- oder Atom-Feeds importieren. Nachrichten, Blogs, Pressemitteilungen. Keine Credentials noetig — oeffentliche Feeds.

GitHub

Issues, PRs, Code und Markdown-Dokumente aus GitHub-Repositories importieren. Unterstuetzt mehrere Repos, Folder-Filter, Datei-Patterns und Branch-Auswahl. Authentifizierung via Personal Access Token.

Confluence

Seiten aus Confluence Spaces importieren. Optional mit Label-Filter. Authentifizierung via Atlassian Email + API Token.

Jira

Issues aus Jira-Projekten importieren. Filter nach Issue-Typ oder eigener JQL-Query. Summary, Beschreibung, Status, Labels und Kommentare werden extrahiert. Authentifizierung via Atlassian Email + API Token.

Sync-Zyklen

Jeder Connector hat einen konfigurierbaren Sync-Zyklus:

Stuendlich: Fuer schnelllebige Quellen (RSS-Feeds, aktive Repos)
Alle 6 Stunden: Guter Kompromiss fuer die meisten Quellen
Taeglich: Fuer Quellen mit wenigen Aenderungen (Confluence-Docs)
Woechentlich: Fuer stabile Quellen (Architektur-Docs, ADRs)

Connector einrichten

Gehe zur Vault-Detailseite und scrolle zur "Connectors" Sektion.
Klicke "Connector hinzufuegen" und waehle den Typ.
Konfiguriere die Verbindung (URL, Credentials, Filter).
Waehle den Sync-Zyklus (stuendlich bis woechentlich).
Klicke "Connector aktivieren" — der erste Sync startet sofort.

Fehlerbehandlung

Wenn ein Sync fehlschlaegt, wird er automatisch bis zu 3x wiederholt (mit wachsendem Abstand). Nach 3 Fehlern wird der Connector auf "Fehler"-Status gesetzt und pausiert. Du kannst den Fehler in der Sync-History einsehen und den Connector manuell fortsetzen.

Sicherheit

Credentials (API-Tokens, Passwoerter) werden mit dem Vault-DEK verschluesselt gespeichert (AES-256-GCM). Nur der Sync-Worker kann sie entschluesseln — sie sind nie im Klartext in der Datenbank oder in Logs sichtbar.

Maximal 15 Connectors pro Vault. Jeder Sync-Lauf wird in der Sync-History protokolliert.

Source-Tracking

Jeder importierte Fakt behaelt eine Referenz zur Originalquelle (source_ref). Das ist die URL zum Originaldokument — zum Confluence-Artikel, GitHub-Issue oder RSS-Eintrag. So kannst du jeden Fakt in deinem Vault bis zur Quelle zurueckverfolgen.