Comment configurer DigitalOcean Spaces ?

Utilisez un compte DigitalOcean permettant de créer un bucket Spaces et des clés d’accès. La création de votre premier bucket déclenche un abonnement Spaces payant ; le traitement par Transloadit est facturé séparément.

1. Créer un bucket Spaces privé

Suivez le guide de création de buckets⁠ de DigitalOcean. Choisissez Standard Storage pour cet exemple et gardez le bucket privé. Notez le nom du bucket et le code de sa région, par exemple nyc3, et non une URL complète de point de terminaison ou de CDN.

2. Créer une clé d’accès Spaces limitée à un bucket

Suivez le guide des clés d’accès Spaces⁠ de DigitalOcean. Choisissez Limited access, sélectionnez uniquement ce bucket et accordez l’autorisation Read/Write/Delete. DigitalOcean ne propose pas de clé Spaces autorisant uniquement l’écriture : cette clé permet aussi de lire et de supprimer des objets. La limiter à un bucket dédié réduit les dommages en cas de fuite. Les clés limitées à un bucket ne peuvent pas être combinées avec des politiques de bucket PutBucketPolicy ; utilisez un bucket distinct pour cet exemple si nécessaire.

Conservez l’ID et le secret de la clé d’accès en lieu sûr. Le secret ne s’affiche qu’à la création de la clé. Utilisez une clé d’accès Spaces, et non un jeton d’API de compte DigitalOcean.

3. Enregistrer des informations d’identification de Template

Suivez Comment créer des informations d’identification de Template et sélectionnez DigitalOcean Spaces comme service. Renseignez les champs suivants :

Donnez un nom reconnaissable à cet ensemble d’informations d’identification. Utilisez ce nom enregistré dans le Template, et non l’ID de la clé d’accès.

4. Tester un export

Créez un Template avec ces instructions, en remplaçant YOUR_DIGITALOCEAN_CREDENTIALS par le nom de l’ensemble d’informations d’identification enregistré :

{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "exported": {
      "robot": "/digitalocean/store",
      "use": ":original",
      "credentials": "YOUR_DIGITALOCEAN_CREDENTIALS",
      "acl": "private"
    }
  }
}

Exécutez le Template en téléversant un petit fichier de test. Une fois l’Assembly terminée, examinez le résultat de l’export et vérifiez que l’objet existe dans votre panneau de contrôle DigitalOcean après vous être authentifié. Une simple URL de résultat n’accorde pas d’accès anonyme à cet objet privé. Si votre application a besoin d’une URL de téléchargement à durée limitée, consultez sign_urls_for dans la documentation du Robot 🤖/digitalocean/store.

Pour aller plus loin

• Consultez la documentation des Templates pour leur configuration et leur sécurité.
• Consultez la documentation du Robot 🤖/digitalocean/store pour les chemins de fichiers, les paramètres d’accès et les autres options d’export.