Freigeben über


Bereitstellen des Confluence Cloud Copilot-Connectors im Microsoft 365 Admin Center

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

In diesem Artikel werden die Schritte zum Bereitstellen, Anpassen und Beheben von Problemen mit dem Confluence Cloud Copilot-Connector beschrieben. Allgemeine Informationen zur Bereitstellung des Copilot-Connectors finden Sie unter Einrichten von Copilot-Connectors im Microsoft 365 Admin Center.

Informationen zur erweiterten Confluence Cloud-Konfiguration finden Sie unter Einrichten des Confluence Cloud-Diensts für die Connectorerfassung.

Voraussetzungen

Stellen Sie vor der Bereitstellung des Confluence Cloud-Connectors sicher, dass die Confluence-Umgebung in Ihrem organization konfiguriert ist. In der folgenden Tabelle sind die Schritte zum Konfigurieren der Confluence-Umgebung und zum Bereitstellen des Connectors zusammengefasst.

Aufgabe Rolle
Konfigurieren der Umgebung Confluence-Administrator
Einrichten der Erforderlichen Komponenten Confluence-Administrator/Netzwerkadministrator
Bereitstellen des Connectors im Microsoft 365 Admin Center Microsoft 365 Admin
Anpassen der Connectoreinstellungen (optional) Microsoft 365 Admin

Zum Bereitstellen des Connectors müssen die folgenden Voraussetzungen erfüllt sein:

  • Sie müssen Administrator für den Microsoft 365-Mandanten Ihres organization und die Confluence-Website Ihres organization sein.
  • Sie müssen über Authentifizierungsanmeldeinformationen mit dem richtigen Zugriff verfügen.

Bereitstellen des Connectors

So fügen Sie den Confluence Cloud-Connector für Ihre organization hinzu:

  1. Wählen Sie im Microsoft 365 Admin Center im linken Bereich Copilot-Connectors> aus.
  2. Wechseln Sie zur Registerkarte Connectors , und wählen Sie im linken Bereich Katalog aus.
  3. Wählen Sie in der Liste der verfügbaren Connectors Confluence Cloud aus.

Festlegen des Anzeigenamens

Der Anzeigename wird verwendet, um Verweise in Copilot-Antworten zu identifizieren, damit Benutzer die zugeordnete Datei oder das zugeordnete Element erkennen können. Der Anzeigename steht auch für vertrauenswürdigen Inhalt und wird als Inhaltsquellenfilter verwendet.

Sie können den Standardmäßigen Confluence Cloud-Anzeigenamen übernehmen oder den Wert so anpassen, dass ein Anzeigename verwendet wird, den Benutzer in Ihrem organization erkennen.

Weitere Informationen zu Anzeigenamen und Beschreibungen von Connectors finden Sie unter Verbessern der Copilot-Ermittlung mit Microsoft 365 Copilot Connectorinhalten.

Festlegen instance URL

Um eine Verbindung mit Ihrer Confluence-Website herzustellen, verwenden Sie ihre Website-URL, die in der Regel wie folgt lautet: https://<organization_name>.atlassian.net.

Der <organization_name> Wert ist der eindeutige Bezeichner für Ihre Confluence Cloud-Website.

Auswählen des Authentifizierungstyps

Wählen Sie einen der folgenden Authentifizierungstypen aus, um Inhalte von Confluence zu authentifizieren und zu synchronisieren:

  • Standardauthentifizierung : Um sich mit der Standardauthentifizierung zu authentifizieren, geben Sie Ihren Benutzernamen (in der Regel Ihre E-Mail-Adresse) und das API-Token ein. Informationen zum Generieren eines API-Tokens finden Sie unter Verwalten von API-Token für Ihr Atlassian-Konto.

  • OAuth 2.0 (empfohlen): Registrieren Sie eine App in Confluence Cloud, damit Microsoft Search und Microsoft 365 Copilot auf die instance zugreifen können. Weitere Informationen finden Sie unter Aktivieren von OAuth 2.0 (3LO).

    So registrieren Sie die App:

    1. Melden Sie sich mit Ihrem Atlassian Confluence-Administratorkonto bei der Atlassian Developer-Konsole an.

    2. Wählen Sie Erstellen und dann OAuth 2.0-Integration aus.

    3. Geben Sie einen Namen für die Anwendung an, und erstellen Sie die neue App.

    4. Wählen Sie im linken Bereich Berechtigungen und dann neben Confluence-APIdie Option Hinzufügen aus.

    5. Wählen Sie Konfigurieren>Bearbeitungsbereiche und dann die in der folgenden Tabelle aufgeführten Bereiche aus.

      Bereichsname Code Beschreibung
      Anzeigen von Inhaltsdetails read:content-details:confluence Durchforstung von Inhalten, die die Kriterien erfüllen.
      Gruppen anzeigen read:group:confluence Zugriff auf Gruppenberechtigungen für Inhalte.
      Anzeigen von Benutzerdetails read:user:confluence Greifen Sie auf einzelne Benutzerdetails zu, um Berechtigungen zu unterstützen.
      Anzeigen von Überwachungsdatensätzen read:audit-log:confluence Greifen Sie auf Überwachungsdatensätze für Confluence-Ereignisse zu, um Berechtigungen zu unterstützen.
      Seiten anzeigen read:page:confluence Zugriff auf Seiteninhaltsdetails, um Berechtigungen zu unterstützen.
      Leerzeichen anzeigen read:space:confluence Zugriff auf Speicherplatzdetails, um Berechtigungen zu unterstützen.
      Anzeigen von Inhaltsbeschränkungen und Speicherplatzberechtigungen read:permission:confluence Anzeigen von Inhaltsbeschränkungen und Speicherplatzberechtigungen.
      Inhaltszusammenfassungen anzeigen read:content.metadata:confluence Greifen Sie auf Informationen zum Inhalt zu, um Berechtigungen zu unterstützen.
      Kommentare anzeigen read:comment:confluence Kommentare auf Seiten oder Blogbeiträgen anzeigen.
      Anzeigen und Herunterladen von Inhaltsanlagen read:attachment:confluence Anzeigen und Herunterladen von Anlagen einer Seite oder eines Blogbeitrags, auf die Sie Zugriff haben.
    6. Wählen Sie Speichern aus.

    7. Wechseln Sie im linken Bereich zu Autorisierung. Fügen Sie die Rückruf-URL für Microsoft 365 wie folgt hinzu:

      • Microsoft 365 Enterprise -https://gcs.office.com/v1.0/admin/oauth/callback
      • Microsoft 365 Government – https://gcsgcc.office.com/v1.0/admin/oauth/callback
    8. Wählen Sie Speichern aus.

    9. Wechseln Sie im linken Bereich zu Einstellungen. Kopieren Sie die Client-ID und den geheimen Schlüssel. Führen Sie den Schritt mit den Verbindungseinstellungen aus, indem Sie die Client-ID und den geheimen Schlüssel verwenden.

Tipp

Stellen Sie sicher, dass das Dienstkonto über Ansichtszugriff auf den Confluence-Inhalt verfügt, den Sie indizieren möchten.

Rollout

Stellen Sie die Verbindung für eine begrenzte Gruppe von Benutzern bereit, um sie in Copilot und anderen Suchoberflächen zu überprüfen, bevor Sie sie für eine breitere Zielgruppe bereitstellen. Weitere Informationen finden Sie unter Gestaffelter Rollout für Microsoft 365 Copilot Connectors.

Um das Rollout für eine begrenzte Zielgruppe durchzuführen, wählen Sie die Umschaltfläche neben Rollout für eingeschränkte Zielgruppe aus, und geben Sie die Benutzer und Gruppen an, für die der Connector rollout ausgeführt werden soll.

Klicken Sie zum Bereitstellen des Connectors im Microsoft 365 Admin Center auf Erstellen. Der Confluence Cloud Copilot-Connector beginnt sofort mit der Indizierung von Seiten aus Ihrem Confluence-Konto.

In der folgenden Tabelle sind die Standardwerte aufgeführt, die festgelegt werden. Diese Werte funktionieren am besten mit Confluence-Daten.

Kategorie Setting Standardwert
Benutzer Zugriffsberechtigungen Nur Personen mit Zugriff auf den Inhalt in der Datenquelle.
Benutzer Zuordnen von Identitäten Datenquellenidentitäten, die mithilfe von Microsoft Entra-IDs zugeordnet werden.
Inhalt Leerzeichen einschließen/ausschließen Alle
Inhalt Eigenschaften verwalten Informationen zu Standardeigenschaften und Schemas finden Sie unter Verwalten von Eigenschaften.
Synchronisieren Inkrementelle Durchforstung Häufigkeit: Alle 15 Minuten
Synchronisieren Vollständige Durchforstung Häufigkeit: Jeden Tag

Informationen zum Anpassen dieser Werte finden Sie unter Anpassen von Einstellungen.

Nachdem Sie Ihre Verbindung erstellt haben, können Sie die status im Abschnitt Connectors des Microsoft 365 Admin Center überprüfen.

Anpassen von Einstellungen (optional)

Sie können die Standardwerte für die Confluence Cloud-Connectoreinstellungen anpassen. Wählen Sie zum Anpassen der Einstellungen auf der Connectorseite im Admin Center Die Option Benutzerdefiniertes Setup aus.

Anpassen von Benutzereinstellungen

Der Confluence Cloud-Connector unterstützt die folgenden Berechtigungen für die Benutzersuche:

  • Jeder
  • Nur Personen mit Zugriff auf diese Datenquelle (Standard)

Wenn Sie Alle auswählen, werden indizierte Daten in den Suchergebnissen für alle Benutzer angezeigt. Wenn Sie Nur Personen mit Zugriff auf diese Datenquelle auswählen, werden in den Suchergebnissen für Benutzer, die Zugriff darauf haben, indizierte Daten angezeigt. In Confluence Cloud werden Sicherheitsberechtigungen für Benutzer und Gruppen mithilfe von Speicherplatzberechtigungen und Seiteneinschränkungen definiert. Einschränkungen auf Seitenebene haben Vorrang vor Platzberechtigungen, sofern vorhanden.

Wenn keine Seiteneinschränkungen angegeben sind, überprüft der Connector, ob Berechtigungen auf Leerzeichenebene vorhanden sind, und wendet Folgendes an:

  • Wenn für den Bereich der Zugriff auf anonyme Benutzer aktiviert ist, ist der Inhalt für alle Benutzer in Ihrem Mandanten sichtbar.
  • Wenn für den Bereich kein anonymer Zugriff aktiviert ist, werden die Berechtigungen auf Leerzeichenebene berücksichtigt.
  • Wenn keine Berechtigungen auf Leerzeichenebene definiert sind, ist der Inhalt für keinen Benutzer in Ihrem Mandanten sichtbar.

Wichtig

Berechtigungen werden nur auf Speicherplatz- und Seitenebene verwaltet. Übergeordnete Seitenberechtigungen werden nicht angewendet.

Wenn Sie Nur Personen mit Zugriff auf diese Datenquelle auswählen, müssen Sie auch auswählen, ob Ihre Confluence-Website über Microsoft Entra ID bereitgestellte Benutzer oder Nicht-Entra-ID-Benutzer verfügt:

  • Wählen Sie die Option Microsoft Entra ID aus, wenn die E-Mail-ID der Confluence-Benutzer mit dem Benutzerprinzipalnamen (UPN) in Microsoft Entra ID identisch ist.
  • Wählen Sie die Option non-Entra ID aus, wenn sich die E-Mail-ID der Confluence-Benutzer von der UPN in Microsoft Entra ID unterscheidet.

Hinweis

  • Wenn Sie Microsoft Entra ID als Identitätsquelle auswählen, ordnet der Connector benutzer-E-Mail-IDs von Confluence der UPN-Eigenschaft in Microsoft Entra ID zu.
  • Wenn Sie eine Nicht-Entra-ID als Identitätsquelle auswählen, geben Sie einen regulären Ausdruck an, um die E-Mail-ID dem UPN zuzuordnen. Weitere Informationen finden Sie unter Zuordnen Ihrer Nicht-Entra-ID-Identitäten.
  • Updates für Benutzer oder Gruppen, die Zugriffsberechtigungen steuern, werden nur in vollständigen Durchforstungen synchronisiert. Inkrementelle Durchforstungen unterstützen derzeit keine Verarbeitung von Aktualisierungen für Berechtigungen.

Anpassen von Inhaltseinstellungen

Sie können anpassen, welche Daten eingeschlossen und ausgeschlossen werden, und die Standardconnectoreigenschaften anpassen.

Einschließen oder Ausschließen von Daten

Standardmäßig indiziert der Confluence Cloud-Connector alle Blogs und Seiten. Sie können Daten einschließen oder ausschließen, die Sie indizieren möchten. Sie können eine CQL-Zeichenfolge (Confluence Query Language) verwenden, um Bedingungen für die Synchronisierung von Seiten anzugeben. Beispielsweise können Sie auswählen, dass nur die Seiten indiziert werden sollen, die in den letzten zwei Jahren geändert wurden. Weitere Informationen finden Sie unter Erweiterte Suche mit CQL.

Tipp

Sie können den CQL-Filter verwenden, um Inhalte zu indizieren, lastModified >= "2024/12/31"die nach einer bestimmten Zeit geändert wurden, z. B. .

Wählen Sie Vorschauergebnisse aus, um die Beispielwerte der ausgewählten Eigenschaften und der CQL-Zeichenfolge zu überprüfen.

Eigenschaften verwalten

Um dem Confluence Cloud-Connector verfügbare Eigenschaften hinzuzufügen oder zu entfernen, weisen Sie der Eigenschaft ein Schema zu (definieren Sie, ob eine Eigenschaft durchsuchbar, abfragbar, abrufbar oder verfeinernd ist), ändern Sie die semantische Bezeichnung, und fügen Sie der Eigenschaft einen Alias hinzu. Die folgenden Eigenschaften sind standardmäßig indiziert.

Standardeigenschaft Label Beschreibung
blockieren authors Name der Personen, die an dem Element in der Datenquelle teilgenommen bzw. zusammengearbeitet haben.
CreatedByName createdBy Name der Person, die das Element zuletzt in der Datenquelle bearbeitet hat.
IconUrl iconUrl Die zugeordnete Symbol-URL des Elements.
Position title Der Titel des Elements, das in der Suche und in anderen Umgebungen angezeigt werden soll.
UpdatedByName lastModifiedBy Name der Person, die das Element zuletzt in der Datenquelle bearbeitet hat.
UpdatedOn lastModifiedDateTime Datum und Uhrzeit der letzten Änderung des Elements in der Datenquelle.
Url url Die Ziel-URL des Elements in der Datenquelle

Wählen Sie die Schaltfläche Ergebnisse anzeigen aus, um die ausgewählten Eigenschaften und Filter zu überprüfen.

Anpassen von Synchronisierungsintervallen

Das Aktualisierungsintervall bestimmt, wie oft Ihre Daten zwischen der Datenquelle und dem Confluence Cloud-Connectorindex synchronisiert werden. Copilot-Connectors verwenden zwei Arten von Aktualisierungsintervallen:

  • Vollständige Durchforstung : Führt eine vollständige Synchronisierung aller Inhalte aus. Vollständige Durchforstungen erkennen gelöschte Elemente und synchronisieren Änderungen an der Zugriffssteuerungsliste (Access Control List, ACL). Standardmäßig werden vollständige Durchforstungen alle 24 Stunden ausgeführt.
  • Inkrementelle Durchforstung : Synchronisiert neue und geänderte Inhalte. Inkrementelle Durchforstungen nehmen keine ACL-Änderungen oder gelöschten Elemente auf. Standardmäßig werden inkrementelle Durchforstungen alle 15 Minuten ausgeführt.

Sie können die Standardwerte der Aktualisierungsintervalle ändern. Weitere Informationen finden Sie unter Richtlinien für Synchronisierungseinstellungen.