View a markdown version of this page

Integration der Atlassian Confluence Cloud-Wissensdatenbank - Amazon Quick
Bevor Sie beginnenRichten Sie die Wissensdatenbank-Integration einUnterstützte InhaltstypenWissensdatenbanken verwaltenFehlerbehebung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Integration der Atlassian Confluence Cloud-Wissensdatenbank

Verwende die Atlassian Confluence Cloud-Knowledgebase-Integration, um Confluence-Inhalte zu indexieren, sodass Amazon Quick-Agenten danach suchen und Fragen dazu beantworten können. Amazon Quick unterstützt optionale Zugriffskontrollen (ACLs) auf Dokumentenebene für Confluence-Wissensdatenbanken. Wenn diese Option aktiviert ist, sehen Benutzer in Confluence nur Antworten aus Dokumenten, für deren Zugriff sie autorisiert sind. Weitere Informationen finden Sie unter Document-level Zugriffskontrollen.

Bevor Sie beginnen

Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie die Integration einrichten.

Wenn du vorhast, Zugriffskontrollen auf Dokumentenebene zu aktivieren, musst du bei der Einrichtung Atlassian-Administratoranmeldedaten angeben. Diese Anmeldeinformationen ermöglichen Amazon Quick den Zugriff auf alle Benutzer- und Gruppeninformationen, unabhängig von den individuellen E-Mail-Sichtbarkeitseinstellungen. Ohne Administratoranmeldedaten ist die ACL-Option bei der Erstellung der Wissensdatenbank nicht verfügbar. Um Administratoranmeldedaten bereitzustellen, benötigst du Folgendes von deinem Atlassian-Organisationsadministrator:

  • Atlassian Admin-API-Schlüssel — Eine alphanumerische Zeichenfolge, die im Atlassian Admin-Portal generiert wurde.

  • Organisations-ID (UUID) — Die eindeutige Kennung für deine Atlassian-Organisation. Du findest sie in der URL deines Browsers, wenn du im Admin-Portal angemeldet bist:. admin.atlassian.com/o/orgId

  • Verzeichnis-ID (UUID) — Die eindeutige Kennung für Ihr Benutzerverzeichnis. Rufe diesen Wert mithilfe der Atlassian Admin Workspace API ab.

Eine ausführliche Anleitung zum Abrufen dieser Anmeldedaten findest du unter. Besorgen Sie sich Atlassian-Administratoranmeldedaten

Richten Sie die Wissensdatenbank-Integration ein

Der Einrichtungsassistent besteht aus drei Schritten: Authentifizierung, Erstellung der Wissensdatenbank und zusätzliche Einstellungen.

Authentifizieren Sie Ihr Konto

  1. Wählen Sie in der Amazon Quick-Konsole Knowledge aus.

  2. Wähle unter Knowledge die Option Atlassian Confluence Cloud und dann die Schaltfläche Hinzufügen (plus „+“) aus.

  3. Wähle im Dialogfeld „Confluence-Wissensdatenbank erstellen“ unter Authentifizierungsmethode ein vorhandenes verbundenes Konto aus dem Drop-down-Menü „Name“ aus oder wähle Konto hinzufügen aus, um eine neue Verbindung herzustellen.

  4. Wenn Sie ein neues Konto hinzufügen, füllen Sie die folgenden Felder aus:

    • Name — Ein beschreibender Name für Ihre Verbindung.

    • Beschreibung (optional) — Hinweise zur Verbindung.

    • Confluence-URL — Die URL deiner Atlassian-Site (z. B.). https://your-site.atlassian.net

  5. (Optional) Wähle unter ACL Management die Option Atlassian-Administratoranmeldedaten verwenden aus, um Atlassian-Administratoranmeldedaten bereitzustellen. Wenn diese Option ausgewählt ist, gib Folgendes ein:

    • API-Schlüssel — Der Admin-API-Schlüssel von Atlassian.

    • OrganizationID (UUID) — Deine Atlassian-Organisations-ID.

    • Verzeichnis-ID (UUID) — Deine Atlassian-Benutzerverzeichnis-ID.

    Wichtig

    Atlassian-Administratoranmeldedaten sind erforderlich, um Zugriffskontrollen (ACLs) auf Dokumentebene in den zusätzlichen Einstellungen zu aktivieren. Ohne Administratoranmeldedaten ist die ACL-Option deaktiviert. Administratoranmeldedaten können nicht hinzugefügt werden, nachdem die Wissensdatenbank erstellt wurde. Anweisungen zum Abrufen dieser Anmeldeinformationen finden Sie unterBesorgen Sie sich Atlassian-Administratoranmeldedaten.

  6. Wählen Sie Weiter aus.

  7. Füllen Sie das angezeigte Confluence Cloud-Authentifizierungs-Popup aus. Überprüfen Sie die angeforderten Berechtigungen und wählen Sie Akzeptieren, um Amazon Quick den Zugriff auf Ihre Confluence-Inhalte zu autorisieren.

Erstellen Sie die Wissensdatenbank

  1. Geben Sie unter Wissensdatenbank erstellen einen Namen für Ihre Wissensdatenbank ein.

  2. (Optional) Geben Sie eine Beschreibung mit Hinweisen zur Verwendung der Wissensdatenbank ein.

  3. Fügen Sie unter Confluence-URLs die URLs der Confluence-Bereiche, -Blogs oder -Seiten ein, die Sie einbeziehen möchten. Wählen Sie nach jeder URL Hinzufügen aus.

    Anmerkung

    URLs, die der Struktur folgen, https://company.atlassian.net/wiki/spaces/space-key/overview werden als Seiten-URLs behandelt, nicht als Leerzeichen-URLs. Um einen gesamten Bereich zu indizieren, verwenden Sie die Space-URL ohne /overview (z. B.https://company.atlassian.net/wiki/spaces/space-key).

  4. Wählen Sie Weiter: Zusätzliche Einstellungen, um Zugriffskontrollen und Indizierungsoptionen zu konfigurieren, oder wählen Sie Erstellen, um die Wissensdatenbank mit Standardeinstellungen zu erstellen.

Konfigurieren Sie zusätzliche Einstellungen

  1. Um Zugriffskontrollen auf Dokumentebene zu aktivieren, wählen Sie Dokumentenzugriff mit ACLs kontrollieren aus. Diese Option ist nur verfügbar, wenn du Atlassian-Administratoranmeldedaten in der Authentifizierungsmethode angegeben hast. Wenn diese Option aktiviert ist, synchronisiert Amazon Quick die Zugriffskontrolllisten von Confluence und überprüft die Berechtigungen jedes Benutzers bei der Abfrage. Weitere Informationen zur Funktionsweise der Zugriffskontrollen finden Sie unter. Document-level Zugriffskontrollen

    Wenn Sie ACLs nicht aktivieren, wird der Zugriff auf der Ebene der Wissensdatenbank gesteuert. Jeder, der Zugriff auf die Wissensdatenbank hat, kann Einblicke in den gesamten Inhalt der Wissensdatenbank erhalten. Wenn ACLs aktiviert sind, wird der Zugriff auf Dokumentenebene gesteuert. Benutzer, die Zugriff auf die Wissensdatenbank haben, sehen in Confluence nur Antworten aus Dokumenten, für deren Zugriff sie autorisiert sind.

    Wichtig

    Das ACL-Management kann nach der Erstellung der Wissensdatenbank nicht mehr geändert werden. Wenn Sie diese Einstellung ändern müssen, müssen Sie eine neue Wissensdatenbank erstellen.

    Anmerkung

    Wenn du in der Authentifizierungsmethode keine Atlassian-Administratoranmeldedaten angegeben hast, ist diese Option deaktiviert. Um ACLs zu aktivieren, wähle im Assistenten „Zurück“ oder „Abbrechen“ und beginne erneut mit einem verbundenen Konto, das Administratoranmeldedaten enthält.

  2. Konfigurieren Sie unter Multi-media Inhalt, Dateigröße und Dateimuster die folgenden Indizierungsoptionen nach Bedarf:

    • Visueller Inhalt in Dokumenten — Indizieren Sie visuelle Inhalte wie Bilder und Diagramme, die in Dokumente eingebettet sind.

    • Audiodateien — Indizieren Sie Audiodateianhänge.

    • Videodateien — Indizieren Sie Videodateianhänge.

    • Maximale Einzeldateigröße — Die maximale Dateigröße für einzelne Anhänge (Standard: 50 MB).

  3. Wählen Sie Erstellen aus.

Unterstützte Inhaltstypen

  • Confluence-Seiten und Blogbeiträge

  • Anlagen für Seiten- und Blogbeiträge

Wenn Sie eine Confluence-Space-URL hinzufügen, crawlt Amazon Quick alle Seiten und Blogbeiträge in diesem Bereich. Informationen zu den unterstützten Dateitypen und Größenbeschränkungen für Anlagen finden Sie unter. Beschränkungen für Dateigröße und Inhalt

Wissensdatenbanken verwalten

Bestehende Wissensdatenbanken bearbeiten

  1. Wählen Sie in der Amazon Quick-Konsole Knowledge Bases aus.

  2. Wählen Sie Ihre Confluence Cloud-Wissensdatenbank aus der Liste aus.

  3. Wählen Sie unter Aktionen das Dreipunktsymbol und anschließend Wissensdatenbank bearbeiten aus.

  4. Aktualisieren Sie Ihre Konfigurationseinstellungen nach Bedarf und wählen Sie Speichern.

Fehlerbehebung

Informationen zum Bearbeiten, Teilen oder Löschen Ihrer Integration finden Sie unterVerwaltung vorhandener Integrationen.

Allgemeine Informationen zur Fehlerbehebung in der Wissensdatenbank, einschließlich Synchronisierungsproblemen und fehlenden Dokumenten, finden Sie unterWissensdatenbanken zur Fehlerbehebung.

Die Autorisierung der OAuth-App wurde blockiert

Symptome:

  • Fehlermeldung: „Dein Site-Administrator muss diese App für die Website instance-name .atlassian.net autorisieren, bevor die App auf dein Konto zugreifen kann.“

  • Die Auswahl von „Akzeptieren“ im Zustimmungsdialogfeld hat keine Auswirkung.

Ursache:

Dein Atlassian-Site-Administrator hat vom Nutzer installierte OAuth-Apps blockiert. Wenn diese Einstellung aktiviert ist, kann nur ein Site- oder Organisationsadministrator neue Apps von Drittanbietern autorisieren.

Schritte zur Lösung:

Verwenden Sie eine der folgenden Optionen, um dieses Problem zu beheben.

  • Option 1 (empfohlen): Der Administrator autorisiert die App direkt

    1. Ein Atlassian-Site-Administrator navigiert zu Amazon Quick und startet eine neue Wissensdatenbankeinrichtung mit Confluence Cloud.

    2. Da der Administrator über Berechtigungen auf Site-Ebene verfügt, erscheint ein übersichtlicher Zustimmungsbildschirm ohne den Fehler.

    3. Der Administrator wählt Accept, um die App zu installieren.

    Nachdem der Administrator die App autorisiert hat, können alle anderen Benutzer auf der Site problemlos eine Verbindung herstellen.

  • Option 2: Vom Nutzer installierte Apps vorübergehend zulassen — Ein Administrator geht zu Appsadmin.atlassian.com, Atlassian Apps und wählt dann den Link für Drittanbieter- und Marketplace-Apps aus. Suche unter Einstellungen nach Vom Nutzer installierte Apps und aktiviere die Option, Benutzer-Apps zuzulassen. Nachdem der Benutzer Amazon Quick autorisiert hat, schalten Sie die Einstellung zurück, um Benutzer-Apps zu blockieren.

Wichtig

Die Administratorautorisierung gilt pro Atlassian-Site, nicht pro Organisation. Wenn dein Unternehmen mehrere Websites hat (z. B. team-a.atlassian.net undteam-b.atlassian.net), ist für jede Site eine separate Autorisierung erforderlich.

Anmerkung

Während vom Benutzer installierte Apps entsperrt werden (Option 2), kann jeder Benutzer auf der Website jede OAuth-App autorisieren. Re-enable das Blockieren sofort, nachdem der Benutzer eine Verbindung hergestellt hat.

Das Authentifizierungs-Popup schlägt fehl

Symptome:

  • Das Authentifizierungs-Popup wird nicht angezeigt oder wird sofort geschlossen.

  • Das Popup wird angezeigt, der OAuth-Flow kann jedoch nicht abgeschlossen werden.

Schritte zur Lösung:

  1. Stellen Sie sicher, dass Ihr Browser Popups aus der Amazon Quick Console-Domain zulässt.

  2. Stellen Sie sicher, dass Ihre Confluence Cloud-Instanz von Ihrem Netzwerk aus zugänglich ist.

  3. Versuchen Sie, einen anderen Browser zu verwenden oder Ihren Browser-Cache zu leeren.

Fehlender Inhalt in der Wissensdatenbank

Symptome:

  • Die Wissensdatenbank-Synchronisierung ist abgeschlossen, aber der erwartete Inhalt ist nicht indexiert.

  • Die Suchergebnisse enthalten keine Inhalte aus bestimmten Bereichen oder Seiten.

  • Nur ein Dokument wird für einen gesamten Bereich indexiert.

Schritte zur Lösung:

  1. Stellen Sie sicher, dass der Confluence Cloud-Benutzer, der sich authentifiziert hat, Zugriff auf die Bereiche und Seiten hat, die Sie bei der Einrichtung ausgewählt haben.

  2. Vergewissern Sie sich, dass die ausgewählten Inhaltstypen unterstützt werden (Seiten, Blogbeiträge und Anhänge).

  3. Überprüfen Sie die Inhaltsauswahl in Ihrer Wissensdatenbank-Konfiguration, um sicherzustellen, dass die richtigen Bereiche und Seiten enthalten sind.

  4. Überprüfen Sie Ihre Confluence-URLs auf das /overview Suffix. URLs, die mit enden, /wiki/spaces/space-key/overview werden als einseitige URL behandelt, nicht als ganzes Leerzeichen. Wenn Sie den gesamten Bereich indizieren möchten, verwenden Sie die Space-URL ohne /overview (z. B.https://company.atlassian.net/wiki/spaces/space-key).

ACL-related Probleme

Keine Ergebnisse aus der ACL-enabled Wissensdatenbank

  • Stellen Sie sicher, dass sich der Endbenutzer bei Confluence angemeldet hat, wenn Sie bei seiner ersten Anfrage dazu aufgefordert werden. Die Anmeldung ist für die Überprüfung der Berechtigungen in Echtzeit erforderlich.

  • Stellen Sie sicher, dass der Endbenutzer Zugriff auf die relevanten Confluence-Inhalte in seiner Confluence-Instanz hat.

Dokumente, die bei der Synchronisierung übersprungen wurden

  • Wenn in Synchronisierungsberichten Elemente mit dem Status ÜBERSPRUNGEN angezeigt werden, vergewissern Sie sich, dass der authentifizierende Benutzer Zugriff auf die Confluence-Bereiche und -Seiten hat, die in der Wissensdatenbank enthalten sind.

  • Weitere Informationen zur Überprüfung des Dokumentenzugriffs finden Sie unter. Überprüfen Sie den Zugriff auf Dokumente (ACL-Überprüfung)