Zum Hauptinhalt springen

Atlassian Jira & Confluence

Mit dieser Integration können Inhalte aus Atlassian Confluence (Wiki-Seiten, Dokumentation) und Jira (Tickets, Projekte) automatisch in den AI Hub synchronisiert werden.

Voraussetzungen​

Für die Verbindung wird ein API-Token von Atlassian benötigt.

API-Token erstellen​

  1. Öffnen Sie die Atlassian API-Token-Verwaltung.
  2. Melden Sie sich mit dem Account an, der Zugriff auf die gewünschte Confluence- oder Jira-Instanz hat.
  3. Klicken Sie auf API-Token erstellen.
  4. Vergeben Sie eine aussagekräftige Bezeichnung (z. B. „AI Hub Integration").
  5. Klicken Sie auf Erstellen und kopieren Sie den Token. Speichern Sie den Token sicher — er wird nur einmal angezeigt.
warnung

Verwenden Sie einen API-Token ohne eingeschränkte Berechtigungen (Scopes). OAuth-Tokens oder Tokens mit spezifischen Scopes werden nicht unterstützt.

tipp

Für produktive Integrationen empfiehlt es sich, einen dedizierten Service-Account mit eigenem Token zu verwenden, anstatt ein persönliches Konto zu nutzen. So bleibt der Zugriff erhalten, auch wenn einzelne Mitarbeiter das Unternehmen verlassen.

Sicherheitshinweise​

  • Behandeln Sie den API-Token wie ein Passwort.
  • Wird ein Token nicht mehr benötigt oder kompromittiert, kann er jederzeit über die API-Token-Verwaltung widerrufen werden.

Konfiguration​

Confluence​

  • Confluence URL: Die vollständige URL der Confluence-Instanz (z. B. https://beispiel.atlassian.net/wiki). Muss mit http:// oder https:// beginnen.
  • Authentifizierungstyp: Basic-Auth (empfohlen) oder Bearer-Token.
  • Benutzername (bei Basic-Auth): Die E-Mail-Adresse des Accounts, der den API-Token erstellt hat.
  • Access Token: Der erstellte API-Token.
  • Spaces (optional): Auswahl bestimmter Spaces, die synchronisiert werden sollen. Wird dieses Feld leer gelassen, werden alle verfügbaren Spaces synchronisiert.

Nach Eingabe gültiger Zugangsdaten werden die verfügbaren Spaces automatisch geladen und können ausgewählt werden.

Jira​

  • Jira URL: Die vollständige URL der Jira-Instanz (z. B. https://beispiel.atlassian.net). Bei selbst gehosteten Instanzen muss /jira am Ende angefügt werden.
  • Authentifizierungstyp: Basic-Auth (empfohlen) oder Bearer-Token.
  • Benutzername (bei Basic-Auth): Die E-Mail-Adresse des Accounts, der den API-Token erstellt hat.
  • Access Token: Der erstellte API-Token.
  • Projekte (optional): Auswahl bestimmter Projekte, die synchronisiert werden sollen. Wird dieses Feld leer gelassen, werden alle verfügbaren Projekte synchronisiert.
  • V2 API verwenden (optional): Nur für selbst gehostete Jira-Instanzen aktivieren, die die Jira v3 API nicht unterstützen. Jira Cloud unterstützt nur v3.

Nach Eingabe gültiger Zugangsdaten werden die verfügbaren Projekte automatisch geladen und können ausgewählt werden.

tipp

Die Synchronisationsfrequenz und weitere gemeinsame Einstellungen (Chunking, Quellensichtbarkeit) werden unter Verknüpftes Wissen beschrieben.