Confluence Data Center

​

Überblick

Dieser Konnektor verbindet eine selbst betriebene Confluence-Data-Center-Instanz mit Novaplan AI. Für von Atlassian gehostete Instanzen verwenden Sie den Confluence-Cloud-Konnektor. Die beiden Varianten haben unterschiedliche Anmeldeverfahren und APIs. Synchronisiert werden Bereiche, Seiten, Blogbeiträge, Kommentare, Anhänge, Benutzer und Gruppen. Bereichsrechte sowie Lesebeschränkungen für Seiten und Blogbeiträge werden berücksichtigt. Ordner gehören laut Quellanleitung nur zur Cloud-Variante und werden hier nicht als eigene Elemente synchronisiert.

​

Voraussetzungen und Berechtigungen

Ihre Confluence-Instanz muss aus der Novaplan-Umgebung über HTTPS erreichbar sein. Verwenden Sie ihre Stammadresse, zum Beispiel https://confluence.example.com, ohne abschließenden Schrägstrich. Läuft Confluence unter einem Basispfad, nehmen Sie diesen auf, etwa https://example.com/confluence; eine einzelne Seiten-URL wie /display/SPACE ist keine Base URL. Das Konnektorkonto sollte alle betroffenen Bereiche, die Benutzerliste und das Audit-Log lesen können. Die Quellanleitung empfiehlt dafür ein Confluence-Administratorkonto. Ein Personal Access Token übernimmt genau dessen Rechte. Stimmen Sie Umfang und Schutz dieses Zugangs mit Ihrer Confluence-Administration ab. Confluence Data Center steuert die Sichtbarkeit von E-Mail-Adressen global unter Administration → General Configuration → Security Configuration → User email visibility. Wenn Adressen für den Konnektor nicht sichtbar sind, können Benutzer beim ersten Lauf fehlen und Berechtigungen später zugeordnet werden. Die Quellanleitung nennt Public als mögliche Einstellung; diese macht Adressen für angemeldete Confluence-Benutzer sichtbar und ist daher eine Entscheidung Ihrer Administration und Datenschutzverantwortlichen.

​

Anmeldemethode wählen

OAuth-Anwendungen aus der Atlassian Developer Console sind für Confluence Cloud bestimmt und funktionieren mit diesem Data-Center-Konnektor nicht. Beide hier angebotenen Methoden synchronisieren dieselben Daten.

​

Personal Access Token erstellen

1. Melden Sie sich mit dem gewählten Konnektorkonto in Confluence an.
2. Öffnen Sie über das Profilbild Settings → Personal Access Tokens und wählen Sie Create token.
3. Benennen Sie es beispielsweise Novaplan AI Confluence Connector. Setzen Sie ein Ablaufdatum gemäß Ihrer Richtlinie oder deaktivieren Sie Automatic expiry nur, falls dies zugelassen ist.
4. Wählen Sie Create und kopieren Sie das Token sofort. Es wird nur einmal angezeigt; nach Verlust müssen Sie es widerrufen und neu erstellen.

​

Verbindung in Novaplan AI einrichten

1. Öffnen Sie Workspace Settings → Connectors, suchen Sie Confluence Data Center und wählen Sie + Setup.
2. Wählen Sie auf Authenticate Instance unter Authentication method entweder Personal Access Token oder Basic Authentication.
3. Geben Sie die Base URL und das Token ein. Für Basic Authentication geben Sie stattdessen den Confluence-Username und das Password ein; verwenden Sie den Benutzernamen, nicht automatisch die E-Mail-Adresse.
4. Wählen Sie Next. Nach Prüfung der Zugangsdaten gelangen Sie zu Configure Records.

Wenn Token oder Passwort später geändert werden, aktualisieren Sie Authenticate Instance. Data-Center-Zugangsdaten werden nicht automatisch erneuert.

​

Inhalte und Synchronisierung auswählen

Unter Configure Records wählen Sie Scheduled oder Manual. Der voreingestellte Sync Interval beträgt 60 Minuten. Eine Echtzeit-Synchronisierung ist für diesen Konnektor nicht vorgesehen. Die Auswahllisten werden aus Ihrer Instanz geladen. Synchronisierungsfilter begrenzen die verarbeiteten Bereiche, Seiten und Blogbeiträge. Der zugängliche Data-Center-Konnektor liest dennoch Nutzer und Gruppen für Identitäts- und Berechtigungszuordnungen; Inhaltsfilter garantieren deshalb nicht, dass keine weiteren Quellmetadaten gelesen werden. Die getrennten Indexierungsoptionen Index Pages, Index Page Attachments, Index Page Comments, Index Blogposts, Index Blogpost Attachments und Index Blogpost Comments steuern, welche synchronisierten Inhalte in der KI-Suche erscheinen, nicht allein den Abruf aus Confluence; laut Quellanleitung sind sie zunächst aktiviert. Speichern Sie mit Save und wählen Sie Start syncing now oder I’ll do it later. Den Fortschritt sehen Sie unter Indexing Progress. Der erste Lauf liest alle zugänglichen Inhalte im gewählten Umfang. Spätere Läufe verwenden Änderungszeiten; ein zusätzlicher Audit-Log-Durchlauf erkennt Rechteänderungen, die den Änderungszeitpunkt einer Seite nicht verändern.

​

Sichtbarkeit prüfen und Fehler beheben

Bereichsrechte werden über GET /rest/api/space/{spaceKey}/permissions gelesen. Für Seiten und Blogbeiträge zählen wirksame Lesebeschränkungen; eine reine Bearbeitungsbeschränkung nimmt niemandem das Leserecht. Öffentlich lesbare Bereiche werden entsprechend als öffentlich behandelt. Prüfen Sie nach der Einrichtung mit Testkonten, ob die Sichtbarkeit in Novaplan AI der Confluence-Instanz entspricht. Anhänge und Kommentare einer eingeschränkten Seite übernehmen deren Sichtbarkeit. Ändert ein Audit-Log-Ereignis die Seiteneinschränkung, werden die gespeicherten Anhänge und Kommentare entsprechend angepasst. Eine Einschränkung auf eine noch nicht synchronisierte Gruppe bleibt bestehen; deren Mitglieder erhalten Zugriff, nachdem die Gruppe synchronisiert und die Seite erneut gelesen wurde. Schlagen Abfragen von Bereichsrechten, Gruppenmitgliedschaften oder Seiteneinschränkungen vorübergehend fehl, bleiben die gespeicherten Rechte erhalten. Eine Seite mit nicht lesbaren Einschränkungen wird für diesen Lauf übersprungen; der übrige Bereich wird weiter synchronisiert und das Zeitfenster beim nächsten Lauf erneut gelesen. Der Fehler gibt die Seite nicht für den gesamten Bereich frei.

​

Häufige Fragen

Für agentengesteuerte Änderungen an Confluence-Seiten gibt es ein getrenntes Confluence-Data-Center-Toolset. Dieser Konnektor dient der Synchronisierung und Suche. Bei Einrichtungsfragen hilft Novaplan Support.