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.
# Dropbox-Integration
Mit dem Dropbox Action Connector können Sie in natürlicher Sprache direkt in Amazon Quick auf die Dropbox-Plattform zugreifen. Sie können Dateien hochladen, Ordnerstrukturen verwalten, Links zum Teilen generieren und nach Inhalten suchen, ohne Amazon Quick verlassen zu müssen.
Amazon Quick unterstützt mehrere Authentifizierungsmethoden für Dropbox. Wählen Sie die Methode, die den Sicherheitsanforderungen Ihres Unternehmens am besten entspricht.
+ **Standard-OAuth-Anwendung** — Verwendet eine AWS-verwaltete OAuth-Anwendung. Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Sie authentifizieren sich direkt mit Ihrem Dropbox-Konto.
+ **Benutzerdefinierte OAuth-App — Verwendet eine vom** Kunden verwaltete OAuth-Anwendung, die in Dropbox registriert ist. Mit dieser Option hat Ihr Unternehmen die volle Kontrolle über die OAuth-Konfiguration.
+ **API-Schlüssel** — Verwendet ein Dropbox-Zugriffstoken zur Authentifizierung. Diese Methode eignet sich für den individuellen Gebrauch oder zum Testen.
Weitere Informationen zu den Authentifizierungsmethoden, die Amazon Quick unterstützt, finden Sie unter[Authentifizierungsmethoden](quick-action-auth.md).
## Bevor Sie beginnen
Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie die Integration einrichten.
+ Ein aktives Dropbox-Konto mit Zugriff auf die Dateien und Ordner, die Sie verwenden möchten.
+ Für die **benutzerdefinierte OAuth-App**: Greifen Sie auf der Dropbox-Website auf die [Dropbox-App-Konsole](https://www.dropbox.com/developers/apps) zu, um eine App zu erstellen.
+ Für **API-Schlüssel**: Ein Zugriffstoken, das von der [Dropbox-App-Konsole auf der Dropbox-Website](https://www.dropbox.com/developers/apps) generiert wird.
+ Informationen zu den Amazon Quick-Abonnementanforderungen finden Sie unter[Integrationen in der Konsole einrichten](integration-console-setup-process.md).
## Dropbox konfigurieren
Wenn Sie die **standardmäßige OAuth-App-Authentifizierung** verwenden, überspringen Sie diesen Abschnitt und gehen Sie zu. [Den Connector in Amazon Quick einrichten](#dropbox-quicksuite-setup)
Führen Sie für die benutzerdefinierte OAuth-App- oder API-Schlüsselauthentifizierung die entsprechenden Schritte in Dropbox durch, bevor Sie Amazon Quick konfigurieren.
### Erstellen Sie eine Dropbox-App für die benutzerdefinierte OAuth-App
Erstellen Sie eine App in der Dropbox App Console, um die Kundenanmeldedaten zu erhalten, die Sie für Amazon Quick benötigen.
1. Melden Sie sich bei Ihrem Dropbox-Konto an und rufen Sie die [Dropbox App Console](https://www.dropbox.com/developers/apps) auf der Dropbox-Website auf.
1. Wählen Sie **App erstellen**.
1. Wählen Sie unter **API auswählen die Option** **Bereichsabhängiger Zugriff** aus.
1. Wählen Sie die Art des Zugriffs, den Sie benötigen:
+ **App-Ordner** — Ermöglicht den Zugriff nur auf einen bestimmten Ordner.
+ **Vollständige Dropbox** — Ermöglicht den Zugriff auf alle Dateien und Ordner.
1. Geben Sie einen App-Namen ein und wählen Sie **App erstellen**.
1. Notieren Sie sich auf der Seite mit den App-Einstellungen die folgenden Werte. Sie benötigen sie, wenn Sie Amazon Quick konfigurieren.
+ **App-Schlüssel** — Das ist Ihre Client-ID.
+ **Geheimer App-Schlüssel** — Dies ist Ihr Client-Geheimnis.
1. Fügen Sie unter **OAuth 2** im Abschnitt **Weiterleitungs-URIs die** Amazon Quick Callback-URL hinzu: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Wählen Sie die Registerkarte **Berechtigungen** und wählen Sie die Bereiche aus, die für Ihre Integration erforderlich sind. Die empfohlenen Bereiche finden Sie unter. [Empfohlene Bereiche](#dropbox-oauth-scopes)
### Generieren Sie ein Zugriffstoken für den API-Schlüssel
Generieren Sie in der Dropbox App Console ein Zugriffstoken für die API-Schlüsselauthentifizierung.
1. Melden Sie sich bei Ihrem Dropbox-Konto an und rufen Sie die [Dropbox App Console](https://www.dropbox.com/developers/apps) auf der Dropbox-Website auf.
1. Wählen Sie Ihre App aus oder erstellen Sie bei Bedarf eine neue.
1. Wählen Sie unter **OAuth 2** **Generate** aus, um ein Zugriffstoken zu erstellen.
1. Kopieren Sie das generierte Token und speichern Sie es sicher. Sie benötigen es, wenn Sie Amazon Quick konfigurieren.
### Empfohlene Bereiche
Wenn Sie eine Dropbox-App erstellen, konfigurieren Sie auf der Registerkarte „**Berechtigungen**“ die folgenden Bereiche auf der Grundlage der Aktionen, die Sie verwenden möchten.
**Von Dropbox empfohlene Bereiche**
| Scope | Description |
| --- | --- |
| account\_info.read | Liest Kontoinformationen. |
| account\_info.write | Aktualisiert die Kontoinformationen. |
| contacts.read | Liest Kontaktinformationen. |
| contacts.write | Aktualisiert die Kontaktinformationen. |
| events.read | Liest Einträge im Ereignisprotokoll. |
| events.write | Erstellt Einträge im Ereignisprotokoll. |
| file\_requests.read | Liest Dateianfragen. |
| file\_requests.write | Erzeugt und verwaltet Dateianfragen. |
| files.content.read | Liest den Dateiinhalt. |
| files.content.write | Erzeugt, ändert und löscht Dateien. |
| files.metadata.read | Liest Datei- und Ordner-Metadaten. |
| files.metadata.write | Bearbeitet Datei- und Ordner-Metadaten. |
| files.permanent\_delete | Löscht Dateien dauerhaft. |
| files.team\_metadata.read | Liest Metadaten von Teamdateien. |
| files.team\_metadata.write | Bearbeitet die Metadaten der Teamdatei. |
| groups.read | Liest Gruppeninformationen. |
| groups.write | Verwaltet Gruppen. |
| members.delete | Entfernt Teammitglieder. |
| members.read | Liest Informationen zu Teammitgliedern. |
| members.write | Verwaltet Teammitglieder. |
| sessions.list | Listet aktive Sitzungen auf. |
| sessions.modify | Ändert aktive Sitzungen. |
| sharing.read | Liest Freigabeeinstellungen und geteilte Links. |
| sharing.write | Erstellt und verwaltet geteilte Links und die gemeinsame Nutzung von Ordnern. |
| team\_data.content.read | Liest Teaminhalte. |
| team\_data.content.write | Verwaltet Teaminhalte. |
| team\_data.governance.read | Liest die Datenverwaltungseinstellungen des Teams. |
| team\_data.governance.write | Verwaltet die Einstellungen für die Datenverwaltung im Team. |
| team\_data.team\_space | Greift auf Team-Space-Daten zu. |
| team\_info.read | Liest Teaminformationen. |
| team\_info.write | Aktualisiert die Teaminformationen. |
## Den Connector in Amazon Quick einrichten
### Über die Registerkarte „Verfügbar“ eine Connect
Wenn Sie die standardmäßige OAuth-App-Authentifizierung verwenden möchten, können Sie ohne zusätzliche Konfiguration direkt über die Registerkarte **Verfügbar** eine Verbindung herstellen.
1. Wählen Sie in der Amazon Quick-Konsole **Connectors** aus.
1. Suchen Sie auf dem Tab **Verfügbar** nach **Dropbox** und wählen Sie **Connect** aus.
1. Schließen Sie den Dropbox-Anmeldevorgang ab und gewähren Sie die angeforderten Berechtigungen.
Um stattdessen einen Connector mit einer benutzerdefinierten OAuth-App oder einem API-Schlüssel zu konfigurieren, verwenden Sie den Tab „**Für Ihr Team erstellen**“ wie unten beschrieben.
### Erstellen Sie auf der Registerkarte „Für Ihr Team erstellen“
Nachdem Sie alle erforderlichen Dropbox-Konfigurationen abgeschlossen haben, erstellen Sie den Connector in Amazon Quick.
1. Wählen Sie in der Amazon Quick-Konsole **Connectors** aus.
1. Wählen Sie den Tab „**Für Ihr Team erstellen**“.
1. Suchen Sie **Dropbox** und wählen Sie es aus.
**Anmerkung**
Wenn bereits ein Dropbox-Connector vorhanden ist, wird ein Dialogfeld mit Ihren vorhandenen Connectoren angezeigt. Um einen vorhandenen Connector zu verwenden, wählen Sie ihn aus. Um einen neuen zu erstellen, wählen Sie **Nein, neu erstellen**.
1. Geben Sie einen **Namen** für Ihren Connector ein. Wählen Sie optional **\+ Beschreibung hinzufügen**, um eine Beschreibung hinzuzufügen.
1. Wählen Sie als **Verbindungstyp** die Option **Öffentliches Netzwerk** aus.
1. Wählen Sie für die **OAuth-Konfiguration** eine der folgenden Authentifizierungsmethoden und konfigurieren Sie die erforderlichen Felder.
1. Für die **Standard-OAuth-App**:
Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Wählen Sie **Next** (Weiter), um fortzufahren.
1. Konfigurieren **Sie für die benutzerdefinierte OAuth-App** die folgenden Felder:
+ **Basis-URL** (optional) — Die Dropbox-API-Basis-URL. Beispiel: `https://api.dropboxapi.com`
+ **Client-ID** — Der App-Schlüssel aus Ihrer Dropbox-App.
+ **Geheimer Kunde** — Der geheime App-Schlüssel aus Ihrer Dropbox-App.
+ **Token-URL** — Der Token-Endpunkt. Beispiel: `https://api.dropboxapi.com/oauth2/token`
+ **Autorisierungs-URL** — Der Autorisierungsendpunkt. Beispiel: `https://www.dropbox.com/oauth2/authorize`
+ **Weiterleitungs-URL** — Pre-filled mit der Amazon Quick Callback-URL.
1. Konfigurieren Sie für den **API-Schlüssel** die folgenden Felder:
+ **Basis-URL** (optional) — Die Dropbox-API-Basis-URL. Beispiel: `https://api.dropboxapi.com`
+ **API-Schlüssel** — Ihr Dropbox-Zugriffstoken.
+ **E-Mail** (optional) — Die E-Mail-Adresse, die mit Ihrem Dropbox-Konto verknüpft ist.
1. Wählen Sie **Weiter** aus.
1. Wenn Sie die **Standard-OAuth-App oder die **benutzerdefinierte OAuth-App**** ausgewählt haben, wird ein Dropbox-Autorisierungsfenster geöffnet. **Überprüfen Sie die angeforderten Berechtigungen und wählen Sie Zulassen.**
1. **Überprüfen Sie** auf der Seite Überprüfen die verfügbaren Aktionen für den Connector. Wählen Sie **Weiter** aus.
1. Wählen Sie auf der Seite **Veröffentlichen** aus, wer auf den Connector zugreifen kann. Sie können den Zugriff für alle in Ihrer Organisation aktivieren oder nach bestimmten Teams oder Gruppen suchen.
1. Wählen Sie **Publish**.
## Verfügbare Aktionen
Nachdem Sie den Connector eingerichtet haben, sind die folgenden Aktionen verfügbar.
**Verfügbare Aktionen in Dropbox**
| Kategorie | Action | Description |
| --- | --- | --- |
| Dateien | Dateien auflisten | Listet Dateien in einem Ordner auf. |
| Dateien | Datei abrufen | Liest den Inhalt einer Datei. |
| Dateien | Datei importieren | Lädt eine Datei auf Dropbox hoch. |
| Dateien | Suchen Sie nach Dateien | Sucht nach Dateien oder Ordnern nach Namen oder Inhalt. |
| Dateien | Dateispeicherort aktualisieren | Verschiebt eine Datei oder einen Ordner an einen anderen Speicherort. |
| Dateien | Temporären Link abrufen | Generiert einen temporären Download-Link für eine Datei. |
| Dateien | Abrufen von Metadaten | Ruft Metadaten für eine Datei oder einen Ordner ab. |
| Dateien | Datei aus URL speichern | Speichert eine Datei von einer URL in Dropbox. |
| Ordner | Ordner erstellen | Erstellt einen neuen Ordner. |
| Ordner | Ordner auflisten | Liste der Ordner, auf die der Benutzer Zugriff hat. |
| Batch-Vorgänge | Batch Move-Status abrufen | Überprüft den Status eines Batch-Move-Vorgangs. |
| Teilen | Geteilten Link erstellen | Erstellt einen geteilten Link für eine Datei oder einen Ordner. |
| Teilen | Listet gemeinsam genutzte Links auf | Listet gemeinsam genutzte Links für eine Datei oder einen Ordner auf. |
| Teilen | Ordnerfreigabe aktualisieren | Teilt einen Ordner mit anderen Benutzern. |
| Teilen | Empfangene Dateien auflisten | Listet Dateien auf, die andere Benutzer mit Ihnen geteilt haben. |
| Dateianfragen | Dateianfrage erstellen | Erstellt eine Dateianfrage, in die andere Dateien hochladen können. |
| Account | Benutzer abrufen | Ruft Informationen über den authentifizierten Benutzer ab. |
| Account | Speichernutzung abrufen | Ruft die Speicherplatznutzung für das Konto ab. |
**Anmerkung**
Die Aktionen, die Sie verwenden können, hängen von den Dateien und Ordnern ab, auf die der authentifizierte Benutzer zugreifen kann.
## Verwaltung und Problembehandlung
Informationen zum Bearbeiten, Teilen oder Löschen Ihres Connectors finden Sie unter[Verwaltung vorhandener Integrationen](integration-workflows.md#managing-existing-integrations).
### Probleme bei der Authentifizierung
+ **Sign-in schlägt fehl (Standard-OAuth-App oder benutzerdefinierte OAuth-App)** — Stellen Sie sicher, dass Ihr Dropbox-Konto aktiv ist und Sie sich direkt auf [der](https://www.dropbox.com) Dropbox-Website anmelden können. Stellen Sie für die benutzerdefinierte OAuth-App sicher, dass die Weiterleitungs-URL in Ihrer Dropbox-App mit der Amazon Quick Callback-URL übereinstimmt.
+ **Ungültige Kundenanmeldedaten (benutzerdefinierte OAuth-App)** — Stellen Sie sicher, dass die Client-ID und der geheime Client-Schlüssel mit den Werten für App-Schlüssel und geheime App in Ihrer Dropbox-App übereinstimmen. Wenn Sie den App-Secret neu generiert haben, aktualisieren Sie den Wert in Amazon Quick.
+ **API-Schlüssel abgelehnt** — Stellen Sie sicher, dass Ihr Zugriffstoken aktiv ist. Token können in der Dropbox App Console ablaufen oder gesperrt werden.
+ **Unzureichende Berechtigungen** — Stellen Sie sicher, dass Ihre Dropbox-App über die erforderlichen Rechtebereiche für die Aktionen verfügt, die Sie verwenden möchten.