O Storage Connect permite que clientes empresariais do Frame.io usem seu próprio ponto de acesso de armazenamento na nuvem como um armazenamento reserva do Frame.io. Atualmente, após fazer upload de um ativo para o Frame.io, ele flui pela pilha de aplicativos e é armazenado no compartimento Amazon S3 do Frame.io. Da mesma forma, a reprodução e a entrega de um ativo são realizadas por um bloco do Amazon S3 gerenciado pelo Frame.io.
Utilize o seu próprio AWS S3 como fonte de dados confiável, mantendo o Frame.io como a plataforma usada para navegar, pesquisar, compartilhar e revisar. Agora, você pode conectar:
Um bloco do S3 primário (leitura/gravação): onde os novos uploads do Frame.io são armazenados.
Qualquer número de blocos do S3 adicionais (somente‑leitura): torne as mídias existentes no S3 visíveis e reproduzíveis no Frame.io sem copiar ou duplicar os originais.
O Frame.io gera proxies leves (miniaturas, prévias, reprodução), enquanto os originais permanecem no seu S3. Para registrar arquivos que já estão nos seus blocos conectados, use o ponto de acesso da API pública da V4: importar arquivo.
Observação: esta oferta está disponível tanto para novos clientes quanto para clientes existentes do Frame.io que utilizam o Storage Connect. Para habilitar os clientes já existentes, o Frame.io oferece uma migração única de seus dados históricos armazenados no bloco do Amazon S3 gerenciado pelo Frame.io para o bloco do Amazon S3 gerenciado pelo cliente para fins de disponibilidade geral.
As informações abaixo foram elaboradas como um guia passo a passo para ajudar clientes novos e existentes do Frame.io a configurarem seu bloco do S3 para ser compatível com o Storage Connect.
Pré-requisitos
Conta empresarial do Frame.io com o Storage Connect habilitado para a sua organização.
Acesso para criar/atualizar funções/políticas do AWS IAM e permissões de bloco do S3.
Acesso à API pública do Frame.io V4 (para o ponto de acesso de Importar arquivo usado para registrar objetos existentes de blocos somente de‑leitura).
Observação: para a configuração exata de confiança do IAM e mapeamento de contas, o seu contato da Frame.io (CSM / especialista em implementação) fornecerá a configuração atual de OIDC/função e validará as permissões durante a integração.
Conceitos principais
Bloco primário (leitura/gravação): o bloco do S3 que recebe os originais quando os usuários carregam no Frame. O Frame requer permissões de leitura e gravação aqui.
Blocos somente de‑leitura: um ou mais blocos do S3 que o Frame pode ler, mas nos quais não pode gravar. Os ativos ficam visíveis no Frame, chamando a API de Importar arquivo (sem cópia dos originais).
Proxies: o Frame gera derivados (miniaturas, prévias e proxies de transmissão), para que os recursos possam ser reproduzidos no Frame mesmo enquanto os originais permanecem no seu S3.
Parte A: configurar o bloco do S3 primário de leitura/gravação
Escolha ou crie o bloco do S3 que você usará como armazenamento principal.
Crie uma função IAM para o Frame.io (confiado pelo provedor de identidade do Frame.io) e anexe uma política IAM que conceda leitura/gravação ao bloco/prefixo.
Exemplo de estrutura de política (substitua os ARNs e limite-se aos prefixos necessários, sempre que possível):
{
"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/*"
}
]
} Forneça detalhes ao Frame.io: o ARN da função IAM, o nome do bloco e quaisquer prefixos de objeto preferenciais. O Frame.io concluirá o mapeamento, para que os uploads de seus usuários no Frame sejam direcionados para esse bloco.
Valide, realizando um upload de teste no Frame para confirmar que os originais chegam ao seu S3 e se os proxies aparecem no Frame.
Parte B: adicionar um ou mais blocos do S3 somente de‑leitura
Você pode associar blocos do S3 adicionais como fontes somente de‑leitura. O Frame lerá objetos para geração de proxy e reprodução, mas não gravará novos objetos nesses blocos.
Escolha os seus blocos do S3 adicionais (e prefixos de pasta opcionais) para expor no Frame.
Crie (ou atualize) uma função IAM usada pelo Frame para conceder acesso somente de‑leitura a cada bloco/prefixo.
Exemplo de estrutura de política por bloco (ajuste os ARNs/prefixos e adicione para cada bloco):
{
"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/*"
}
]
} Forneça detalhes ao Frame.io: o mesmo ARN de função (ou ARNs distintos por bloco), cada nome de bloco e prefixo opcional que deve ser exposto como somente de‑leitura.
Proceda ao registro de arquivos existentes desses blocos somente de‑leitura, usando a API de Importar arquivos (abaixo).
Parte C: registrar objetos do S3 existentes no Frame (API de importação)
Ao adicionar um bloco somente de‑leitura, a sua mídia já reside no S3. Use o ponto de acesso de Importar arquivo para registrar esses objetos do S3 nos seus projetos/pastas do Frame sem copiar os originais.
O que a importação faz
Cria um ativo de arquivo no Frame que aponte para o seu objeto do S3.
Aciona o Frame para gerar proxies para fins de navegação/reprodução.
Deixa o arquivo original intacto no seu S3.
Antes de chamar a API
Certifique-se de que os mapeamentos do Storage Connect estejam completos (o Frame.io possui o ARN da função, blocos e prefixos).
Conte com um um token OAuth com os escopos de arquivo necessários.
Identifique o container de destino no Frame (raiz do projeto ou ID do ativo da pasta) onde o arquivo importado deve aparecer.
Identifique o bloco do S3 e a chave do objeto a serem importados.
Exemplo (cURL com pseudocódigo)
Consulte a referência oficial da API para obter o caminho e os campos exatos. A estrutura abaixo ilustra a intenção.
# PSEUDOCÓDIGO: consulte a documentação do ponto de acesso de “Importar arquivo” para obter o URL e o esquema exatos
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"
}'
Verificar no Frame
Abra o Projeto/pasta de destino: os arquivos importados aparecem como quaisquer outros ativos.
A reprodução deverá ficar disponível assim que os proxies terminarem de ser gerados.
Verifique os detalhes do ativo para confirmar que o local de armazenamento é o seu S3.
Comportamento e observações
Os uploads em qualquer um dos clientes do Frame (web para iOS, aplicativo Transfer etc.) vão para o bloco primário de leitura/gravação.
Os ativos importados de blocos somente de‑leitura permanecem no local; excluir um ativo no Frame não exclui o original em um bloco somente de‑leitura. (Respeite as políticas de exclusão da sua organização para o bloco de leitura/gravação.)
Ciclo de vida/arquivamento: se os objetos forem movidos para o Glacier ou estiverem temporariamente indisponíveis, os proxies gerados anteriormente poderão continuar permitindo a navegação; a recuperação original dependerá do nível e da disponibilidade do S3.
Solução de problemas
403/acesso negado na importação/reprodução → verifique se a política do IAM inclui s3:GetObject para o ARN do objeto.
Objetos não descobertos → confirme que o mapeamento de blocos/prefixos corresponde às chaves de objeto que você está importando.
Proxies não gerados → confirme que o tipo de arquivo é compatível e o IAM permite leituras; verifique se há erros transitórios do S3.
Limitação de taxa na importação em massa → adicione nova tentativa com recuo exponencial; limite a concorrência.
Perguntas frequentes
P: Quantos blocos somente de‑leitura posso adicionar?
A: Qualquer quantidade. Mapeie cada bloco (e prefixos opcionais) com permissões somente de‑leitura.
P: Preciso mover ou copiar a minha biblioteca existente para o Frame?
R: Não. Use a API de Importar arquivo para registrar no local.
P: Posso remover um bloco mais tarde?
R: Sim. Remover um bloco somente de‑leitura remove a publicação desses ativos do Frame (os seus originais permanecem no S3).
P: O Frame alguma vez grava nos meus blocos somente de‑leitura?
R: Não. O Frame lê objetos para gerar proxies e transmitir os originais quando necessário; as gravações ocorrem apenas no bloco primário de leitura/gravação.
Links relacionados
Visão geral do Storage Connect (central de ajuda)
Anúncio do Storage Connect (blog Frame.io Insider)
Este guia reflete a funcionalidade mais recente do Storage Connect: um bloco primário de leitura/gravação, além de vários blocos somente de‑leitura, com registro via API de importação de arquivos, para que você possa trabalhar no Frame sem duplicar os originais.
Limitação importante: blocos/objetos criptografados com SSE‑KMS não são compatíveis com o Storage Connect no momento.