DRM-X 6.0 logo de pomba e ramo de oliveiraDRM-X 6.0Documentação
◎ Português

Conectar armazenamento em nuvem

Conecte AWS S3, Microsoft Azure, Google Cloud Storage, Alibaba Cloud OSS ou Tencent Cloud COS para distribuir mídia criptografada.

Ver MarkdownExemplos onlineAtualizado em 2026-10-26

Follow the first cloud package tutorial to connect a provider, publish a test clip and verify playback.

For Tencent Cloud COS, follow the step-by-step COS setup and playback guide.

1. Choose your storage#

Use 1AICLOUD gerenciado ou conecte AWS S3, Microsoft Azure Blob Storage, Google Cloud Storage, Alibaba Cloud OSS ou Tencent Cloud COS. Crie um bucket ou contêiner dedicado para mídia criptografada e recursos intencionalmente públicos. Mantenha vídeos originais e documentos privados em armazenamento separado.

Verifique estes conectores com sua conta, permissões, região e configurações de distribuição antes da produção. Uma verificação de conexão bem-sucedida confirma apenas a listagem; conclua os testes de upload e reprodução abaixo.

ProviderConnection fieldsAccess method
AWS S3Bucket, região, Access key ID, Secret access keyAmazon S3 API. Consulte o guia ilustrado de S3 e CloudFront.
Microsoft Azure Blob StorageContêiner, nome da conta de armazenamento, chave da conta de armazenamentoBlob API nativa com SAS HTTPS de curta duração para upload de um único blob. Somente nuvem pública Azure.
Google Cloud StorageBucket, HMAC access ID e HMAC secret da conta de serviçoXML API em https://storage.googleapis.com. Uma chave JSON de conta de serviço não é uma credencial HMAC.
Alibaba Cloud OSSBucket, região como cn-hangzhou, RAM AccessKey ID e AccessKey secretAPI compatível com S3 em https://oss-cn-hangzhou.aliyuncs.com. Alibaba Cloud pode precisar habilitar a autenticação compatível com S3 para sua conta.
Tencent Cloud COSNome completo do bucket com APPID, região como ap-guangzhou, CAM SecretId e SecretKeyS3-compatible API at https://cos.ap-guangzhou.myqcloud.com.

DRM-X deriva os endpoints de API dos novos provedores a partir da conta ou região. Seu provedor de nuvem cobra armazenamento, solicitações, distribuição e eventual largura de banda separadamente. Compare seu uso real e os preços do provedor com os planos 1AICLOUD disponíveis.

2. Configure credentials#

Conceda apenas as permissões de listar, ler, gravar, copiar e excluir necessárias ao bucket de distribuição. O Google usa credenciais HMAC de conta de serviço em Cloud Storage Settings → Interoperability. Alibaba usa RAM; Tencent usa CAM. Armazene credenciais somente em Console → Cloud Storage → Connect storage. DRM-X criptografa as credenciais e não devolve o segredo após salvar. Deixe os dois campos de credenciais vazios ao editar para manter os valores; preencha ambos para trocá-los.

No Azure, use uma conta de armazenamento dedicada com acesso Shared Key habilitado. A chave da conta pode acessar toda a conta de armazenamento; separe os dados de distribuição dos privados. Este conector não inclui autenticação Microsoft Entra, user-delegation SAS nem endpoints de nuvens soberanas.

3. Configure public HTTPS delivery#

Escolha uma URL pública de distribuição ou uma origem CDN para mídia criptografada. Na AWS, use um bucket S3 privado com CloudFront Origin Access Control. No Azure, use seu CDN HTTPS configurado ou um contêiner com acesso público a blobs intencionalmente habilitado. Uma URL Blob direta inclui conta e contêiner, como https://ACCOUNT.blob.core.windows.net/CONTAINER/protected. No Google, Alibaba e Tencent, configure um domínio HTTPS de distribuição ou CDN que corresponda ao bucket. Não use como prefixo público uma URL do console da nuvem, um endpoint apenas de API privada, uma URL assinada com expiração ou uma URL com credenciais.

O acesso público aos objetos expõe os bytes criptografados; a autorização de licença DRM controla a descriptografia. Configure CORS de GET/HEAD no host final de distribuição, incluindo respostas CDN.

4. Allow browser uploads and playback#

Crie uma regra CORS de upload que permita PUT somente de https://6.drm-x.com. Permita Content-Type e os cabeçalhos específicos do provedor abaixo. Use o formato CORS do próprio provedor; Azure e Google não aceitam um documento JSON CORS do S3.

ProviderCabeçalhos adicionais permitidos para upload
AWS S3, Google Cloud Storage, Tencent Cloud COSx-amz-meta-drmx-sha256
Alibaba Cloud OSSx-amz-meta-drmx-sha256, x-oss-s3-compat
Microsoft Azure Blob Storagex-ms-blob-type, x-ms-meta-drmx_sha256

Adicione uma regra separada de reprodução para GET e HEAD, permita o cabeçalho de solicitação Range e exponha ETag, Content-Length, Content-Range e Accept-Ranges. Use * para origens públicas de leitura de mídia criptografada ou liste as origens exatas dos players. Solicitações de mídia não devem enviar cookies entre origens. CORS configura o navegador; não concede autorização de acesso.

5. Connect and map paths#

Abra Cloud Storage, selecione Connect storage, escolha o provedor e preencha seus campos. Defina um caminho base opcional para conteúdo protegido e um prefixo de URL pública correspondente. Por exemplo, caminho base protected e prefixo público https://media.example.com/protected mapeiam o objeto movie/manifest.mpd para a chave protected/movie/manifest.mpd. Com uma URL Azure direta, inclua também o contêiner no prefixo público. Selecione Save and verify. Defina a conexão como padrão se o Packager precisar publicar nela.

As conexões de armazenamento salvas continuam disponíveis. Identidade do provedor, credenciais, seleção padrão e URLs publicadas são preservadas. Elas ainda podem ser editadas, verificadas e usadas para uploads.

6. Verify with your account#

  1. Verifique a listagem em Console e envie um pequeno exemplo criptografado. Verifique o tamanho em bytes e a URL Preview pública.
  2. Teste GET e HEAD públicos e depois Range: bytes=0-15. Confirme os bytes esperados, HTTP 206 e Content-Range.
  3. Teste uma pasta, um nome de arquivo com espaços e caracteres não ASCII, renomeação, troca de credenciais e exclusão de objetos de teste descartáveis. Verifique se permissões negadas falham sem expor segredos.
  4. Publique um pacote criptografado completo com Desktop Packager ou CLI. Confirme o status Published, reproduza por Content ID nos navegadores/dispositivos pretendidos e teste a busca na linha do tempo.
  5. Guarde provedor, região, resultados e horários como evidência da verificação. Não registre segredos da conta nem URLs assinadas de upload.

Uploads no navegador em uma única solicitação têm limite de 5 GiB, ou 5.000 MiB no Azure. Use saídas segmentadas do Packager para vídeos grandes. Retenção, exclusão reversível, snapshots e versionamento podem preservar dados no provedor ou impedir sua exclusão. Excluir o objeto atual não prova que todas as versões retidas foram apagadas.

7. Troubleshooting#

Se a listagem funcionar, mas o upload falhar, verifique CORS de PUT, todos os cabeçalhos assinados, a permissão de gravação e o relógio/expiração. Se o upload funcionar, mas a URL pública falhar, compare bucket/contêiner, caminho base, mapeamento da origem CDN e maiúsculas/minúsculas do nome do arquivo. Se a URL funcionar diretamente, mas a reprodução informar Failed to fetch, verifique CORS de GET/HEAD e caches CDN. Se Alibaba rejeitar a autenticação S3, confirme o modo de compatibilidade com o suporte Alibaba Cloud.

Referências oficiais#