Einführung
Verbinden Sie Confluence-Bereiche, damit Seiteninhalte als durchsuchbares Wissen in Docebo verfügbar werden.
Dieser Konnektor synchronisiert ganze Confluence-Bereiche samt Seiteninhalten und Hierarchie statt einzelner Dateien. Deshalb wird er als „Sites“-Konnektor aufgeführt. Das ist der wesentliche Unterschied zu den SharePoint- und Google-Drive-Konnektoren.
1. Grundlegende Informationen
Welche Inhalte synchronisiert werden
| Inhaltstyp | Status | Hinweis |
|---|---|---|
| Veröffentlichte Seiten innerhalb eines ausgewählten Bereichs | Synchronisiert | |
| Seitenlabels | Synchronisiert | |
| Dateien und Anhänge innerhalb von Seiten | Nicht synchronisiert | Nicht im Umfang enthalten — dieser Konnektor deckt nur Seiteninhalte ab, keine Dateien |
| Kommentare | Nicht synchronisiert | |
| Entwürfe oder unveröffentlichte Seiten | Nicht synchronisiert | |
| Archivierte Bereiche | Nicht synchronisiert |
Welche Inhalte extrahiert werden
| Inhalt | Status |
|---|---|
| Seitentitel und Fließtext | Extrahiert |
| Name des Bereichs, Schlüssel und Seiten-URL | Extrahiert |
| Metadaten und Seitenhierarchie (übergeordnete/untergeordnete Struktur, Zeitstempel) | Extrahiert |
| Seitenlabels | Extrahiert |
| Inline-Bilder, Diagramme und gerenderte Makroausgaben | Nicht extrahiert |
| Kommentare | Nicht extrahiert |
| Seitenverlauf und Versionsvergleiche | Nicht extrahiert |
| Dateiinhalte von Anhängen | Nicht extrahiert |
2. Voraussetzungen im Quellsystem
Erforderliche Rolle
Sie benötigen einen Administrator der Atlassian-Organisation — ein Confluence-Site-Administrator ist nicht ausreichend. Der Administratorzugriff auf Organisationsebene ermöglicht es dem Konnektor, Benutzer korrekt zu identifizieren und jeden Bereich zu erreichen. Ein Site-Administrator kann beides nicht gewährleisten.
Erforderliche Einstellungen
- Dieser Konnektor unterstützt nur Confluence Cloud. Confluence Data Center wird nicht unterstützt.
- Wenn Ihre Organisation eine App-Zulassungsliste verwendet, fügen Sie die neue OAuth-App hinzu, bevor Sie die Autorisierung durchführen.
3. Vorbereitung im Quellsystem
App erstellen
Öffnen Sie die Atlassian Developer Console, wählen Sie Create → OAuth 2.0 integration und geben Sie der App einen Namen (zum Beispiel „Docebo Knowledge Connector“). Wählen Sie einen Zugriffstyp: Verwenden Sie in den meisten Fällen Account-level — damit wird der Zugriff auf jede Site in der Atlassian-Organisation des Kunden gewährt. Wählen Sie Resource-level nur dann, wenn die Organisation über mehrere separate Sites verfügt und Sie ausdrücklich nur eine davon verbinden möchten.
Erstellen einer neuen OAuth-2.0-(3LO)-Integration mit Auswahl des Zugriffstyps.
Berechtigungen hinzufügen
Öffnen Sie die App → Permissions und fügen Sie sowohl die User identity API als auch die Confluence API hinzu. Fügen Sie für die Confluence API die Bereiche aus beiden Registerkarten — Classic scopes und Granular scopes — hinzu. Der Docebo-Konnektor verwendet beide.
User identity API
| Name des Bereichs | Beschreibung | Code |
|---|---|---|
| View active user profile | Zeigt die Profildetails des aktuell angemeldeten Benutzers an. | read:me |
| View user profiles | Erforderlich, um Benutzerprofile anzuzeigen. | read:account |
User identity API — ausgewählte Bereiche in der Atlassian Developer Console.
Confluence API — Classic scopes
| Name des Bereichs | Code |
|---|---|
| Read Confluence space summary | read:confluence-space.summary |
| Read Confluence content properties | read:confluence-props |
| Read Confluence detailed content | read:confluence-content.all |
| Read Confluence content summary | read:confluence-content.summary |
| Search Confluence content and space summaries | search:confluence |
| Read content permission in Confluence | read:confluence-content.permission |
| Read user | read:confluence-user |
| Read user groups | read:confluence-groups |
| Download content attachments | readonly:content.attachment:confluence |
Confluence API — Registerkarte „Classic scopes“ in der Atlassian Developer Console.
Confluence API — Granular scopes
| Name des Bereichs | Code |
|---|---|
| View detailed contents | read:content:confluence |
| View content details | read:content-details:confluence |
| View space details | read:space-details:confluence |
| View pages | read:page:confluence |
| View groups | read:group:confluence |
| View user details | read:user:confluence |
| View spaces | read:space:confluence |
| View space properties | read:space.property:confluence |
| View space settings | read:space.setting:confluence |
| Check content permissions | read:content.permission:confluence |
| View content restrictions and space permissions | read:permission:confluence |
| Read Email Address | read:email-address:confluence |
Confluence API — Registerkarte „Granular scopes“ in der Atlassian Developer Console.
Authentifizierung konfigurieren
Öffnen Sie Authorization, aktivieren Sie OAuth 2.0 (3LO) und legen Sie die Callback URL fest. Die Callback-URL folgt immer diesem Muster: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback — zum Beispiel https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback. Wählen Sie Save changes.
Registerkarte „Authorization“ mit dem Feld „Callback URL“ und dem Generator für die Authorization-URL.
Verteilung definieren
Öffnen Sie Distribution und setzen Sie den Distribution status auf Sharing — dadurch kann jedes Atlassian-Konto den Konnektor autorisieren, nicht nur das Konto, mit dem die App erstellt wurde. Füllen Sie die angeforderten Anbieter- und Sicherheitsangaben aus: Anbietername, URL der Datenschutzrichtlinie, URL der Nutzungsbedingungen und Kontakt für den Kundensupport. Beantworten Sie unter Personal data declaration, ob die App personenbezogene Daten speichert, und wählen Sie anschließend Save changes.
Bearbeitung der Verteilungseinstellungen mit ausgewähltem „Sharing“ und ausgefüllten Anbieterdetails.
4. Erforderliche Aktionen in Docebo
| Einzugebende Informationen | Wo Sie sie finden |
|---|---|
| Confluence-Site-URL | Ihre Confluence-Cloud-Adresse, z. B. yourcompany.atlassian.net |
| Client-ID | Atlassian Developer Console → App → Settings → Authentication details |
| Client-Secret | Atlassian Developer Console → App → Settings → Authentication details |
Konnektor autorisieren
- Gehen Sie zu Add-ons und Integrationen → Wissenskonnektoren → Erstellen → Confluence. Dieses Menü ist nur für Superadmins sichtbar.
- Geben Sie die Confluence-URL ein (zum Beispiel https://yourcompany.atlassian.net) und wählen Sie anschließend Weiter.
Confluence verbinden — Registerkarte „Setup“ mit dem Feld für die Confluence-URL.
- Geben Sie die Client-ID und das Client-Secret Ihrer Atlassian-App ein (Settings → Authentication details) und wählen Sie anschließend Authenticate.
Confluence verbinden — Registerkarte „Authenticate“ mit den Feldern für Client-ID und Client-Secret.
- Prüfen Sie im Atlassian-Popup den angeforderten Zugriff und wählen Sie Accept.
Atlassian-Zustimmungsbildschirm für den Docebo-Konnektor.
- Wählen Sie auf der Registerkarte Scope die Bereiche aus, die später zum Hinzufügen zu Wissenssammlungen verfügbar sein sollen, und speichern Sie Ihre Auswahl.
Confluence verbinden — Registerkarte „Scope“ zur Auswahl der zu synchronisierenden Bereiche.