Zugangsdaten für Drittanbieter

Transloadit kann Dateien aus Ihrem Cloud-Bucket oder von Ihrem Server importieren und dorthin exportieren. Zur Authentifizierung benötigen wir Zugangsdaten. Verwenden Sie für Exporte möglichst Zugangsdaten mit reinem Schreibzugriff. Sie können diese direkt als Parameter für den Robot zum Import oder Export festlegen (oft mit key und secret). Wir empfehlen jedoch Template-Zugangsdaten. Damit speichern Sie die Zugangsdaten separat, vergeben einen eindeutigen Namen und verweisen dann über diesen Namen in credentials, dem Robot-Parameter, darauf. Weitere Informationen finden Sie in der jeweiligen Robot-Dokumentation.

Hinweis

Die Verwendung von Template-Zugangsdaten ist vollkommen optional.

Mit Template-Zugangsdaten können Sie:

Sensible Zugangsdaten des Anbieters aus dem JSON für das Template heraushalten, das Sie teilen.
Ihre Zugangsdaten einfach in mehreren Templates wiederverwenden.
Assembly Instructions flexibler direkt senden (ohne ein Template zu verwenden). Obwohl wir Templates empfehlen, ermöglicht dies Prototyping, ohne jedes Mal sensible Zugangsdaten zu übertragen.
Kompromittierte Zugangsdaten widerrufen und ersetzen, ohne alle Ihre Templates oder Ihren Code zu ändern.
Tokens hinzufügen. Einige Cloud-Anbieter erfordern einen interaktiven OAuth-Flow, um Transloadit Zugriff zu gewähren. Die Weboberfläche für Template-Zugangsdaten unterstützt dies.

Hier sehen Sie Assembly Instructions mit Template-Zugangsdaten, die zuvor in Ihrem Konto unter my_s3_credentials und my_youtube_credentials gespeichert wurden. Damit werden Videos aus einem S3-Bucket importiert und als private Videos auf YouTube hochgeladen:

{
  "steps": {
    "imported": {
      "robot": "/s3/import",
      "credentials": "my_s3_credentials",
      "path": "/some/path"
    },
    "exported": {
      "robot": "/youtube/store",
      "use": "imported",
      "credentials": "my_youtube_credentials",
      "title": "My processed video",
      "description": "A video processed with Transloadit",
      "category": "science & technology",
      "keywords": "transloadit",
      "visibility": "private"
    }
  }
}

So erstellen Sie Template-Zugangsdaten

Öffnen Sie die Seite Zugangsdaten in Ihrem Workspace. Wählen Sie Neue Zugangsdaten oder Neue Zugangsdaten hinzufügen, falls Sie noch keine erstellt haben.
Wählen Sie unter Dienst den Anbieter aus. Geben Sie unter Name einen leicht erkennbaren Namen ein und füllen Sie die Felder des Anbieters aus.
Wählen Sie Erstellen. Wenn Sie einen Schlüssel oder ein Token direkt eingeben, speichert die Console den Zugangsdaten-Eintrag und kehrt zur Zugangsdatenliste zurück. Bei einer Verbindung über OAuth leitet sie Sie zunächst zum Anbieter weiter, damit Sie den Zugriff genehmigen.

Verwenden Sie den gespeicherten Namen als Wert für credentials im jeweiligen Robot für Import oder Export. Erforderliche Werte und Anbieterberechtigungen finden Sie in der Anleitung zum Einrichten eines Google-Cloud-Buckets, der Anleitung zum Einrichten von DigitalOcean Spaces oder der jeweiligen Robot-Dokumentation.

Template-Zugangsdaten authentifizieren Transloadit beim Anbieter; sie autorisieren keine Uploads Ihrer Nutzer. Autorisieren Sie bei Browser-Uploads mit Auth Key die Anfragen in Ihrem Backend und verwenden Sie Signature Authentication. Das Auth Secret muss dabei auf dem Server bleiben. Legen Sie "allow_steps_override": false im gespeicherten Template fest, wenn hochladende Nutzer dessen Steps nicht ändern dürfen.

Vimeo

Vimeo-OAuth in der Console funktioniert für Uploads mit /vimeo/store. /vimeo/import erfordert ein persönliches Zugriffstoken aus Ihrer eigenen Vimeo-App. Vimeo gewährt nur OAuth-Apps von Partnern Zugriff auf Videodateien anderer Mitglieder, und Transloadit ist kein Vimeo-Partner. Ein erneuter OAuth-Durchlauf fügt diese Berechtigung nicht hinzu.

Melden Sie sich bei developer.vimeo.com/apps mit dem Vimeo-Konto an, dem die Videos gehören, und erstellen Sie eine App oder wählen Sie Ihre eigene vorhandene App.
Öffnen Sie unter Authentication den Eintrag Generate Access Token und wählen Sie Authenticated (you).
Wählen Sie Public, Private und Video Files (public, private und video_files). Um das Token auch mit /vimeo/store zu verwenden, wählen Sie Upload, Edit und Interact (upload, edit und interact) und stellen Sie sicher, dass Ihre App Upload-Zugriff bei Vimeo hat.
Generieren und kopieren Sie das Token. Erstellen Sie in der Console einen Eintrag für Template-Zugangsdaten, wählen Sie Vimeo, dann Persönliches Zugriffstoken einfügen, und fügen Sie das Token in Vimeo-Zugriffstoken ein.
Speichern Sie den Eintrag unter einem leicht erkennbaren Namen und verwenden Sie diesen Namen als Wert für credentials in Ihrem Robot.

Beim Speichern werden Ihr Vimeo-Konto und die Scopes des Tokens überprüft. Das Token wird als access_token gespeichert und in der Console nie wieder angezeigt. Video-Downloads hängen weiterhin von Ihrem Vimeo-Tarif und den Videoberechtigungen ab. Downloads des Originals (source) setzen außerdem voraus, dass Vimeo den ursprünglichen Upload aufbewahrt hat. Siehe Vimeos Anleitung zu Tokens.

Vimeo erneut verbinden

Aktualisieren startet OAuth nicht erneut und gewährt keine zusätzlichen Scopes. Um die Verbindung wiederherzustellen, wählen Sie für den Zugangsdaten-Eintrag Entfernen und erstellen Sie ihn anschließend unter demselben Namen erneut, damit Ihre Templates weiterhin darauf verweisen. Wenn Sie einen Vimeo-Zugangsdaten-Eintrag entfernen, wird sein Token bei Vimeo widerrufen. Dies betrifft auch jede andere Verwendung desselben Tokens. Generieren Sie ein neues persönliches Zugriffstoken, bevor Sie es erneut einfügen. Wenn der Widerruf fehlschlägt, schlägt auch das Entfernen fehl und Sie können es erneut versuchen. Sie können ein Token auch mit Aktualisieren ersetzen; lassen Sie das Token-Feld leer, um das gespeicherte Token beizubehalten.

Geben Sie uns nicht die Schlüssel zu allem

Wir folgen bewährten Sicherheitsprinzipien und möchten für unsere Arbeit möglichst wenige Berechtigungen erhalten. Wenn Sie beispielsweise Dateien in Ihren Amazon-S3-Bucket exportieren, können Sie dafür problemlos einen IAM-Nutzer erstellen, der nur Schreibzugriff hat. Begrenzte Berechtigungen verringern den Schaden, den ein kompromittierter Schlüssel verursachen kann. Wenn ein Anbieter Schreibzugriff mit Lese- oder Löschzugriff kombiniert, beschränken Sie den Zugangsdaten-Eintrag auf einen eigens dafür vorgesehenen Bucket statt auf Ihr gesamtes Konto.

» Mehr über Sicherheit erfahren