Storage Connect pour Frame.io : enregistrement des ressources

Storage Connect permet aux clientes et clients Enterprise de Frame.io d’utiliser leur propre point d’entrée d’espace de stockage dans le cloud comme stockage de sauvegarde de Frame.io. Aujourd’hui, lorsqu’un utilisateur ou une utilisatrice charge une ressource sur Frame.io, la ressource circule dans la pile d’applications et est stockée dans le compartiment Amazon S3 de Frame.io. De même, la lecture et la diffusion d’une ressource sont assurées à partir d’un compartiment Amazon S3 géré par Frame.io.

Utilisez votre propre AWS S3 comme source fiable tout en conservant Frame.io comme surface unique pour parcourir, rechercher, partager et réviser. Vous pouvez désormais connecter :

un compartiment 3 principal (lecture/écriture), où les nouveaux chargements depuis Frame.io sont déposés ;
autant de compartiments S3 supplémentaires (lecture seule) que vous le souhaitez : rendez les médias existants dans S3 visibles et lisibles dans Frame.io sans copier ni dupliquer les originaux.

Frame.io génère des doublures légères (miniatures, prévisualisations, lecture) tandis que les originaux restent dans votre S3. Pour enregistrer des fichiers déjà présents dans vos compartiments connectés, utilisez le point d’entrée V4 Public API: Import File.

Remarque : cette offre est disponible pour les clientes et clients nouveaux et existants de Frame.io qui utilisent Storage Connect. Pour activer les clientes et clients existants, Frame.io propose une migration unique des données des clientes et clients existants historiquement stockées dans le compartiment Amazon S3 géré par Frame.io vers le compartiment Amazon S3 géré par le client ou la cliente pour une disponibilité générale.

Les informations ci-dessous sont conçues pour informer la nouvelle clientèle et celle existante de Frame.io avec un guide détaillé configurant leur compartiment S3 afin d’assurer sa compatibilité avec Storage Connect.

Conditions préalables

Compte Enterprise Frame.io avec Storage Connect activé pour votre organisation.
Accès pour créer/mettre à jour les rôles/politiques IAM AWS et les autorisations du compartiment S3.
Accès à l’API publique Frame.io V4 (pour le point d’entrée Import a file utilisé pour enregistrer des objets existants à partir de compartiments en lecture seule)‑

Remarque : pour la configuration exacte de la relation de confiance IAM et le mappage des comptes, votre contact Frame.io (CSM/spécialiste de la mise en œuvre) fournira la configuration actuelle de l’OIDC/des rôles et validera les autorisations lors de l’intégration.

Concepts clés

Compartiment principal (lecture/écriture) : compartiment S3 qui reçoit les originaux lorsque les utilisateurs et utilisatrices effectuent un chargement sur Frame. Frame nécessite des autorisations lecture et écriture ici.
Compartiments en lecture seule‑ : un ou plusieurs compartiments S3 pour lesquels Frame dispose d’autorisations en lecture, mais pas en écriture. Les ressources sont rendues visibles dans Frame en appelant l’API Import File (sans copie des originaux).
Doublures : Frame génère des dérivées (miniatures, prévisualisations et doublures en streaming) afin que les ressources soient lisibles dans Frame même si les originaux restent dans votre S3.

Partie A : configurer le compartiment principal S3 en lecture/écriture

Choisissez ou créez le compartiment S3 que vous utiliserez comme stockage principal.

Créez un rôle IAM pour Frame.io (approuvé par le fournisseur d’identité Frame.io) et joignez une stratégie IAM qui accorde des autorisations en lecture/écriture au compartiment/préfixe.

Exemple de structure de stratégie (remplacez les ARN et limitez-les si possible aux préfixes requis) :

{ 
  "Version": "2012-10-17", 
  "Statement": [ 
    { 
      "Sid": "ListPrimaryBucket", 
      "Effect": "Allow", 
      "Action": ["s3:ListBucket"], 
      "Resource": "arn:aws:s3:::YOUR_PRIMARY_BUCKET" 
    }, 
    { 
      "Sid": "RWPrimaryObjects", 
      "Effect": "Allow", 
      "Action": [ 
        "s3:GetObject", 
        "s3:PutObject", 
        "s3:DeleteObject", 
        "s3:AbortMultipartUpload", 
        "s3:ListMultipartUploadParts" 
      ], 
      "Resource": "arn:aws:s3:::YOUR_PRIMARY_BUCKET/*" 
    } 
  ] 
}

Fournissez des détails à Frame.io : ARN du rôle IAM, nom du compartiment et tout préfixe d’objet préféré. Frame.io va terminer le mappage afin que les chargements de vos utilisateurs et utilisatrices dans Frame ciblent ce compartiment.
Validez en effectuant un test de chargement dans Frame pour confirmer que les originaux son déposés dans votre S3 et que les doublures apparaissent dans Frame.

Partie B : ajouter un ou plusieurs compartiments S3 en lecture seule‑

Vous pouvez associer des compartiments S3 supplémentaires en tant que sources en lecture seule. Frame lit les objets pour la génération et la lecture de doublures, mais n’écrit pas de nouveaux objets dans ces compartiments.

Choisissez vos compartiments S3 supplémentaires (et les préfixes de dossier facultatifs) à afficher dans Frame.
Créez (ou mettez à jour) un rôle IAM utilisé par Frame pour accorder un accès en lecture seule‑ à chaque compartiment/préfixe.

Exemple de structure de stratégie par compartiment (ajustez les ARN/préfixes et ajoutez-les pour chaque compartiment) :

{  
  "Version": "2012-10-17",  
  "Statement": [  
    {  
      "Sid": "ListReadOnlyBucket",  
      "Effect": "Allow",  
      "Action": ["s3:ListBucket"],  
      "Resource": "arn:aws:s3:::YOUR_RO_BUCKET"  
    },  
    {  
      "Sid": "ReadObjects",  
      "Effect": "Allow",  
      "Action": ["s3:GetObject", "s3:GetObjectVersion"],  
      "Resource": "arn:aws:s3:::YOUR_RO_BUCKET/*"  
    }  
  ]  
}

Fournissez des détails à Frame.io : le même ARN de rôle (ou des ARN distincts par compartiment), chaque nom de compartiment et préfixe facultatif qui doit être affiché en lecture seule.
Procédez à l’enregistrement des fichiers existants à partir de ces compartiments en lecture seule à l’aide de l’API ‑Import File (ci-dessous).

Partie C : enregistrer les objets S3 existants dans Frame (API d’importation)

Lorsque vous ajoutez un compartiment en lecture seule, vos médias sont déjà présents dans S3. Utilisez le point d’entrée Import File pour enregistrer ces objets S3 dans vos projets/dossiers Frame sans copier les originaux.

Rôle de l’importation

Crée une ressource de fichier dans Frame qui pointe vers votre objet S3.
Déclenche la génération par Frame de doublures pour la navigation/lecture.
Laisse le fichier original à sa place dans votre S3.

Avant d’appeler l’API

Assurez-vous que les mappages Storage Connect sont terminés (Frame.io contient votre rôle ARN, vos compartiments et préfixes).
Disposez d’un jeton OAuth avec les portées de fichier requises.
Identifiez le conteneur de destination dans Frame (ID de ressource racine ou de dossier du projet) où le fichier importé doit apparaître.
Identifiez le compartiment S3 et la clé d’objet à importer.

Exemple (pseudo-code cURL)

Utilisez la référence d’API officielle pour le chemin et les champs exacts. La structure ci-dessous illustre l’intention.

# PSEUDO-CODE : consultez les documents du point d’entrée « Importer le fichier » pour connaître l’URL et le schéma exacts

curl -X POST "https://api.frame.io/v4/files.import_file" \ 
  -H "Authorization: Bearer $TOKEN" \ 
  -H "Content-Type: application/json" \ 
  -d '{ 
    "container_id": "<FRAME_FOLDER_OR_PROJECT_ASSET_ID>", 
    "external": { 
      "provider": "s3", 
      "bucket": "my-readonly-bucket", 
      "key": "Marketing/2025/hero.mov" 
    }, 
    "display_name": "hero.mov" 
  }'

Vérifier dans Frame

Ouvrez votre projet/dossier de destination : les fichiers importés apparaissent comme n’importe quelle autre ressource.
La lecture doit être immédiatement disponible une fois que la génération des doublures est terminée.
Vérifiez les détails de la ressource pour confirmer que l’emplacement de stockage est votre S3.

Comportement et notes

Les chargements dans l’un des clients Frame (web, iOS, application de transfert, etc.), vont dans le compartiment en lecture/écriture principal.
‑ Les ressources importées à partir de ‑compartiments en lecture seule restent en place ; la suppression d’une ressource dans Frame ne supprime pas l’original dans un compartiment en lecture seule. (Respectez les politiques de suppression de votre organisation pour le compartiment en lecture/écriture.)
Cycle de vie/archivage : si des objets sont déplacés vers Glacier ou sont temporairement indisponibles, les doublures générées précédemment peuvent continuer à permettre la navigation ; la récupération de l’original dépendra du niveau S3 et de la disponibilité.

Résolution des problèmes

403/AccessDenied lors de l’importation/la lecture → vérifiez que la politique IAM inclut s3:GetObject pour l’ARN d’objet.
Objets non découverts → confirmez que le mappage du compartiment/préfixe correspond aux clés d’objet que vous importez.
Doublures non générées → confirmez que le type de fichier est pris en charge et qu’IAM autorise les lectures ; vérifiez les erreurs S3 transitoires.
Limitation du débit lors de l’importation en masse → ajoutez une nouvelle tentative avec temporisation exponentielle ; limitez la concurrence.

Questions fréquentes

Q : combien de compartiments en lecture seule puis‑je ajouter ?

R : n’importe quel nombre. Mappez chaque compartiment (et les préfixes facultatifs) avec des autorisations de lecture seule.

Q : dois-je déplacer ou copier ma bibliothèque existante dans Frame ?

R : non. Utilisez l’API Importer le fichier pour vous enregistrer à la place.

Q : puis-je supprimer un compartiment ultérieurement ?

R : oui. La suppression d’un compartiment en lecture seule annule la publication de ces ressources depuis Frame (vos originaux restent dans S3).

Q : ‑ Frame écrit-il dans mes compartiments en lecture seule ?

R : non. Frame lit des objets pour générer des doublures et diffuser des originaux si besoin ; les écritures se produisent uniquement dans le compartiment en lecture/écriture principal.

Liens connexes

Vue d’ensemble de Storage Connect (Centre d’aide)
Annonce de Storage Connect (blog Frame.io Insider)
Référence d’API Frame.io V4 - Point d’entrée Importer le fichier
Documentation AWS S3 et IAM pour les politiques de compartiment

Ce guide reflète les dernières fonctionnalités de Storage Connect : un compartiment en lecture/écriture principal et plusieurs compartiments en lecture seule avec enregistrement via l’API Importer le fichier afin que vous puissiez travailler dans Frame sans dupliquer les originaux.

Limitation importante : les compartiments/objets chiffrés par SSE/KMS‑ ne sont pas pris en charge par Storage Connect pour le moment.