Autenticar solicitações de stream de vídeo da DAI

As chaves de autenticação da Inserção de anúncios dinâmicos (DAI) são usadas para provar que as solicitações de stream de vídeo estão vindo de você. Elas fornecem melhor segurança durante a veiculação do anúncio. Uma chave é uma string ininterrupta de 64 caracteres e números. Algumas chaves mais antigas podem ter 25 caracteres ou números.

Exemplo

0L94DEA6C87B0F3D2407018ACF88ECDE77DK38AD1DX01957311A50E9D1O3F15B

Chaves de API estáticas: as chaves de API prevalecem sobre as HMAC quando ambas estão incluídas. As chaves de API são menos seguras do que as de HMAC. Portanto, é recomendável usar chaves HMAC.

HMAC: a autenticação por token baseada em HMAC fornece mais segurança do que as chaves de API estáticas. Os tokens de HMAC usam uma chave secreta e de duração limitada para garantir que o token não possa ser facilmente compartilhado entre usuários ou sessões.

Dica: antes de autenticar solicitações de stream, verifique se você tem o seguinte:

• Chave de autenticação da DAI com o tipo HMAC
• Transmissão ao vivo configurada para DAI

Adicionar uma nova chave de autenticação HMAC da DAI

Gere e adicione uma nova chave de autenticação da DAI do tipo HMAC:

1. Faça login no Google Ad Manager.
2. Clique em Administrador e em Áudio e vídeo.
3. Selecione "Chaves de autenticação da DAI".
4. Clique em Nova chave de autenticação da DAI.
5. Insira o nome da nova chave. Selecione o tipo "HMAC".
6. Clique em Salvar.

Essa chave é vinculada à sua transmissão ao vivo quando você ativa a autenticação.

Ativar a autenticação para solicitações às APIs DAI

Vincule sua chave HMAC à transmissão:

1. Faça login no Google Ad Manager.
2. Clique em Vídeo e, depois, em Transmissões ao vivo.
3. Selecione a transmissão ao vivo na lista ou clique em Nova transmissão ao vivo. Saiba mais sobre como criar uma transmissão ao vivo.
4. Em "Configurações gerais",
   1. Selecione "Ativado" em "Chaves de autenticação do recurso de conjunto" para autenticar solicitações de conjunto de anúncios, e/ou
   2. Selecione "Ativado" em "Chaves de autenticação da criação de stream" para autenticar solicitações de sessão de stream
5. Selecione a chave HMAC que você criou.
6. Clique em Salvar.

Para visualizar e copiar sua chave, retorne à página de detalhes. Depois de criar uma chave de autenticação da DAI ativa, você poderá usá-la imediatamente. Incorpore a chave no app de vídeo do cliente, onde você faz solicitações de stream da DAI.

Dica: uma prática recomendada é gerar chaves de autenticação da DAI separadas para cada uma das suas plataformas de cliente (por exemplo, iOS, Android e web).

As chaves são automaticamente definidas como "Ativas" ao salvar. Somente as chaves "Ativas" implementadas corretamente podem validar as solicitações.

As solicitações que usam chaves desativadas são recusadas. Desative uma chave somente se ela ficar comprometida ou não puder ser usada.

Desativar uma chave de autenticação

Siga estas etapas para desativar uma chave de autenticação:

1. Faça login no Google Ad Manager.
2. Clique em Administrador, Vídeo e áudio e em "Chaves de autenticação da DAI".
3. Na lista, selecione a chave que você quer desativar.
4. Selecione o status "Inativo".
5. Clique em Salvar.

Implementar uma chave de autenticação

Chaves HMAC

Saiba como implementar a autenticação de HMAC.

Chaves de API

Use o SDK do IMA para definir a propriedade apiKey no objeto IMAStreamRequest. Consulte a documentação do desenvolvedor do iOS, Android, Chromecast ou tvOS (em inglês) para mais informações.

Para o beacon do servidor (SSB), use o parâmetro de consulta da api-key:

curl "https://dai.google.com/ondemand/hls/content/CMS_ID/vid/VIDEO_ID/master.m3u8?api-key=<api-authentication-key>"

No caso de problemas relacionados à solução de problemas ou interrupções da DAI, entre em contato com o suporte ao editor.