Conectar armazenamento em nuvem
Conecte AWS S3, Microsoft Azure, Google Cloud Storage, Alibaba Cloud OSS ou Tencent Cloud COS para distribuir mídia criptografada.
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.
| Provider | Connection fields | Access method |
|---|---|---|
| AWS S3 | Bucket, região, Access key ID, Secret access key | Amazon S3 API. Consulte o guia ilustrado de S3 e CloudFront. |
| Microsoft Azure Blob Storage | Contêiner, nome da conta de armazenamento, chave da conta de armazenamento | Blob API nativa com SAS HTTPS de curta duração para upload de um único blob. Somente nuvem pública Azure. |
| Google Cloud Storage | Bucket, HMAC access ID e HMAC secret da conta de serviço | XML API em https://storage.googleapis.com. Uma chave JSON de conta de serviço não é uma credencial HMAC. |
| Alibaba Cloud OSS | Bucket, região como cn-hangzhou, RAM AccessKey ID e AccessKey secret | API 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 COS | Nome completo do bucket com APPID, região como ap-guangzhou, CAM SecretId e SecretKey | S3-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.
| Provider | Cabeçalhos adicionais permitidos para upload |
|---|---|
| AWS S3, Google Cloud Storage, Tencent Cloud COS | x-amz-meta-drmx-sha256 |
| Alibaba Cloud OSS | x-amz-meta-drmx-sha256, x-oss-s3-compat |
| Microsoft Azure Blob Storage | x-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#
- Verifique a listagem em Console e envie um pequeno exemplo criptografado. Verifique o tamanho em bytes e a URL Preview pública.
- Teste GET e HEAD públicos e depois
Range: bytes=0-15. Confirme os bytes esperados, HTTP 206 e Content-Range. - 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.
- 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.
- 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.
DRM-X 6.0