Este guia explica como proteger os vídeos hospedados num serviço VOD Infomaniak através de uma chave única (token).

Introdução

• Importante: esta proteção aplica-se apenas às integrações padrão por iframe que utilizam o reprodutor Infomaniak (❓: ajuda).
• Outros modos de restrição também estão disponíveis: por palavra-passe (❓: ajuda) ou por bloqueio geográfico (GeoIP). (❓: ajuda).
• Você pode personalizar as imagens de visualização exibidas quando o acesso é negado (❓: ajuda).

Como funciona a proteção por chave única

A restrição por chave única permite proteger o acesso aos arquivos de uma pasta, exigindo um token temporário específico para cada utilizador.

Este token é gerado exclusivamente por si (no lado do servidor) e deve ser transmitido como parâmetro ao aceder ao arquivo. Este mecanismo é ideal para casos de uso como o Pay-Per-View ou a distribuição com acesso restrito.

Observação: a integração e a geração dinâmica dos tokens devem ser desenvolvidas na sua própria aplicação web. Se a chave fornecida for inválida ou estiver expirada, o Player retorna um erro 403 Acesso proibido.

Ativar a restrição em uma pasta de VOD

Quando uma restrição é configurada em uma pasta, ela é aplicada automaticamente a todos os conteúdos que já estão nela ou que forem importados posteriormente.

1. Aceder ao painel de controlo: clique aqui para aceder à gestão do seu produto VOD/AOD (❓: ajuda).
2. Selecionar o produto: clique no nome atribuído ao seu serviço VOD:
   
3. No menu lateral esquerdo, vá para Mídia e, em seguida, Gerenciamento de mídia.
4. Criar ou configurar uma pasta: clique no ícone de criação de Nova pasta:
   
5. Insira o nome da pasta e clique em Criar pasta.
6. Acesse as configurações da pasta clicando em Configuração:
   
7. Abra a aba Restrições.
8. Se necessário, desative o botão de alternância para quebrar a herança da pasta principal, a fim de aplicar regras específicas.
9. Ative a opção de restrição por Chave única.
10. Clique em Guardar para validar:
    

Procedimento de integração técnica

1. Criar um token de acesso à API

Para interagir com a API VOD, gere primeiro uma chave de API global a partir da sua conta (❓: ajuda).

2. Gerar o token de reprodução (Playback Token)

No lado do servidor, sua aplicação deve executar uma requisição POST para cada usuário único antes de exibir o reprodutor.

Pedido da API (❓: ajuda):

POST https://api.vod2.infomaniak.com/api/pub/v1/channel/channel_id/share/share_id/token

• channel_id: identificador do seu canal VOD (ex.: 1227)
• share_id: identificador único do conteúdo (ex.: extraído da URL de incorporação: https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html)

3. Inserir o token no código Iframe

Passe o token obtido na etapa anterior como parâmetro na URL (?token=...) no código de integração do seu iframe:

<iframe frameborder="0" width="720" height="360" src="https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html?token=st=1637143497~exp=1637143797~acl=/hls/1jhvl2uq4dnra/1jhvl2uq4dnmd/*~hmac=914aa838bdba141ec85db74266b54278572a1353a49e8851e4fd096dc6372127" allowfullscreen></iframe>