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

Seu primeiro vídeo protegido

Iniciar DRM-X 6.0 reprodução Web protegida: publicar conteúdo, criar menos-privilégio credenciais, autorizar um visualizador, e carregar o manifesto registrado.

Ver MarkdownExemplos onlineAtualizado em 2026-10-26

Do primeiro vídeo à reprodução protegida

Criptografe um vídeo, conecte seu backend e teste a reprodução. Mantenha a Access Key no servidor.

  1. Entrar

    Abra DRM-X Console e selecione seu ambiente.

  2. Criptografar e publicar

    Empacote o vídeo e aguarde até que o status seja Published.

  3. Criar um API client

    Conceda apenas a permissão license-tokens:create. Guarde a Access Key em um local seguro quando ela for exibida.

  4. Configurar seu backend

    Configure as credenciais e o Content ID, escolha as regras de reprodução e verifique se o usuário pode assistir ao conteúdo.

  5. Testar a reprodução

    Solicite uma sessão de reprodução pelo seu backend. Em seguida, o player solicita uma licença DRM e reproduz o vídeo criptografado.

Criptografe e publique um vídeo, configure seu backend e teste a reprodução com um player compatível.

Comece com um arquivo de origem. Empacote e publique, teste no DRM-X Web Player e depois integre ao site. Você precisa de uma conta de cliente DRM-X, um ambiente Development e um arquivo de vídeo ou áudio.

1. Publique um arquivo protegido#

  1. Escolha um ambiente.Use Development durante a integração e mantenha as credenciais de Production separadas.
  2. Instale o Packager.Baixe Packager Suite 1.0.0-beta.1 em Console → Package Content. Extraia todo o ZIP e siga o tutorial do Desktop Packager para conectar um perfil.
  3. Empacote e publique.Adicione uma fonte e escolha uma pasta de saída vazia. Para este primeiro teste, selecione Single Video Key Protection e use a política single-software abaixo. Use Multi-key Quality Tiered com multi-tier-standard quando precisar de regras separadas por nível de qualidade. Inclua versões de 1080p e inferiores se os telefones tiverem um limite de 1080p.
  4. Aguarde Published.Guarde o Content ID e o ambiente utilizado. Concluir a codificação ou mostrar a quantidade enviada não confirma, por si só, a publicação.

Testar no DRM-X Web Player#

  1. Entre na conta.Abra DRM-X Web Player com a conta de cliente DRM-X proprietária do conteúdo.
  2. Selecione o conteúdo.Escolha o mesmo ambiente do empacotamento. Selecione o item Published e confira título e Content ID.
  3. Inicie a reprodução.Mantenha o modelo de chaves detectado e uma política compatível; pressione Play. O reprodutor solicita um novo DRM License Token.
  4. Confira o resultado.Teste avanços e retrocessos, som, qualidade permitida, cada idioma de áudio e legendas. Para áudio somente, confirme o som e o avanço do tempo. Pressione Stop ao terminar.

Se o item não aparecer, confira o ambiente e Published. Se a reprodução falhar, consulte solução de problemas de reprodução antes de integrar o site. O espectador usa o login do seu site; não precisa de conta DRM-X Console.

Após integrar, teste um espectador autorizado e outro que deve ser bloqueado nos navegadores e dispositivos físicos compatíveis. Para economizar banda no celular e manter UHD nos demais, siga o procedimento opcional de limite de 1080p apenas para celulares.

2. Crie uma integração de servidor com permissões mínimas#

Após o teste do Web Player, siga Criar credenciais de integração do servidor. Crie um cliente API de reprodução apenas com license-tokens:create. Mantenha Site ID, Site Key e Access Key no servidor.

Baixe o kit para seu backend. Para PHP, siga o tutorial PHP. Para o componente do reprodutor e o limite opcional, consulte o guia Web SDK.

Use um gerenciador de segredos ou configuração de ambiente protegida para credenciais de produção. Nunca inclua Access Key em JavaScript do navegador, APK, IPA, app TV ou configuração disponível para download.

3. Altere as três configurações de servidor sinalizadas#

// Server-side only
siteId: "your-development-environment-uuid"
siteKey: "drmx_your_environment_scoped_client_id"
accessKey: "paste-the-one-time-access-key"

contentId: "your-published-content-id"
licensePolicyTemplate: "single-software"

Depois, substitua as funções de exemplo de login e autorização pelas verificações reais de sessão, assinatura, compra, matrícula, aluguel ou acesso ao evento.

4. Solicite a reprodução e libere a sessão ao terminar#

Crie um ID de sessão novo e imprevisível para cada tentativa de reprodução. Devolva a resposta de sessão bem-sucedida ao cliente com Cache-Control: no-store. Libere a vaga de reprodução simultânea ao parar, trocar o conteúdo, ocorrer um erro irrecuperável ou encerrar o aplicativo.

  • Nunca aceite subject, o JSON da política, a URL do manifest ou a URL de licença diretamente do player.
  • Adicione cabeçalhos de autorização apenas às rotas de licença DRM e certificado FairPlay retornadas na resposta.
  • Registre IDs de correlação e os resultados de cada etapa; nunca registre tokens, chaves, solicitações nativas de licença nem os bytes das licenças.