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 unterAuthentifizierungsmethoden.

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 zu, um eine App zu erstellen.

• Für API-Schlüssel: Ein Zugriffstoken, das von der Dropbox-App-Konsole auf der Dropbox-Website generiert wird.

• Informationen zu den Amazon Quick-Abonnementanforderungen finden Sie unterIntegrationen in der Konsole einrichten.

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

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 auf der Dropbox-Website auf.

2. Wählen Sie App erstellen.

3. Wählen Sie unter API auswählen die Option Bereichsabhängiger Zugriff aus.

4. 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.

5. Geben Sie einen App-Namen ein und wählen Sie App erstellen.

6. 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.

7. Fügen Sie unter OAuth 2 im Abschnitt Weiterleitungs-URIs die Amazon Quick Callback-URL hinzu: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

8. 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

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 auf der Dropbox-Website auf.

2. Wählen Sie Ihre App aus oder erstellen Sie bei Bedarf eine neue.

3. Wählen Sie unter OAuth 2 Generate aus, um ein Zugriffstoken zu erstellen.

4. 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.

2. Suchen Sie auf dem Tab Verfügbar nach Dropbox und wählen Sie Connect aus.

3. 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.

2. Wählen Sie den Tab „Für Ihr Team erstellen“.

3. 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.

4. Geben Sie einen Namen für Ihren Connector ein. Wählen Sie optional + Beschreibung hinzufügen, um eine Beschreibung hinzuzufügen.

5. Wählen Sie als Verbindungstyp die Option Öffentliches Netzwerk aus.

6. 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.

   2. 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.

   3. 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.

7. Wählen Sie Weiter aus.

8. 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.

9. Überprüfen Sie auf der Seite Überprüfen die verfügbaren Aktionen für den Connector. Wählen Sie Weiter aus.

10. 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.

11. 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 unterVerwaltung vorhandener Integrationen.

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 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.