Autentica le richieste di stream video DAI

Le chiavi di autenticazione DAI (inserimento di annunci dinamici) vengono utilizzate per dimostrare che le richieste di video stream provengono da te. Offrono una maggiore sicurezza durante la pubblicazione di annunci. Una chiave è una stringa ininterrotta di 64 caratteri e numeri. Alcune versioni meno recenti di queste chiavi possono essere composte da 25 caratteri o numeri.

Esempio

0L94DEA6C87B0F3D2407018ACF88ECDE77DK38AD1DX01957311A50E9D1O3F15B

Chiavi API statiche. Le chiavi API hanno la precedenza su quelle HMAC quando sono incluse entrambe. Le chiavi API sono meno sicure delle chiavi HMAC. È consigliabile quindi utilizzare chiavi HMAC.

HMAC. L'autenticazione dei token basata su HMAC offre maggiore sicurezza rispetto alle chiavi API statiche. I token HMAC utilizzano un codice segreto e una durata limitata per garantire che non possano essere facilmente condivisi tra utenti o sessioni.

Suggerimento: prima di autenticare le richieste di stream, assicurati di avere quanto segue:

• Chiave di autenticazione DAI di tipo HMAC
• Live streaming configurato per DAI

Aggiungi una nuova chiave di autenticazione DAI HMAC

Genera e aggiungi una nuova chiave di autenticazione DAI di tipo HMAC:

1. Accedi a Google Ad Manager.
2. Fai clic su Amministratore e poi su Video e audio.
3. Seleziona "Chiavi di autenticazione DAI".
4. Fai clic su Nuova chiave di autenticazione DAI.
5. Inserisci il nome della nuova chiave. Seleziona il tipo "HMAC".
6. Fai clic su Salva.

Questa chiave viene collegata al tuo live streaming quando attivi l'autenticazione.

Abilita l'autenticazione per le richieste alle API DAI

Collega la chiave HMAC al tuo stream:

1. Accedi a Google Ad Manager.
2. Fai clic su Video, quindi su Live streaming.
3. Seleziona il live streaming dall'elenco o fai clic su Nuovo live streaming. Scopri di più sulla creazione di un nuovo live streaming.
4. Nella sezione Impostazioni generali,
   1. Seleziona "Attivato" per "Chiavi di autenticazione delle risorse pod" per autenticare le richieste di pod di annunci e/o
   2. Seleziona "Attivato" per "Stream per creare chiavi di autenticazione" per autenticare le richieste di sessione di streaming
5. Seleziona la chiave HMAC che hai creato.
6. Fai clic su Salva.

Per visualizzare e copiare la chiave, torna alla pagina dei dettagli. Dopo aver creato una chiave di autenticazione DAI attiva, puoi utilizzarla immediatamente. Incorpora la chiave nell'app video client, dove effettui le richieste di stream DAI.

Suggerimento: una best practice prevede la generazione di chiavi di autenticazione DAI separate per ciascuna delle piattaforme client (ad esempio iOS, Android e web).

Una volta salvate, le chiavi vengono automaticamente impostate su "Attive". Vengono implementate correttamente solo le richieste di convalida chiavi di scansione "Attive".

Le richieste che utilizzano chiavi disattivate vengono rifiutate. Disattiva una chiave solo se viene compromessa o non deve essere utilizzata.

Disattiva una chiave di autenticazione esistente

Per disattivare una chiave di autenticazione:

1. Accedi a Google Ad Manager.
2. Fai clic su Amministratore, Video e audio e poi su "Chiavi di autenticazione DAI".
3. Dall'elenco, seleziona la chiave da disattivare.
4. Seleziona lo stato "Non attivo".
5. Fai clic su Salva.

Implementare una chiave di autenticazione

Chiavi HMAC

Scopri come implementare l'autenticazione HMAC.

Chiavi API

Usa l'SDK IMA per impostare la proprietà apiKey nell'oggetto IMAStreamRequest. Per ulteriori informazioni, consulta la documentazione per lo sviluppo iOS, Android, Chromecast o tvOS.

Per il beaconing lato server (SSB), usa il parametro di ricerca api-key:

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

Per eventuali problemi relativi alla risoluzione dei problemi o a interruzioni del servizio DAI, contatta l'assistenza per i publisher.