Confluence Cloud verbinden

Auf dieser Seite wird beschrieben, wie Sie Confluence Cloud mit Gemini Enterprise verbinden.

Nachdem Sie Ihre Datenquelle eingerichtet und Daten zum ersten Mal importiert haben, synchronisiert der Datenspeicher Daten aus dieser Quelle in der Häufigkeit, die Sie bei der Einrichtung ausgewählt haben.

Unterstützte Versionen

Der Confluence Cloud-Connector unterstützt die Confluence REST API-Versionen V1 und V2.

Hinweise

Bevor Sie die Verbindung einrichten:

1. Prüfen Sie, ob Sie Administratorzugriff auf die Confluence-Instanz und das Projekt haben.

2. (Optional) Wenn Sie Nutzer-E-Mail-Adressen aus Confluence Cloud abrufen möchten, auch wenn die Sichtbarkeit von E-Mail-Adressen durch Einstellungen eingeschränkt ist, installieren Sie die App User Identity Accessor for Confluence Cloud. Sie müssen ein Confluence Site administrator sein, um diese App zu installieren und zu konfigurieren. Nachdem Sie die App installiert haben, konfigurieren Sie sie, um Nutzer-E-Mail-Adressen sicher abzurufen. Möglicherweise müssen Sie diese App nicht installieren, wenn die E-Mail-Adressen öffentlich zugänglich sind.

3. Weisen Sie dem Nutzer die Rolle „Discovery Engine Editor“ (roles/discoveryengine.editor) zu. Diese Rolle ist erforderlich, damit der Nutzer den Datenspeicher erstellen kann. So weisen Sie diese Rolle zu:

   1. Rufen Sie in der Google Cloud Console die Seite IAM auf.

      IAM aufrufen

   2. Lokalisieren Sie das Nutzerkonto und klicken Sie auf das Symbol Bearbeiten.

   3. Weisen Sie dem Administrator die Rolle „Discovery Engine-Bearbeiter“ zu.

4. Wenn Sie die Zugriffssteuerung für Datenquellen erzwingen und Daten in Gemini Enterprise schützen möchten, müssen Sie Ihren Identitätsanbieter konfigurieren.

Authentifizierung und Berechtigungen in Confluence einrichten

Sie können sich bei Confluence über OAuth-Clientanmeldedaten oder API-Token authentifizieren. In den folgenden Abschnitten finden Sie Informationen zum Erstellen von OAuth-Clientanmeldedaten und API-Tokens.

OAuth-Clientanmeldedaten erstellen

Folgen Sie der Anleitung unten, um eine Client-ID und einen Clientschlüssel zu erstellen, die erforderlichen OAuth 2.0-Bereiche zu konfigurieren, Nutzerberechtigungen einzurichten, die Instanz-URL und ‑ID abzurufen, Rollen zu konfigurieren und sich zu authentifizieren, um Daten zwischen Confluence Cloud und Gemini Enterprise zu synchronisieren. Informationen zum Aktivieren von OAuth 2.0 und zum Abrufen der Client-ID und des Clientschlüssels finden Sie in der Atlassian-Entwicklerdokumentation unter OAuth 2.0 (3LO) Apps.

1. Erstellen Sie eine OAuth 2.0-Integration in der Atlassian Developer Console:

   1. Melden Sie sich in der Atlassian Developer Console an.

   2. Klicken Sie auf das Profilsymbol und wählen Sie Entwicklerkonsole aus.

      

      Entwicklerkonsole auswählen

   3. Klicken Sie auf Erstellen und wählen Sie OAuth 2.0-Integration aus.

      

      OAuth 2.0-Integration auswählen

   4. Geben Sie einen Namen für die App ein und gehen Sie so vor:

      1. Klicken Sie das Kästchen für die Nutzungsbedingungen an.

      2. Klicken Sie auf Erstellen.

         

         Neue OAuth 2.0-Integration erstellen

      3. Klicken Sie auf Autorisierung.

      4. Wählen Sie in der Tabelle Autorisierungstyp für OAuth 2.0 (3LO) die Option Hinzufügen aus.

         

         Autorisierungstyp hinzufügen

   5. Geben Sie im Feld Callback-URL https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html ein.

   6. Klicken Sie auf Änderungen speichern.

      

      Änderungen speichern

Wenn Sie die Warnung Ihre App enthält keine APIs. Fügen Sie Ihrer App APIs hinzu sehen, fahren Sie mit der nächsten Anleitung fort, um OAuth 2.0 zu konfigurieren. Andernfalls fahren Sie mit Schritt 4 dieser Anleitung fort.

Hinweis: Klassische Bereiche sind für Confluence Cloud-Connectors nicht verfügbar. Außerdem kann es nach dem Hinzufügen der Confluence API einen Moment dauern, bis die Schaltfläche Konfigurieren angezeigt wird. Wenn sie nicht sofort angezeigt wird, aktualisieren Sie die Seite oder warten Sie einige Sekunden.

So konfigurieren Sie OAuth 2.0 und rufen die erforderlichen Anmeldedaten für die Einrichtung Ihres Confluence-Connectors ab:

1. OAuth 2.0 aktivieren:

   1. Klicken Sie auf Berechtigungen.

      

      Berechtigungen auswählen

   2. Rufen Sie die Confluence API auf.

   3. Klicken Sie auf Hinzufügen.

   4. Klicken Sie auf Konfigurieren.

   5. Wechseln Sie zum Tab Detaillierte Bereiche und klicken Sie auf Bereiche bearbeiten.

      

      Bereiche bearbeiten

   6. Wählen Sie die folgenden Bereiche aus.

      • read:attachment:confluence
      • read:configuration:confluence
      • read:content.metadata:confluence
      • read:content-details:confluence
      • read:whiteboard:confluence
      • read:group:confluence
      • read:space:confluence
      • read:user:confluence

   7. Prüfen Sie, dass acht Bereiche ausgewählt sind, und speichern Sie Ihre Änderungen.

2. Client-ID und Clientschlüssel abrufen:

   1. Klicken Sie auf Bereitstellung.

   2. Wählen Sie Bearbeiten aus.

      

      Vertrieb bearbeiten

   3. Wählen Sie Freigabe aus, um andere Felder bearbeiten zu können.

   4. Füllen Sie die restlichen Felder aus. Legen Sie Anbietername auf Google und Datenschutzerklärung auf https://policies.google.com fest.

   5. Führen Sie im Abschnitt Erklärung zu personenbezogenen Daten folgende Schritte aus:

      1. Wählen Sie in der Liste Speichert Ihre App personenbezogene Daten? die Option Ja aus.

      2. Markieren Sie das Kästchen Ich bestätige, dass ich die Personal Data Reporting API implementiert habe, um zu bestätigen, dass Sie die Personal Data Reporting API implementiert haben.

      3. Klicken Sie auf Änderungen speichern.

   6. Wählen Sie Einstellungen und kopieren Sie dann die Werte aus den Feldern Client-ID und Clientschlüssel.

      

      Client-ID und Clientschlüssel kopieren

3. Instanz-URL abrufen:

   1. Rufen Sie atlassian.net auf und melden Sie sich mit Ihrem Administratorkonto an.
   2. Wählen Sie die App aus, die Sie synchronisieren möchten. Synchronisieren Sie beispielsweise die erste App.
   3. Suchen Sie die Instanz-URL. Sie wird als Subdomain in der Adressleiste angezeigt.

4. Instanz-ID abrufen:

   1. Öffnen Sie einen neuen Tab, kopieren Sie die Instanz-URL und hängen Sie /_edge/tenant_info an die Instanz-URL an. Beispiel: https://<var>YOUR-INSTANCE</var>.atlassian.net/_edge/tenant_info.

   2. Rufen Sie den Link auf, um den Wert für cloudId zu finden. Die cloudId ist Ihre Instanz-ID.

      

      Instanz-ID abrufen

Mininmale OAuth-Bereiche

In der folgenden Tabelle sind die zum Erstellen eines Confluence Cloud-Connectors mindestens erforderlichen OAuth-Bereiche aufgeführt:

Berechtigung	Verwendungsgrund	Beschreibung
read:content-details:confluence	Datenaufnahme	Ermöglicht dem Connector, Inhaltsdetails in Confluence zu lesen.
read:content.metadata:confluence	Datenaufnahme	Ermöglicht dem Connector, Inhaltsmetadaten zu lesen.
read:space:confluence	Datenaufnahme	Ermöglicht dem Connector, Bereiche zu lesen.
read:whiteboard:confluence	Datenaufnahme	Ermöglicht dem Connector, Whiteboards zu lesen.
read:attachment:confluence	Datenaufnahme	Ermöglicht dem Connector, Anhänge zu lesen.
read:configuration:confluence	ACLs erzwingen	Ermöglicht die Erzwingung von ACLs für den Zugriff auf die Confluence-Website.
read:group:confluence	ACLs erzwingen	Ermöglicht die Erzwingung von ACLs für das Lesen von Nutzer- und Gruppendetails.
read:user:confluence	ACLs erzwingen	Ermöglicht die Erzwingung von ACLs für das Lesen von Nutzerdetails.

Hinweis: Zusätzlich zu den Administratorberechtigungen benötigen Sie auch Zugriff auf die spezifischen Entitätsdatensätze, z. B. Blogs oder Beiträge.

API-Token in Confluence einrichten

Wenn Sie ein API-Token für die Authentifizierung verwenden möchten, müssen Sie ein API-Token ohne Bereiche erstellen. Dieser Connector unterstützt keine API-Tokens mit Bereichen.

1. Melden Sie sich in der Atlassian Console an.
2. Klicken Sie auf API-Token erstellen.
3. Geben Sie einen Namen für das API-Token ein.
4. Wählen Sie ein Ablaufdatum für das API-Token aus. Der Zeitraum für den Ablauf des Tokens liegt zwischen 1 und 365 Tagen.
5. Klicken Sie auf Erstellen.
6. Speichern Sie das Token zur späteren Verwendung.

Instanz-URL abrufen

1. Rufen Sie atlassian.net auf und melden Sie sich mit Ihrem Administratorkonto an.
2. Wählen Sie die App aus, die Sie synchronisieren möchten. Synchronisieren Sie beispielsweise die erste App.
3. Suchen Sie die Instanz-URL. Sie wird als Subdomain in der Adressleiste angezeigt.

Nutzersichtbarkeit verwalten und Rollen zuweisen

Hinweis: Damit Nutzerberechtigungen richtig angewendet werden, muss jeder Confluence Cloud-Nutzer seine E-Mail-Adresse für alle Nutzer sichtbar machen. Ändern Sie dazu die Einstellungen für die E-Mail-Sichtbarkeit in Confluence Cloud und legen Sie die Sichtbarkeit auf Anyone fest.

So legen Sie die Nutzersichtbarkeit fest:

1. Melden Sie sich in der Atlassian Developer Console an.

2. Klicken Sie auf das Symbol für das Nutzerprofil und rufen Sie Konto verwalten auf.

   

   Konto verwalten

3. Rufen Sie Profil und Sichtbarkeit auf.

   

   Profil und Sichtbarkeit

4. Gehen Sie zu Kontakt und legen Sie Wer kann das sehen? auf Jeder fest.

   

   Kontakt

Einem Nutzer eine Administratorrolle zuweisen

Optional können Sie anderen Nutzern Administratorrollen in Atlassian zuweisen.

1. Melden Sie sich mit einem Administratorkonto bei Atlassian an.

2. Klicken Sie auf das Menüsymbol und wählen Sie Ihre Organisation aus. Alternativ können Sie auch admin.atlassian.com aufrufen.

3. Klicken Sie auf der Seite Apps neben Confluence auf  (das Auslassungssymbol) und wählen Sie die Schaltfläche Nutzer verwalten aus.

   

   Nutzer verwalten

4. Klicken Sie unter Nutzerverwaltung auf Gruppen.

5. Auf der Seite Gruppen:

   1. Klicken Sie auf Gruppe erstellen.
   2. Geben Sie einen Namen für die Gruppe ein.

   

   Gruppe erstellen

   Diese Gruppe erhält die vom Connector benötigten Berechtigungen. Nutzer, die dieser Gruppe hinzugefügt werden, übernehmen diese Berechtigungen. Der Connector verwendet diese Gruppe zur Authentifizierung und zum Abrufen von Dokumenten.

6. Klicken Sie auf der Gruppenseite auf Produkt hinzufügen.

   1. Wählen Sie Administrator für Nutzerzugriff als Produktrolle aus.

   2. Klicken Sie auf Hinzufügen.

      

      Confluence-Nutzerzugriffsadministrator

7. Klicken Sie auf Gruppenmitglieder hinzufügen, um das Nutzerkonto oder die Gruppenmitglieder hinzuzufügen, die für die Authentifizierung des Connectors verwendet werden.

   

   Gruppenmitglieder hinzufügen

User Identity Accessor für Confluence Cloud installieren und konfigurieren

Wenn Nutzer-E-Mail-Adressen aufgrund von Datenschutzeinstellungen in Confluence Cloud nicht standardmäßig öffentlich zugänglich sind, müssen Sie die App User Identity Accessor for Confluence Cloud installieren, um Nutzer-E-Mail-Adressen sicher abzurufen. Wenn die E-Mail-Adressen der Nutzer bereits öffentlich sichtbar sind, müssen Sie die App möglicherweise nicht installieren. Weitere Informationen zur eingeschränkten E-Mail-Sichtbarkeit finden Sie unter Nutzersichtbarkeit verwalten und Rollen zuweisen.

Rollen und Berechtigungen

Zum Installieren und Konfigurieren der App User Identity Accessor for Confluence Cloud benötigen Sie die entsprechende Administratorrolle und müssen die erforderlichen Berechtigungen auf App-Ebene erteilen.

• Erforderliche Rolle: Sie müssen ein Confluence Site administrator sein, um die App zu installieren und zu konfigurieren.
• Berechtigungen auf App-Ebene: Sie müssen die folgenden Berechtigungen bei der App-Installation erteilen:
  • Read Email Address: Ermöglicht der App, Nutzer-E-Mail-Adressen sicher abzurufen, auch wenn die Profilsichtbarkeit eingeschränkt ist.
  • App Storage scope: Ermöglicht der App, Daten auf dem Speichergerät zu lesen und darauf zu schreiben.

„User Identity Accessor“ für Confluence Cloud installieren

So installieren Sie die App User Identity Accessor for Confluence Cloud auf Ihrer Confluence-Website:

1. Rufen Sie die Atlassian Developer Console auf.

2. Prüfen Sie die Berechtigungen E-Mail-Adresse lesen und App-Speicherbereich und klicken Sie auf App herunterladen.

   

   Berechtigungen prüfen und App herunterladen

3. Wählen Sie in der Liste Wählen Sie eine Website aus, auf der Sie diese App installieren möchten die Confluence-Website aus, auf der Sie die App installieren möchten. In dieser Liste werden nur die Websites angezeigt, für die Sie Administratorzugriff haben.

   Hinweis: Sie müssen Administrator mindestens einer Confluence-Website sein, um die App installieren zu können.

4. Klicken Sie auf Installieren, um die Installation der App abzuschließen.

User Identity Accessor für Confluence Cloud konfigurieren

Nachdem Sie die App User Identity Accessor for Confluence Cloud installiert haben, konfigurieren Sie einen API-Schlüssel, den Ihr externes System (z. B. Ihr Confluence Cloud Connector) verwendet, um den Webtrigger der App sicher aufzurufen und E-Mail-Adressen abzurufen.

Konfigurationsseite aufrufen

So rufen Sie die Konfigurationsseite der App User Identity Accessor for Confluence Cloud in Confluence Cloud auf:

1. Klicken Sie in Ihrer Cloud-Instanz im Navigationsmenü auf das Symbol Einstellungen ⚙️.
2. Wählen Sie im Menü Apps aus.
3. Suchen Sie auf der Seite App-Verwaltung in der Liste Apps verwalten nach der App User Identity Accessor for Confluence Cloud.

4. Klicken Sie auf Konfigurieren oder auf den Link, der mit Ihrer App verknüpft ist. Die dedizierte Konfigurationsseite der App wird in Confluence geöffnet.

   

   App „User Identity Accessor for Confluence Cloud“ konfigurieren

API-Schlüssel einrichten

So richten Sie den API-Schlüssel auf der Konfigurationsseite ein:

1. Geben Sie im Abschnitt API-Schlüsselkonfiguration den geheimen Schlüssel für die Authentifizierung von Anfragen an den Webtrigger der App an. Sie können Anfragen mit beiden der folgenden Methoden authentifizieren:

   • Eigenen Schlüssel eingeben: Geben Sie Ihren eigenen starken, eindeutigen API-Schlüssel in das Feld „API-Schlüssel“ ein oder fügen Sie ihn dort ein. Verwenden Sie einen Schlüssel mit mindestens 20 bis 30 Zeichen, der eine Kombination aus Großbuchstaben, Kleinbuchstaben, Zahlen und Symbolen enthält.

     

     Eigenen Schlüssel eingeben

   • Schlüssel generieren: Klicken Sie auf die Schaltfläche Neuen Schlüssel generieren. Das System generiert und zeigt einen starken, zufälligen Schlüssel im Feld an.

     

     Schlüssel generieren

     Wichtig: Kopieren Sie den im Feld angezeigten API-Schlüssel sofort. Aus Sicherheitsgründen kann es sein, dass Sie den vollständigen Schlüssel nach dem Speichern oder Verlassen der Seite nicht mehr sehen können. Wenn Sie ihn verlieren, müssen Sie einen neuen festlegen oder generieren.

2. Klicken Sie auf API-Schlüssel speichern. Eine Erfolgsmeldung bestätigt, dass der Schlüssel sicher gespeichert wurde.

Hinweis: Der in diesem Abschnitt generierte oder erstellte API-Schlüssel dient als Wert für das Feld Confluence Identity Sync Forge Client Secret im Abschnitt Erweiterte Optionen während der Connector-Einrichtung.

App-Konfiguration testen

Prüfen Sie, ob die User Identity Accessor for Confluence Cloud App richtig konfiguriert ist. Senden Sie dazu eine Anfrage von Ihrem externen System und prüfen Sie, ob die E-Mail-Adressen der Nutzer erfolgreich zurückgegeben werden.

Webtrigger-URL abrufen

1. Suchen Sie auf der Seite App-Verwaltung nach dem Abschnitt Webtrigger-URL Dort wird die eindeutige URL für Ihre Confluence-Website und diese App-Installation angezeigt:
   • Ihr externes System muss diese URL aufrufen, um Nutzer-E-Mail-Adressen anzufordern.
   • Die URL sieht in der Regel so aus: http://uuid/domain.net/x1/randomId. Beispiel: https://YOUR_INSTANCE_ID.hello.atlassian-dev.net/x1/WEBTRIGGER_ID, wobei YOUR_INSTANCE_ID die Kennung Ihrer Confluence Cloud-Instanz und WEBTRIGGER_ID die eindeutige Kennung für den für Ihre App generierten Webtrigger-Endpunkt ist.
2. Klicken Sie auf die Schaltfläche URL kopieren oder kopieren Sie die gesamte URL.

Externes System konfigurieren

• Konfigurieren Sie Ihr externes System, das Confluence-Nutzer-E-Mail-Adressen mit dem API-Schlüssel und der Webtrigger-URL abrufen muss, die Sie in den vorherigen Schritten erhalten haben.

  • Endpunkt-URL: Die Webtrigger-URL, die Sie kopiert haben.
  • HTTP-Methode: POST

  • Erforderliche Header:

    • Inhaltstyp: application/json

    • X-Api-Key: YOUR_API_KEY

      Ersetzen Sie YOUR_API_KEY durch den API-Schlüssel, den Sie im Abschnitt API-Schlüssel einrichten festgelegt oder generiert haben.

Beispiel: cURL-Befehls

In diesem Beispiel wird der Webtrigger User Identity Accessor for Confluence Cloud aufgerufen, der ein Array von Konto-IDs akzeptiert und die E-Mail-Adressen zurückgibt.

curl --location --request POST 'https://YOUR_INSTANCE_ID.hello.atlassian-dev.net/x1/ENDPOINT_PATH' \
--header 'X-Api-Key: YOUR-API-KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
   "accountIds": [
       "ACCOUNT_ID_1",
       "ACCOUNT_ID_2"
   ]
}'

Ersetzen Sie:

• YOUR_INSTANCE_ID durch Ihre Confluence Cloud-Instanz-ID
• ENDPOINT_PATH durch den API-Endpunktpfad
• YOUR_API_KEY durch den API-Schlüssel, den Sie im Abschnitt API-Schlüssel einrichten festgelegt oder generiert haben
• ACCOUNT_ID durch die Atlassian-Konto-IDs, die Sie als Zielgruppe verwenden möchten

Erwartete Antwort

[{"accountId":"ACCOUNT_ID_1","emailAddress":"EMAIL_ADDRESS_1"},
 {"accountId":"ACCOUNT_ID_2","emailAddress":"EMAIL_ADDRESS_2"}]

Ersetzen Sie:

• ACCOUNT_ID_X durch tatsächliche Atlassian-Konto-IDs
• USER_EMAIL_X durch Nutzer-E-Mail-Adressen, die von Ihrem API-Aufruf zurückgegeben werden

Best Practices für die Sicherheit implementieren

Folgen Sie diesen Empfehlungen, um die Sicherheit Ihres API-Schlüssels zu bestätigen:

• Speichern Sie den API-Schlüssel sicher in der Konfiguration Ihres Confluence Cloud-Connectors.
• Prüfen Sie, ob die gesamte Kommunikation mit der Webhook-URL über HTTPS erfolgt. Dies ist die Standardeinstellung für User Identity Accessor for Confluence Cloud-Webtrigger.

Unterstützung für User Identity Accessor für Confluence Cloud

Supportangebote sind von Google für die App User Identity Accessor for Confluence Cloud verfügbar, die Wartung und regelmäßige Updates enthalten können, um die App auf dem neuesten Stand zu halten. Wenn Sie Probleme oder Fragen zur App-Funktionalität haben, wenden Sie sich an den Google Cloud Support.

Confluence Cloud-Datenspeicher verwalten

In diesem Abschnitt finden Sie eine Anleitung zum Erstellen, Aktualisieren und Upgraden von Confluence Cloud-Datenspeichern.

Confluence Cloud-Datenspeicher erstellen

Console

So synchronisieren Sie mit der Google Cloud Console Daten von Confluence Cloud mit Gemini Enterprise:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Klicken Sie auf Datenspeicher erstellen.

4. Scrollen Sie auf der Seite Datenquelle auswählen nach unten oder suchen Sie nach Confluence Cloud, um die Drittanbieterquelle zu verbinden.

5. Führen Sie auf der Seite Confluence Cloud-Quelle für Ihren Datenspeicher angeben die folgenden Schritte aus:

   1. Authentifizierungsmethode auswählen

      

      Authentifizierungsdetails eingeben

      • Wenn Sie OAuth für die Authentifizierung verwenden möchten, wählen Sie OAuth 2.0-Clientanmeldedaten aus und geben Sie dann den Instanz-URI, die Instanz-ID, die Client-ID und den Clientschlüssel an.

        • Klicken Sie auf Anmelden und wählen Sie eine Website für die App aus.
        • Klicken Sie auf Akzeptieren.

        Die standardmäßige Ablaufzeit für ein Aktualisierungstoken beträgt 365 Tage. Wenn Ihr Aktualisierungstoken abläuft oder widerrufen wird, haben Sie folgende Möglichkeiten:

        • Starten Sie den OAuth-Ablauf noch einmal. Der Nutzer, der die Reauthentifizierung durchführt, muss Administratorberechtigungen haben.
        • Verwenden Sie das Aktualisierungstoken, um ein neues Zugriffstoken und ein neues Aktualisierungstoken zu erhalten.

        Weitere Informationen finden Sie unter Zugriffstoken läuft ab oder wird widerrufen.

        

        Website für die Verwendung der App auswählen

      • Wenn Sie ein API-Token für die Authentifizierung verwenden möchten, wählen Sie API-Token aus und geben Sie dann den Instanz-URI, den Confluence-Nutzernamen und das API-Token an.

   2. Klicken Sie auf Weiter.

6. Optional: Gehen Sie im Abschnitt Erweiterte Optionen so vor:

   1. Wenn Sie nur eine Reihe statischer IP-Adressen auf die Zulassungsliste setzen möchten, markieren Sie das Kästchen Statische IP-Adressen aktivieren.
   2. Wenn Sie Ratenbegrenzungen für die Abfragen anwenden möchten, die von den Connectors an die Confluence-Instanz gesendet werden, geben Sie im Feld Max. QPS die maximale Anzahl von Abfragen pro Sekunde an. Der Standardwert ist 20 Abfragen pro Sekunde. Sie können den Wert basierend auf der Leistung des Confluence-Servers schrittweise erhöhen. Beachten Sie Folgendes, bevor Sie den Wert für die Anzahl der Abfragen pro Sekunde erhöhen:
      • Die vorhandene Last auf dem Confluence-Server.
      • Der Durchsatz anderer Drittanbieteranwendungen, die den Server verwenden.
   3. Geben Sie im Feld Confluence Identity Sync Forge URL die URL ein, die von der App „User Identity Accessor for Confluence Cloud“ generiert wurde.
   4. Geben Sie im Feld Confluence Identity Sync Forge Client Secret den Clientschlüssel ein, der in User Identity Accessor for Confluence Cloud konfiguriert ist. Das ist der API-Schlüssel, den Sie im Abschnitt API-Schlüssel einrichten generiert oder erstellt haben.

7. Führen Sie im Abschnitt Zu synchronisierende Entitäten folgende Schritte aus:

   1. Wählen Sie die Entitäten aus, die Sie synchronisieren möchten.

      • Seite

      • Whiteboard

      • Blog

      • Anhang

      • Kommentar

      Die Daten werden basierend auf den Administratorberechtigungen aufgenommen, die Sie beim Erstellen des Datenspeichers haben. Zusätzlich zu den Administratorberechtigungen benötigen Sie auch Zugriff auf die spezifischen Entitätsdatensätze, z. B. Blogs oder Beiträge.

      Hinweis: Wenn Sie die Seitenentität synchronisieren, werden auch die Inhalte des Live-Dokuments synchronisiert.

      

      Zu synchronisierende Entitäten auswählen

   2. Optional können Sie Daten aus bestimmten Bereichen synchronisieren:

      1. Klicken Sie auf Filtern.
      2. Wenn Sie Entitäten aus dem Index herausfiltern möchten, wählen Sie Aus Index ausschließen. Wenn Sie dafür sorgen möchten, dass sie im Index enthalten sind, wählen Sie In den Index aufnehmen.
      3. Geben Sie die Gruppenbereichsschlüssel ein. Drücken Sie nach jeder Betätigung der Leertaste die Eingabetaste.
      4. Klicken Sie auf Speichern.

   

   Filter zum Ein- oder Ausschließen von Entitäten angeben.

8. Klicken Sie auf Weiter.

9. Wählen Sie die Häufigkeit der Synchronisierung für die vollständige Synchronisierung und die Häufigkeit der inkrementellen Synchronisierung für die inkrementelle Datensynchronisierung aus. Weitere Informationen finden Sie unter Synchronisierungszeitpläne.

   Wenn Sie separate vollständige Synchronisierungen von Entitäts- und Identitätsdaten planen möchten, maximieren Sie das Menü unter Vollständige Synchronisierung und wählen Sie Benutzerdefinierte Optionen aus.

   

   Separate Zeitpläne für die vollständige Synchronisierung von Entitäten und Identitäten festlegen.

10. Wählen Sie eine Region für Ihren Daten-Connector aus.

11. Geben Sie einen Namen für den Daten-Connector ein.

12. Klicken Sie auf Erstellen. Agentspace Enterprise erstellt den Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

13. Wenn Sie den Status der Aufnahme prüfen möchten, rufen Sie die Seite Datenspeicher auf und klicken auf den Namen des Datenspeichers, um entsprechende Details auf der Seite Daten anzeigen zu lassen. Der Connector-Status ändert sich von Wird erstellt zu Wird ausgeführt, wenn mit der Synchronisierung von Daten begonnen wird. Wenn die Datenaufnahme abgeschlossen ist, ändert sich der Status zu Aktiv. Das bedeutet, dass die Verbindung zu Ihrer Datenquelle eingerichtet ist und auf die nächste geplante Synchronisierung gewartet wird.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten oder mehrere Stunden dauern.

Datenspeicher aktualisieren

Sie können folgende Datenspeicherparameter aktualisieren:

• Name des Datenspeichers
• Anmeldedaten für die Authentifizierung, z. B. Client-ID, Clientschlüssel, Nutzerkonto und API-Token.
• Max QPS und Forge-App-Parameter, darunter die Forge-URL für die Confluence-Identitätssynchronisierung und das Client-Secret.
• Häufigkeit der vollständigen Synchronisierung, Häufigkeit der inkrementellen Synchronisierung und Echtzeitsynchronisierung.
• Filterbedingung für die Aufnahme von Entitätsdaten.

So aktualisieren Sie den Datenspeicher:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Klicken Sie auf den Namen des Datenspeichers, den Sie aktualisieren möchten.

4. Aktualisieren Sie die folgenden Werte:

   • Um den Namen des Datenspeichers, die Häufigkeit der vollständigen Synchronisierung oder die Häufigkeit der inkrementellen Synchronisierung zu aktualisieren, klicken Sie auf das Symbol Bearbeiten.
   • Um die Häufigkeit der Echtzeitsynchronisierung zu aktualisieren, klicken Sie neben Echtzeitsynchronisierung auf Ansehen/bearbeiten.
   • Um die Anmeldedaten für die Authentifizierung zu aktualisieren, klicken Sie auf Neu authentifizieren und geben die Werte an.
   • Um Max. QPS oder Forge-App-Parameter zu aktualisieren, klicken Sie auf Parameter ansehen/bearbeiten und geben die Werte an.
   • Um die Filterbedingung für die Entitäten zu aktualisieren, klicken Sie im Bereich Entitäten auf Parameter bearbeiten und dann auf Filter.

Auf einen neuen Datenspeicher upgraden

Wenn Sie Probleme mit der Genauigkeit der Suchergebnisse für Seitenentitäten haben, gehen Sie so vor, um auf die aktuelle Version des Datenspeichers zu aktualisieren:

1. Prüfen Sie, ob Sie die aktuelle Version des Datenspeichers verwenden:
   1. Klicken Sie im Navigationsmenü auf Datenspeicher.
   2. Klicken Sie auf den Namen des Datenspeichers.
   3. Klicken Sie auf der nun angezeigten Seite mit den Datenspeicherdetails auf dem Tab Entitäten auf die Entität Seite.
   4. Prüfen Sie auf der Seite Daten den Wert des Felds Typ. Ist der Wert Unstructured data, wird die aktuelle Version des Datenspeichers verwendet und es sind keine Maßnahmen erforderlich. Ist der Wert Structured data, fahren Sie mit den folgenden Schritten fort, um den neuen Datenspeicher zu erstellen und zu migrieren.
2. Erstellen Sie einen neuen Datenspeicher.
3. Achten Sie darauf, dass eine vollständige Synchronisierung des neuen Datenspeichers mit den erforderlichen Daten abgeschlossen wird.
4. Fügen Sie der App den neuen Datenspeicher hinzu.
5. Pausieren Sie die Synchronisierungen im vorherigen Datenspeicher.
6. Nachdem Sie bestätigt haben, dass der neue Datenspeicher für die Suche nach Seitenentitäten wie vorgesehen funktioniert, löschen Sie den älteren Datenspeicher aus der App.

Echtzeitsynchronisierung aktivieren

Vorschau: Sie müssen auf der Zulassungsliste stehen, um diese Funktion nutzen zu können.

Bei der Echtzeitsynchronisierung werden nur Dokumententitäten synchronisiert, keine Daten, die sich auf Identitätsentitäten beziehen. Die folgende Tabelle zeigt, welche Dokumentereignisse mit der Echtzeitsynchronisierung unterstützt werden.

Confluence-Entitäten	Erstellen	Aktualisieren	Löschen	Berechtigungsänderungen
Spaces
Seiten
Blogs
Anhänge
Kommentare
Whiteboards

Aktivieren Sie die Echtzeitsynchronisierung 20 Minuten nach der Erstellung des Confluence Cloud-Datenspeichers. So aktivieren Sie die Echtzeitsynchronisierung für eine Confluence-Datenquelle:

Webhook-URL generieren

1. Rufen Sie die Seite „Gemini Enterprise“ auf und klicken Sie im Navigationsmenü auf Datenspeicher.
2. Wählen Sie einen Confluence-Datenspeicher aus.

3. Klicken Sie in der Zeile Echtzeitsynchronisierung auf Ansehen/Bearbeiten.

   

   Echtzeitsynchronisierung : Deaktiviert

4. Führen Sie im Dialogfeld Parameter der Echtzeitsynchronisierung ansehen und bearbeiten die folgenden Schritte aus:

   1. Klicken Sie auf die Ein/Aus-Schaltfläche Echtzeitsynchronisierung aktivieren, um die Option zu aktivieren.
   2. Geben Sie im Feld Clientschlüssel einen Platzhalterwert ein, z. B. clientsecret.
   3. Klicken Sie auf Speichern.

      

      Echtzeitsynchronisierung aktivieren

5. Wenn sich der Status von Echtzeitsynchronisierung in Running ändert, klicken Sie auf Ansehen/Bearbeiten.

   

   Echtzeitsynchronisierung : Ausführungsstatus

6. Führen Sie im Dialogfeld Parameter der Echtzeitsynchronisierung ansehen und bearbeiten die folgenden Schritte aus:

   1. Kopieren Sie die URL unter Webhook URL (Webhook-URL).
   2. Klicken Sie auf Schließen.

      

      Webhook-URL kopieren

Ereignisse über die API abonnieren

Wenn Sie Echtzeit-Updates von Confluence erhalten möchten, müssen Sie bestimmte Ereignisse mit einer POST-Anfrage abonnieren. Verwenden Sie für API-Aufrufe das Administratorkonto, das Sie zum Einrichten der Authentifizierung und Berechtigungen in Confluence verwendet haben, um den Datenspeicher zu erstellen.

      curl -X POST \
        INSTANCE_URL/wiki/rest/webhooks/1.0/webhook \
        -H "Content-Type: application/json" \
        -u "USERNAME:API_TOKEN" \
        -d '{
          "name": "SUBSCRIPTION_NAME",
          "url": "LISTENER_URL",
          "events": [
            "EVENT_TYPE_1",
            "EVENT_TYPE_2"
          ],
          "active": true
        }'

• INSTANCE_URL: Die Basis-Webadresse für Ihre Atlassian Cloud-Website.

• USERNAME: Der Atlassian Cloud-Nutzername.

• API_TOKEN: Das API-Token, das in Ihrem Atlassian-Konto generiert wurde. Weitere Informationen finden Sie unter API-Token in Confluence einrichten.

• SUBSCRIPTION_NAME: Ein einmaliger Name für Ihr Ereignisabo.

• LISTENER_URL: Die Webhook-URL, die aus der Google Cloud -Konsole kopiert wurde, nachdem die Echtzeitsynchronisierung (Real-Time Sync, RTS) für Ihren Datenspeicher aktiviert wurde.

• EVENT_TYPE: Die Ereignistypen, die Sie abonnieren möchten. Sie können Ereignisse über Erstellungen, Aktualisierungen und Löschungen für Anhänge, Blogposts, Seiten, Bereiche und Kommentare abonnieren.

  Der Nutzer kann folgende Ereignisse abonnieren:

  • space_created
  • space_updated
  • page_created
  • page_updated
  • attachment_created
  • attachment_updated
  • comment_created
  • comment_updated
  • blog_created
  • blog_updated
  Hinweis: Whiteboard- und trashed-Ereignisse werden nicht unterstützt. Erstellen Sie Abos nur für Entitäten, die Ihrem Datenspeicher bereits hinzugefügt wurden, um die Aufnahme unerwünschter Daten zu vermeiden.

  Beispielbefehl und -ergebnis

  curl -X POST \
      https://cymbalgroup.atlassian.net/wiki/rest/webhooks/1.0/webhook \
      -H "Content-Type: application/json" \
      -u "admin1:######" \
      -d '{
        "name": "Cymbal_DCT",
        "events": [
          "attachment_created",
          "attachment_updated"
        ],
        "url": "https://rt-server-a-jx3m2-uw.a.run.app/webhook",
        "active": true
      }'
  
  {
  "name": "Cymbal_DCT",
  "url": "https://cymbalgroup.atlassian.net/wiki/rest/webhooks/1.0/webhook",
  "description": " Webhook for Cymbal DCT group to fetch attachments.",
  "excludeBody": false,
  "filters": {},
  "events": [
      "attachment_created",
      "attachment_updated",
  ],
  "enabled": true,
  "self": https://rt-server-a-jx3m2-uw.a.run.app/webhook,
  "lastUpdatedUser": "Cymb_389",
  "lastUpdatedDisplayName": "Ariel",
  "lastUpdated": 1752095647212
  }
  

API-Fehlercodes

In dieser Tabelle sind beim Erstellen von Webhooks häufig angezeigte API-Fehlercodes aufgelistet.

Fehlerklasse	Fehlercode	Fehlermeldung	Fehlerbehebung
403	FORBIDDEN	Der aktuelle Nutzer ist nicht berechtigt, Confluence zu verwenden.	Achten Sie darauf, dass Sie ein gültiges Token von einem Administratorkonto und den korrekten API-Endpunkt verwenden.

Fehlermeldungen

In der folgenden Tabelle werden häufige Fehlermeldungen, deren Beschreibungen und mögliche Lösungen beim Verbinden von Confluence Cloud mit Gemini Enterprise beschrieben.

Fehlercode	Fehlermeldung	Beschreibung	Fehlerbehebung
CONFLUENCE_INVALID_AUTHENTICATION_1	Authentifizierungsfehler. Weitere Informationen:	Der Connector kann sich nicht bei Confluence Cloud authentifizieren.	Authentifizieren Sie den Datenspeicher noch einmal mit Administratoranmeldedaten.
CONFLUENCE_INVALID_AUTHORIZATION_1	Autorisierungsfehler. Weitere Informationen:	Ein Nutzerkonto ohne Administratorberechtigungen hat versucht, auf Confluence Cloud zuzugreifen.	Authentifizieren Sie den Datenspeicher noch einmal mit Administratoranmeldedaten.
CONFLUENCE_TOO_MANY_REQUEST	Zu viele 429-HTTP-Anfragen an Confluence Cloud.	Die Anzahl der Anfragen, die vom Connector gesendet wurden, überschreitet den Standardwert für Abfragen pro Sekunde.	Wenn das Problem weiterhin besteht, reduzieren Sie diesen Wert des Datenspeichers über das Feld Max. QPS.

Bekannte Einschränkungen

• Das alte Nutzerverwaltungsmodell wird für die Integration in Confluence Cloud nicht unterstützt. Es wird nur das Modell der zentralen Nutzerverwaltung unterstützt. Weitere Informationen finden Sie im Leitfaden zur Konsolidierung von Atlassian-Organisationen.
• Das Erscheinungsbild der auf Confluence-Seiten hinzugefügten Makros kann je nach den Zugriffsberechtigungen des Nutzers variieren.
• Dieser Connector unterstützt keine inkrementelle Synchronisierung für die Einheit „Bereiche“.
• Sie können kein Google Cloud -Dienstkonto verwenden, um sich bei Confluence Cloud zu authentifizieren.

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter App erstellen.

• Hier finden Sie eine Vorschau der Suchergebnisse nach der Erstellung der App und des Datenspeichers.

• Informationen zum Aktivieren von Benachrichtigungen für den Datenspeicher finden Sie unter Benachrichtigungen für Drittanbieter-Datenspeicher konfigurieren.