Wie richte ich eine Dropbox-App ein?

Erstellen Sie eine Dropbox-App, wählen Sie die Berechtigungen, die Ihr Workflow benötigt, und verbinden Sie die App über Template-Zugangsdaten. Transloadit übernimmt die OAuth-Weiterleitung und den Token-Austausch. Sie müssen weder einen eigenen Callback erstellen noch ein temporäres Zugriffstoken in Ihr Template einfügen.

App erstellen

Melden Sie sich bei der Dropbox-App-Konsole⁠ mit dem Konto an, dem die App gehören soll. Wählen Sie Create app und dann Scoped access aus.

Wählen Sie App folder aus, wenn der Workflow nur Dateien im eigenen Ordner der App benötigt. Wählen Sie Full Dropbox nur aus, wenn er Dateien an anderer Stelle im verbundenen Konto benötigt. Benennen Sie die App und wählen Sie Create app aus.

Bei Zugriff mit App folder sind die Pfade im Robot relativ zum Ordner der App, nicht zum Stammverzeichnis des Dropbox-Kontos. Nehmen Sie den Pfad zu diesem App-Ordner auf Kontoebene nicht in den Robot-Pfad auf.

Berechtigungen auswählen

Öffnen Sie in der App den Tab Permissions und aktivieren Sie die Scopes, die Ihr Workflow benötigt:

Stellen Sie bei Importen aus einem Dropbox-Business-Teambereich mit der Zugriffsart Full Dropbox sicher, dass account_info.read ausgewählt ist, damit Transloadit den Dateinamespace des Kontos auflösen kann. Wenn der Workflow Dateien importiert und exportiert, aktivieren Sie beide Gruppen von Dateiberechtigungen. Wählen Sie Submit aus, um die Änderungen zu speichern, bevor Sie die App verbinden.

Weiterleitungs-URI registrieren

Suchen Sie auf dem Tab Settings der App nach OAuth 2 und tragen Sie unter Redirect URIs exakt den folgenden Wert ein:

https://webapi.transloadit.com/credentials/dropbox

Wählen Sie Add aus, um ihn zu registrieren. Dies ist der Callback von Transloadit, keine URL auf Ihrer Website. Halten Sie App key und App secret der App für den nächsten Schritt bereit. Das Secret darf niemals in Browser-Code, Screenshots oder geteilten Templates enthalten sein.

App mit Transloadit verbinden

Folgen Sie der Anleitung So erstellen Sie Template-Zugangsdaten im Workspace, in dem Ihre Assemblies ausgeführt werden. Wählen Sie Dropbox als Service und geben Sie für den Zugangsdaten-Eintrag unter Name eine gut erkennbare Bezeichnung an. Tragen Sie Dropbox-App-Schlüssel und Dropbox-App-Secret aus den Einstellungen Ihrer App ein.

Wählen Sie Erstellen, um die Autorisierungsseite von Dropbox zu öffnen. Melden Sie sich beim Dropbox-Konto an, dessen Dateien der Workflow verwenden soll, und genehmigen Sie den angeforderten Zugriff. Dropbox leitet Sie zu Transloadit zurück, und Transloadit speichert den Zugangsdaten-Eintrag. Prüfen Sie, ob er auf der Seite Zugangsdaten im Workspace erscheint, bevor Sie seinen Namen als Wert für den Parameter credentials im Robot verwenden.

Eine App zu erstellen ist nicht dasselbe, wie sie zu autorisieren. Wenn Sie die Autorisierung abbrechen oder ein Fehler auftritt, gehen Sie nicht davon aus, dass der Zugangsdaten-Eintrag gespeichert wurde. Prüfen Sie die Weiterleitungs-URI und die App-Berechtigungen und starten Sie dann den Verbindungsaufbau erneut. Prüfen Sie auf der Zustimmungsseite von Dropbox das Konto und den angeforderten Zugriff. Genehmigen Sie nur den Zugriff, den Sie gewähren möchten.

Wenn Sie die App-Berechtigungen später ändern, werden diese Berechtigungen einer bestehenden Autorisierung nicht hinzugefügt. Erstellen Sie einen neuen Eintrag für Template-Zugangsdaten und genehmigen Sie den Zugriff erneut. Aktualisieren Sie anschließend Ihre Templates, damit sie den neuen Namen verwenden. Nehmen Sie ersetzte Zugangsdaten erst außer Betrieb, nachdem Sie sich vergewissert haben, dass kein Workflow sie mehr nutzt. Wenn Transloadit Sie auffordert, Ihr Passwort erneut zu bestätigen, schließen Sie diesen Schritt ab, bevor Sie den Verbindungsaufbau erneut starten.

Details zur App-Einrichtung und Autorisierung bei Dropbox finden Sie im Schnellstart⁠ und im OAuth-Leitfaden⁠.