Este guia explica como proteger vídeos importados para um serviço VOD Infomaniak usando 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: senha | geoip
• Você pode gerenciar as imagens de visualização usadas ao restringir o acesso.

Proteger um vídeo com uma chave única

Você tem a possibilidade de proteger todos os arquivos de mídia de uma pasta criando um token. Este token será único para cada um dos seus visitantes e deverá ser passado como parâmetro para o seu arquivo de mídia, a fim de limitar o acesso a ele. Apenas você poderá gerar a chave única, necessária para que cada usuário possa visualizar os vídeos. Essa chave permite, portanto, autorizar apenas as pessoas que foram previamente verificadas por você.

Isso permite controlar o acesso aos vídeos e autorizar apenas certas pessoas, negando o acesso às demais; útil em casos como pay-per-view ou transmissões limitadas. No entanto, observe que cabe a você desenvolver a integração com seu sistema existente.

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

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

Quando a senha é definida uma vez para a pasta de destino, todas as novas importações de mídia incluirão automaticamente essa senha ao serem reproduzidas. 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 Gerenciar mídia no menu lateral esquerdo.
5. Clique no ícone para criar uma Nova pasta:
   
6. Atribua 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 para remover a herança da pasta principal, para que possa configurar as suas próprias regras para esta pasta específica.
11. Ative o botão de alternância para configurar a restrição por chave única.
12. Clique em Guardar depois de configurar as diferentes opções desejadas:
    

1. Criar um token de API VOD

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

2. Criar o token de reprodução

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

É importante, portanto, que a página responsável pela geração do token não tenha cache, a fim de garantir a unicidade do token.

POST  {{URL_14}}

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 meio

O token obtido no ponto 2 acima será transmitido como parâmetro ao meio, sendo único e, portanto, diferente para cada visitante:

<iframe frameborder="0" width="720" height="360"  src="{{URL_18}}" allowfullscreen></iframe>