Este guia explica como proteger vídeos importados num serviço VOD Infomaniak através de uma chave única.

Introdução

• Atenção: a proteção só é eficaz no caso de uma integração padrão por iframe e, portanto, através da utilização do Player Infomaniak.
• Podem ser ativadas outras restrições de acesso: palavra-passe | geoip
• Pode gerir as imagens de visualização utilizadas durante a restrição de acesso.

Proteger um vídeo com uma chave única

Tem a possibilidade de proteger todos os conteúdos de uma pasta com a criação de um token. Este será único para cada um dos seus visitantes e terá de ser transmitido como parâmetro ao seu conteúdo multimédia, a fim de limitar a sua visualização. Apenas você poderá gerar a chave única, necessária para cada utilizador visualizar os vídeos. Esta chave permite, portanto, autorizar apenas as pessoas que foram previamente verificadas por si.

Isto permite controlar o acesso aos vídeos e autorizar apenas certas pessoas, recusando as restantes; útil em casos como pay-per-view ou transmissões limitadas. No entanto, tenha em atenção que é da sua responsabilidade desenvolver a integração no seu sistema existente.

Se o hash não for válido, o acesso ao vídeo redirecionará para uma página de erro "403 forbidden".

Ativar a restrição na pasta de importação

Quando a palavra-passe é definida uma vez para toda na pasta de destino, todas as novas importações de conteúdos multimédia terão automaticamente este modo ativado durante a sua reprodução. Para configurar esta pasta:

1. Clique aqui para acessar o gerenciamento do seu VOD/AOD no Manager Infomaniak (precisa de ajuda?).
2. Clique diretamente no nome atribuído ao produto em questão:
   
3. Clique em Mídia no menu lateral esquerdo.
4. Clique em Gerenciamento de mídia no menu lateral esquerdo.
5. Clique no ícone para criar uma Nova pasta:
   
6. Dê um nome à pasta.
7. Clique no botão azul para Criar a pasta.
8. Clique em Configuração:
   
9. Clique na aba Restrições.
10. Desative, se necessário, o botão de alternância (toggle switch) para remover a herança da pasta pai, para poder configurar suas próprias regras nesta pasta específica.
11. Ative o botão de alternância (toggle switch) para configurar a restrição por chave única.
12. Clique em Salvar depois de configurar as diferentes opções desejadas:
    

1. Criar um token API VOD

Para ter acesso à API VOD, você deve primeiro se autenticar usando um token (isso só precisa ser feito uma vez – ele será válido para todos os diretórios que você deseja proteger); consulte este outro guia e a documentação https://developer.infomaniak.com/getting-started#authentication.

2. Criar o token de reprodução

Esta etapa deve ser realizada em seu site/aplicativo, e este token deve ser único, portanto, gerado para cada visitante.

Portanto, é importante que a página responsável pela geração do token não tenha cache, a fim de garantir a singularidade do token.

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

channel_id = 1227
share_id = corresponde ao identificador do seu vídeo
Exemplo: https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html

A lista de parâmetros está disponível na documentação https://developer.infomaniak.com/docs/api/post/channel/share/token

3. Utilização do token único em um arquivo de mídia

O token obtido no ponto 2 acima será passado como parâmetro para o arquivo de mídia; ele será único e, portanto, diferente para cada visitante:

<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>