Einrichten des Confluence Cloud-Diensts für die Connectorerfassung

Der Confluence Cloud Microsoft 365 Copilot-Connector integriert Confluence-Inhalte in Microsoft 365, sodass Copilot, Copilot Search und Microsoft Search relevante Wiki-Seiten, Blogs und Anlagen direkt in Apps wie Teams, Outlook und SharePoint anzeigen können.

Dieser Artikel enthält Informationen zu den Konfigurationsschritten, die Confluence-Administratoren ausführen müssen, um Confluence Cloud für Ihre organization einzurichten, einschließlich der Konfiguration der Umgebung und der Einrichtung der Voraussetzungen für den Confluence Cloud-Connector.

Informationen zum Bereitstellen des Connectors finden Sie unter Bereitstellen des Confluence Cloud-Connectors.

Prüfliste für das Setup

In den folgenden Prüflisten ist der Schritt aufgeführt, der beim Konfigurieren der Umgebung und Einrichten der Connectorvoraussetzungen erforderlich ist.

Konfigurieren der Umgebung

Aufgabe	Rolle
Identifizieren der instance-URL	Confluence-Administrator
Überprüfen der Konfiguration von Leerzeichen und Seiten	Confluence-Administrator
Definieren der Attributzuordnung	Confluence-Administrator
Konfigurieren von Benutzerzugriffsberechtigungen	Confluence-Administrator
Hinzufügen von Beschreibungen zu Leerzeichen und Seiten	Confluence-Administrator
Konfigurieren der Entra-ID-Synchronisierung in Crowd	Confluence-Administrator

Einrichten der Erforderlichen Komponenten

Aufgabe	Rolle
Erstellen eines Dienstkontos	Confluence-Administrator
Identifizieren der Elementanzahl für die Erfassung	Confluence-Administrator
Einrichten von CQL für die erweiterte Suche	Confluence-Administrator
Bereitstellen eines OAuth-Endpunkts	Confluence-Administrator
Hinzufügen einer IP-Adresse zur Zulassungsliste	Confluence-Administrator/Netzwerkadministrator
Überprüfen der Copilot-Indizierung	Confluence-Administrator

Konfigurieren der Confluence-Umgebung

In den folgenden Abschnitten werden die Administratoraufgaben zum Konfigurieren der Confluence-Umgebung zum Aktivieren und Optimieren der Verbindung beschrieben.

Identifizieren der Confluence-instance-URL

Die Confluence Cloud instance-URL hat im Allgemeinen das folgende Format:

https://<organization_name>.atlassian.net/wiki

So identifizieren Sie die instance URL für Confluence Cloud:

Melden Sie sich bei Ihrem Confluence-Konto an.
Wählen Sie Produkt-URLs aus.
Suchen Sie unter Standard-URLs nach Ihrem Websitenamen und Produkt.

Sie können die URL auch in Ihrem Browser anzeigen, wenn Sie Confluence Cloud verwenden.

Überprüfen der Konfiguration der Confluence-Räume und -Seiten

Um die Indizierung und Suchergebnisse zu optimieren, überprüfen Sie die Konfiguration von Leerzeichen und Seiten in Confluence Cloud und Confluence Data Center. Dadurch wird sichergestellt, dass die Suchergebnisse in Microsoft 365 vollständig, sicher und den Erwartungen der Benutzer entsprechen.

Stellen Sie in Confluence Cloud sicher, dass Leerzeichen klaren Namenskonventionen entsprechen, Bezeichnungen konsistent verwenden und Berechtigungen anwenden, die der beabsichtigten Sichtbarkeit für Copilot, Copilot Search und Microsoft Search entsprechen. Organisieren Sie Seiten in einer logischen Hierarchie, und verwenden Sie aussagekräftige Titel und Metadaten, um die Suchgenauigkeit zu verbessern.

Definieren der Confluence-Attributzuordnung

Die Standardmethode zum Zuordnen Ihrer Datenquellenidentitäten zu Microsoft Entra ID besteht darin, zu bestimmen, ob die E-Mail-Adresse jedes Confluence-Benutzers mit dem Benutzerprinzipalnamen (UPN) oder der E-Mail-Adresse in Microsoft Entra ID übereinstimmt. Wenn diese Standardzuordnung die Anforderungen Ihrer organization nicht erfüllt, können Sie eine benutzerdefinierte Zuordnungsformel definieren.

Weitere Informationen zum Zuordnen von Identitäten, die nicht in Microsoft Entra ID enthalten sind, finden Sie unter Zuordnen Ihrer nicht Azure AD-Identitäten.

Konfigurieren von Benutzerzugriffsberechtigungen

Confluence-Administratoren können LDAP-Verzeichnisse wie Microsoft Entra ID integrieren, um den Benutzerzugriff und die Berechtigungen zentral zu verwalten. Durch die Synchronisierung von LDAP-Gruppen in Confluence können Administratoren diese Gruppen Räumen und Seiten zuweisen, um den Zugriff anzuzeigen und zu bearbeiten, um sie an der unternehmensweiten Identitätsgovernance anzupassen.

Sie können synchronisierte geschachtelte Gruppen verwenden, um Zugriffssteuerungslisten (Access Control Lists, ACLs) zu verwalten, sofern die Mitglieder der geschachtelten Gruppe Teil einer Confluence-Benutzergruppe sind.

Die folgende Tabelle enthält einen Vergleich von LDAP-Gruppen und nativen Confluence-Gruppen für Confluence-Benutzerzugriffsberechtigungen.

Feature	LDAP-Gruppen	Native Confluence-Gruppen
Quelle	In einem externen Verzeichnis verwaltet	Verwaltet in Confluence
Synchronisieren	Regelmäßige Synchronisierung über die Konfiguration des Benutzerverzeichnisses	Manuell von Confluence-Administratoren erstellt und verwaltet
Skalierbarkeit	Hochgradig skalierbar für die Unternehmensnutzung	Geeignet für kleine Teams oder nur Confluence-Setups
Zugriffssteuerung	Automatisches Abbilden von Verzeichnisänderungen	Erfordert manuelle Updates
Überwachung und Compliance	Abgestimmt auf IT-Richtlinien und Compliance-Frameworks	Dezentrale Steuerung

Hinzufügen von Beschreibungen für Leerzeichen und Seiten

Copilot verwendet die Beschreibungen und kurzen Beschreibungen in Confluence, um Leerzeichen und Seiten semantisch mit Benutzeraufforderungen abzugleichen. Wenn Beschreibungen fehlen, wird die Relevanz von Copilot-Antworten verringert. Stellen Sie sicher, dass Sie Beschreibungen und kurze Beschreibungen für Leerzeichen und Seiten in Ihrem Confluence-instance hinzufügen.

Konfigurieren der Entra-ID-Synchronisierung in Crowd

Sie können Microsoft Entra ID als Verzeichnis in Crowd konfigurieren. Wenn Sie Microsoft Entra ID konfigurieren, werden alle Änderungen an Ihren Benutzern, Gruppen und Mitgliedschaften regelmäßig oder bei Bedarf zwischen Microsoft Entra ID und Crowd synchronisiert. Sie können Informationen zu Ihren Benutzern direkt in Crowd anzeigen, indem Sie den Benutzerbrowser und den Gruppenbrowser verwenden.

Weitere Informationen finden Sie unter Konfigurieren von Microsoft Entra ID.

Einrichten der Connectorvoraussetzungen

In den folgenden Abschnitten werden die erforderlichen Schritte beschrieben, die vor der Bereitstellung des Confluence-Connectors ausgeführt werden müssen.

Erstellen eines Dienstkontos

Damit der Confluence-Connector Elemente regelmäßig aktualisieren kann, konfigurieren Sie ein Dienstkonto mit Lesezugriff auf bestimmte Confluence-Wissenstabellen.

Stellen Sie sicher, dass das Dienstkonto über Leseberechtigungen für die folgenden erforderlichen Tabellen verfügt:

Leerzeichen

Erteilen Sie Leseberechtigungen für alle anwendbaren Tabellen. Weitere Informationen finden Sie unter Erteilen von Administratorberechtigungen für Benutzer.

Hinweis

Änderungen am Dienstkonto können sich auf die Datensynchronisierung mit Microsoft 365 auswirken. Wenn das Konto geändert wird, müssen Sie den Connector möglicherweise erneut in Microsoft 365 authentifizieren.

Stellen Sie sicher, dass das Dienstkonto ordnungsgemäß konfiguriert ist. Wenn keine Einschränkungen auf Seitenebene vorhanden sind, überprüft der Connector die Berechtigungen auf Raumebene und stellt Inhalte wie folgt zur Verfügung:

Wenn der anonyme Zugriff für einen Bereich aktiviert ist, ist dessen Inhalt für alle Benutzer in Ihrem Mandanten sichtbar.
Wenn der anonyme Zugriff deaktiviert ist, werden Berechtigungen auf Leerzeichenebene erzwungen.
Wenn keine Berechtigungen auf Leerzeichenebene definiert sind, ist der Inhalt für keine Benutzer in Ihrem Mandanten sichtbar.

Hinweis

Berechtigungen werden nur auf Speicherplatz- und Seitenebene verwaltet. Übergeordnete Seitenberechtigungen werden nicht berücksichtigt.

OAuth-Fehler aufgrund ungültiger Anmeldeinformationen

Wenn der Microsoft 365-Administrator nicht auch ein Confluence Cloud-Administrator ist, schlägt die Verbindungsautorisierung mit dem Fehler "Ungültige Verbindungsanmeldeinformationen" fehl. Um diesen Fehler zu beheben, kann der Microsoft 365-Administrator die folgenden Schritte ausführen:

Öffnen Sie ein InPrivate-Browserfenster, und melden Sie sich mit Ihren Anmeldeinformationen beim Verwaltungsportal an.
Wählen Sie im Verwaltungsportal die Confluence-Datenquelle aus, und beginnen Sie mit dem Erstellen der Verbindung.
Wählen Sie für Authentifizierung die Option OAuth 2.0 aus.
Geben Sie die Client-ID und den geheimen Clientschlüssel der App ein, die vom Confluence-Administrator erstellt wurde.
Wählen Sie Autorisieren aus. Ein Popupfenster wird geöffnet.
Kopieren Sie die URL aus dem Popupfenster, und geben Sie sie für den Confluence-Administrator frei.
Bitten Sie den Confluence-Administrator, sich bei ihrem Confluence-Konto anzumelden und die Anforderung zu genehmigen. Nach der Genehmigung wird ein leerer Bildschirm angezeigt– dies bestätigt den Erfolg.
Nachdem der Confluence-Administrator die Genehmigung bestätigt hat, kehren Sie zum Popupfenster zurück.
Klicken Sie mit der rechten Maustaste auf das Popupfenster, und wählen Sie Konsole überprüfen> aus.
Fügen Sie in der Konsole den folgenden Befehl ein: window.opener.postMessage({type: 'oauthFinish', isSuccess: true}, '*')

Hinweis

Wenn das Einfügen deaktiviert ist, geben Sie zuerst in die Konsole ein allow pasting , und fügen Sie den Befehl dann erneut ein.
Auf dem Bildschirm zum Erstellen der Verbindung wird eine Erfolgsmeldung angezeigt, und die Schaltfläche Erstellen wird aktiv.
Sie können jetzt das Popupfenster schließen.

Identifizieren der Elementanzahl für die Erfassung

So überprüfen Sie die erwartete Elementanzahl für die Erfassung aller anwendbaren Connectors in Confluence Cloud:

Gehen Sie zu https://<Confluence instance name>.atlassian.net/wiki/admin/space-reports.
Wählen Sie unter Space report (Raumbericht) die Option Create report (Bericht erstellen) aus.
Wählen Sie Herunterladen aus, um den Bericht zu exportieren.
Öffnen Sie die heruntergeladene .csv-Datei.
Überprüfen Sie in der Spalte Inhaltsanzahl die Anzahl der Seiten, die in jedem Bereich synchronisiert werden.

Hinweis

KI-generierte Inhalte im Bericht können ungenau sein. Überprüfen Sie den Inhalt, bevor Sie fortfahren.

Einrichten von CQL für die erweiterte Suche

Verwenden Sie Confluence Query Language (CQL), um Seiten aus einem bestimmten Bereich in Confluence Cloud abzurufen, die bestimmte Bezeichnungen aufweisen und zuletzt innerhalb eines definierten Zeitrahmens geändert wurden.

Schließen Sie die folgenden Komponenten in Ihre Abfrage ein:

Leertaste : Gibt den zu durchsuchenden Bereich an.
Seitentyp : Filtert Ergebnisse, um nur Seiten einzuschließen.
Bezeichnungen : Filtert Seiten nach einer oder mehreren Bezeichnungen.
Datum der letzten Änderung : Beschränkt die Ergebnisse auf Seiten, die innerhalb eines bestimmten Zeitrahmens geändert wurden.

Das folgende Beispiel zeigt eine CQL-Abfrage.

CQLtype = page AND space = "SPACEKEY" AND label in ("label1", "label2") AND lastmodified >= "2025-01-01"

Im vorherigen Beispiel:

type = Page: Gibt nur Seiten zurück.
space = "SPACEKEY": Ersetzen Sie "SPACEKEY" durch den tatsächlichen Schlüssel für Ihren Raum.
label in ("label1", "label2"): Gibt Seiten mit label1 oder label2 zurück.
lastmodified >= "2025-01-01": Gibt Seiten zurück, die am oder nach dem 1. Januar 2025 geändert wurden.

Sie können das Datumsformat an yyyy-MM-dd oder yyyy-MM-dd HH:mm anpassen, um die Uhrzeit einzuschließen.

Tipp

Verwenden Sie zum Filtern von Bezeichnungen die Bezeichnung in (...) , um mehrere Bezeichnungen abzugleichen.
Für Datumsfunktionen unterstützt CQL dynamische Funktionen wie startOfYear() oder endOfMonth() , um die Datumsfilterung zu vereinfachen. Gibt beispielsweise Seiten zurück, lastmodified >= startOfYear() die seit Beginn des aktuellen Jahres geändert wurden.

Verwenden Sie die folgende POST-Anforderung, um die Abfrage mit der Confluence Cloud-REST-API auszuführen.

curl -u yourUsername:yourPassword \
     -X POST "https://your-confluence-url/rest/api/search" \
     -H "Content-Type: application/json" \
     -d '{
           "cql": "type=page AND space=\"SPACEKEY\" AND label=\"your-label\" AND lastmodified >= \"2025-01-01\"",
           "limit": 25,
           "start": 0
         }'

Ersetzen Sie:

yourUsername und yourPassword mit Ihren Anmeldeinformationen oder verwenden Sie die tokenbasierte Authentifizierung.
https://your-confluence-url mit Ihrer Confluence-Basis-URL.
SPACEKEY mit Ihrem Leertastenschlüssel.
your-label mit der gewünschten Bezeichnung.
Passen Sie das Datum und die Paginierung nach Bedarf an.

Bereitstellen eines OAuth-Endpunkts

Damit der Confluence Cloud-Connector auf Ihre Confluence Cloud instance zugreifen kann, muss ein Confluence-Administrator einen OAuth-Endpunkt bereitstellen, damit die Microsoft Search-App und Microsoft 365 Copilot auf die instance zugreifen können.

Ausführliche Anweisungen finden Sie unter Registrieren einer App in Confluence Cloud.

Verwenden Sie die folgende Tabelle, um zu bestimmen, welche Bereiche beim Konfigurieren des Zugriffs über die Confluence-API ausgewählt werden sollen.

Bereichsname	Code
Anzeigen von Inhaltsdetails Zeigen Sie Details zum Inhalt und den zugehörigen Eigenschaften an.	read:content-details:confluence
Anzeigen von Überwachungsdatensätzen Anzeigen und Exportieren von Überwachungsdatensätzen für Confluence-Ereignisse	read:audit-log:confluence
Seiten anzeigen Seiteninhalt anzeigen.	read:page:confluence
Gruppen anzeigen Zeigen Sie Details zu Gruppen an, einschließlich der zugehörigen Mitglieder.	read:group:confluence
Anzeigen von Benutzerdetails Anzeigen von Benutzerdetails.	read:user:confluence
Leerzeichen anzeigen Anzeigen von Raumdetails.	read:space:confluence
Anzeigen von Inhaltsbeschränkungen und Speicherplatzberechtigungen Anzeigen von Inhaltsbeschränkungen und Details zu Speicherplatzberechtigungen.	read:permission:confluence
Inhaltszusammenfassungen anzeigen Zeigen Sie Informationen zum Inhalt an. Beachten Sie, dass dadurch kein Zugriff auf den Inhalt selbst ermöglicht wird.	read:content.metadata:confluence
Kommentare anzeigen Kommentare auf Seiten oder Blogbeiträgen anzeigen.	read:comment:confluence
Anzeigen und Herunterladen von Inhaltsanlagen Anzeigen und Herunterladen von Anlagen einer Seite oder eines Blogbeitrags, auf die Sie Zugriff haben.	read:attachment:confluence

Hinzufügen einer IP-Adresse zur Zulassungsliste

Um sicherzustellen, dass der Connector auf Confluence-APIs zugreifen kann, fügen Sie die erforderlichen Microsoft 365-IP-Adressen der Zulassungsliste in Ihrer Firewall, Ihrem Proxy oder anderen Netzwerkkonfigurationen hinzu.

Wenn Ihre Netzwerkkonfiguration für Confluence Cloud den Zugriff auf Confluence-APIs blockiert, stellen Sie sicher, dass die in den folgenden Dokumentationsseiten aufgeführten IP-Adressen zulässig sind:

Überprüfen der Copilot-Indizierung für Confluence

Führen Sie die folgenden Überprüfungsschritte aus, um zu bestätigen, dass Microsoft 365 Copilot auf die erforderlichen Inhalte von Confluence zugreifen können:

Überprüfen Sie basierend auf den Voraussetzungen, ob alle erforderlichen Elemente mit Microsoft synchronisiert werden.
Wechseln Sie zur Seite Connectordetails .
Stellen Sie sicher, dass die Indexanzahl mit der Seitenanzahl im konfigurierten Confluence-Bereich übereinstimmt.

Nächster Schritt

Bereitstellen des Confluence Cloud-Connectors

Last updated on 2025-11-20

Freigeben über

Einrichten des Confluence Cloud-Diensts für die Connectorerfassung

Prüfliste für das Setup

Konfigurieren der Umgebung

Einrichten der Erforderlichen Komponenten

Konfigurieren der Confluence-Umgebung

Identifizieren der Confluence-instance-URL

Überprüfen der Konfiguration der Confluence-Räume und -Seiten

Definieren der Confluence-Attributzuordnung

Konfigurieren von Benutzerzugriffsberechtigungen

Hinzufügen von Beschreibungen für Leerzeichen und Seiten

Konfigurieren der Entra-ID-Synchronisierung in Crowd

Einrichten der Connectorvoraussetzungen

Erstellen eines Dienstkontos

OAuth-Fehler aufgrund ungültiger Anmeldeinformationen

Identifizieren der Elementanzahl für die Erfassung

Einrichten von CQL für die erweiterte Suche

Bereitstellen eines OAuth-Endpunkts

Hinzufügen einer IP-Adresse zur Zulassungsliste

Überprüfen der Copilot-Indizierung für Confluence

Nächster Schritt

Zusätzliche Ressourcen