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](confluence-kb-acl.md).
## Bevor Sie beginnen
Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie die Integration einrichten.
+ Eine Atlassian Confluence Cloud-Instanz.
+ Informationen zu den Anforderungen für ein Quick-Abonnement findest du unter. [Integrationen in der Konsole einrichten](integration-console-setup-process.md)
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](confluence-kb-acl.md#confluence-kb-atlassian-admin-credentials)
## 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.
1. Wähle unter **Knowledge** die Option **Atlassian Confluence Cloud und dann** die Schaltfläche Hinzufügen (plus „\+“) aus.
1. 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.
1. 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`
1. (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 unter[Besorgen Sie sich Atlassian-Administratoranmeldedaten](confluence-kb-acl.md#confluence-kb-atlassian-admin-credentials).
1. Wählen Sie **Weiter** aus.
1. 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.
1. (Optional) Geben Sie eine **Beschreibung** mit Hinweisen zur Verwendung der Wissensdatenbank ein.
1. 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}}`).
1. 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](confluence-kb-acl.md)
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.
1. 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).
1. 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](knowledge-base-integrations.md#file-size-and-content-limits)
## Wissensdatenbanken verwalten
### Bestehende Wissensdatenbanken bearbeiten
1. Wählen Sie in der Amazon Quick-Konsole **Knowledge Bases** aus.
1. Wählen Sie Ihre Confluence Cloud-Wissensdatenbank aus der Liste aus.
1. Wählen Sie unter **Aktionen** das Dreipunktsymbol und anschließend Wissensdatenbank **bearbeiten** aus.
1. Aktualisieren Sie Ihre Konfigurationseinstellungen nach Bedarf und wählen Sie **Speichern**.
## Fehlerbehebung
Informationen zum Bearbeiten, Teilen oder Löschen Ihrer Integration finden Sie unter[Verwaltung vorhandener Integrationen](integration-workflows.md#managing-existing-integrations).
Allgemeine Informationen zur Fehlerbehebung in der Wissensdatenbank, einschließlich Synchronisierungsproblemen und fehlenden Dokumenten, finden Sie unter[Wissensdatenbanken zur Fehlerbehebung](troubleshooting-knowledge-bases.md).
### 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.
1. Da der Administrator über Berechtigungen auf Site-Ebene verfügt, erscheint ein übersichtlicher Zustimmungsbildschirm ohne den Fehler.
1. 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 Apps`admin.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` und`team-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.
1. Stellen Sie sicher, dass Ihre Confluence Cloud-Instanz von Ihrem Netzwerk aus zugänglich ist.
1. 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.
1. Vergewissern Sie sich, dass die ausgewählten Inhaltstypen unterstützt werden (Seiten, Blogbeiträge und Anhänge).
1. Überprüfen Sie die Inhaltsauswahl in Ihrer Wissensdatenbank-Konfiguration, um sicherzustellen, dass die richtigen Bereiche und Seiten enthalten sind.
1. Ü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)](sync-reports-observability.md#sync-reports-acl-verification)