Zum Hauptinhalt springen

Confluence

Übersicht​

Die Confluence-Verbindung ermöglicht eine sichere Verbindung der Siesta AI-Plattform mit Atlassian Confluence über die offizielle API. Die Integration bietet kontrollierten Zugriff auf den Inhalt des Confluence-Raums und ermöglicht:

  • das Durchsuchen von Seiten,
  • das Laden von Dokumentationsinhalten,
  • das programmgesteuerte Erstellen neuer Seiten,
  • das Aktualisieren bestehender Seiten.

Die Verbindung ist für den Unternehmenseinsatz konzipiert, mit einem Fokus auf Berechtigungsmanagement, Auditierbarkeit und Datensicherheit.

Anforderungen​

  • Aktive Confluence Cloud-Site.
  • Atlassian-Konto, das Zugriff auf den Confluence-Raum/Seiten hat, mit denen der Connector arbeiten soll.
  • Generierter API-Token im Atlassian-Konto (id.atlassian.com → Sicherheit → API-Token).
  • Administratorrechte zur Verwaltung der Verbindung in Siesta AI.

Unterstützte Operationen​

OperationBeschreibung
SearchPagesAsyncVolltextsuche von Seiten innerhalb des gewählten Confluence-Raums
GetPageAsyncLaden des Seiteninhalts einschließlich Metadaten
CreatePageAsyncErstellen neuer Seiten in Confluence
UpdatePageAsyncAktualisieren bestehender Seiten

Berechtigungsmanagement​

Jede Operation kann separat konfiguriert werden:

  • Erlaubt – die Operation ist ohne Einschränkungen verfügbar.
  • Erlaubt mit Bestätigung – die Operation erfordert eine manuelle Genehmigung.
  • Verboten – die Operation ist nicht verfügbar.

Dieses Modell ermöglicht eine präzise Definition des Zugriffsbereichs, z. B. für:

  • nur lesende Agenten,
  • automatisierte Dokumentationsprozesse,
  • kontrollierte Schreibvorgänge in Confluence.

Konfigurationsparameter​

Pflichtparameter​

ParameterBeschreibung
NameInterne Bezeichnung des Connectors
ApiKeyAPI-Token, das im Atlassian-Konto generiert wurde
Confluence site URLURL der Atlassian-Instanz (z. B. https://firma.atlassian.net)
E-Mail oder Benutzername des Atlassian-KontosE-Mail (oder Benutzername) des Kontos, unter dem der Token erstellt wurde

Vorgehensweise zum Hinzufügen des Confluence-Connectors​

1) Bereiten Sie Ihre Zugangsdaten vor​

Bevor Sie die Verbindung in Siesta AI erstellen, bereiten Sie alle Werte vor, die Sie in das Formular einfügen werden.

Öffnen Sie im Atlassian-Konto Sicherheit und den Abschnitt API-Token.

Atlassian API Tokens

Klicken Sie auf API-Token erstellen (ohne Scopes), geben Sie den Namen des Tokens und das Ablaufdatum ein und bestätigen Sie die Erstellung.

Erstellung des Atlassian API-Tokens

Nach der Erstellung kopieren Sie den Token einmalig und speichern ihn sicher.

Kopieren des Atlassian API-Tokens

Bereiten Sie außerdem vor:

  • Confluence site URL (z. B. https://firma.atlassian.net)
  • E-Mail oder Benutzername des Atlassian-Kontos, unter dem der Token erstellt wurde

2) Öffnen Sie die Integrationsverwaltung in Siesta AI​

Gehen Sie in der Siesta AI-Verwaltung zu Verwaltung → Verbundene Apps.

3) Wählen Sie Confluence​

Wählen Sie im Dialog Integration hinzufügen Confluence aus und fahren Sie fort.

Auswahl von Confluence in der Liste der Integrationen

4) Füllen Sie das Confluence-Formular aus​

Füllen Sie aus:

  • Name
  • ApiKey (Token von Atlassian)
  • Confluence site URL (z. B. https://firma.atlassian.net)
  • E-Mail / Benutzername des Atlassian-Kontos, unter dem der Token erstellt wurde

Bestätigen Sie die Erstellung der Integration.

Konfiguration der Confluence-Integration

5) Legen Sie die Berechtigungen für die Operationen fest​

Öffnen Sie nach der Erstellung der Integration Berechtigungseinstellungen und legen Sie die erlaubten Operationen fest.

Empfehlung: Stellen Sie Schreiboperationen auf Erlaubt mit Bestätigung ein.

Einstellungen der Berechtigungen für Operationen

Wichtiger Hinweis zu API-Token und Berechtigungen​

Der API-Token ist an ein bestimmtes Atlassian-Konto gebunden. Der Connector erbt dann die Berechtigungen dieses Kontos in Confluence (was das Konto nicht sehen oder bearbeiten kann, kann auch der Connector nicht).

Aus diesem Grund wird empfohlen:

  • dass jeder Benutzer einen eigenen Token hat, wenn die Verbindung unter seiner Identität läuft,
  • oder einen dedizierten Service-Account für gemeinsame/produktionsbezogene Automatisierungen zu verwenden,
  • das Ablaufdatum des Tokens zu überwachen und regelmäßige Rotationen durchzuführen.

Typische Nutzungsszenarien​

Interne Wissensdatenbank​

  • Durchsuchen der internen Dokumentation
  • Beantwortung von Mitarbeiteranfragen
  • Zentralisierter Zugriff auf aktuelle Informationen

Automatisierung der Dokumentation​

  • Generierung von Release-Notizen
  • Erstellung von Besprechungsprotokollen
  • Aktualisierung von Betriebsverfahren (SOP)

Prozessverknüpfung​

  • Synchronisation von Jira → Confluence
  • Automatische Erstellung von Berichten
  • Dokumentation von Vorfällen und Audit-Protokollen

Sicherheitsarchitektur​

Die Integration nutzt:

  • autorisierten Zugriff über die Atlassian API,
  • Einschränkungen auf einen bestimmten Confluence-Raum,
  • granulare Steuerung der Berechtigungen für Operationen,
  • die Möglichkeit zur Auditierung von Aktivitäten.

Es erfolgt kein unautorisierter Download von Inhalten oder Umgehung der Sicherheitsmechanismen der Atlassian-Plattform.

Empfohlene Betriebs-Konfiguration​

  • Erlauben Sie das Lesen ohne Einschränkungen.
  • Stellen Sie Schreiboperationen auf Erlaubt mit Bestätigung ein.
  • Verwenden Sie separate Räume für automatisierte Dokumentationen.
  • Überprüfen Sie regelmäßig die Berechtigungen der Verbindung.