Uwierzytelnianie żądań strumienia wideo na żywo za pomocą kluczy uwierzytelniania DAI

Klucze uwierzytelniania DAI pozwalają potwierdzić, że żądania strumienia wideo pochodzą od Ciebie. Zapewnia to większe bezpieczeństwo podczas wyświetlania reklam. Klucz ma postać nieprzerwanego ciągu 64 znaków i cyfr. Niektóre starsze klucze mogą składać się z 25 znaków lub cyfr.

Przykład

0L94DEA6C87B0F3D2407018ACF88ECDE77DK38AD1DX01957311A50E9D1O3F15B

Statyczne klucze interfejsu API: klucze interfejsu API mają wyższy priorytet niż klucze HMAC, jeśli występują oba. Klucze API są mniej bezpieczne niż klucze HMAC. Dlatego zalecamy używanie kluczy HMAC.

HMAC: uwierzytelnianie za pomocą tokenów opartych na HMAC zapewnia wyższy poziom bezpieczeństwa niż statyczne klucze interfejsu API. Tokeny oparte na HMAC wykorzystują poufny klucz i są ważne przez ograniczony czas, co daje gwarancję, że nie będzie można łatwo udostępniać tokena między użytkownikami lub sesjami.

Wskazówka: przed uwierzytelnieniem żądań transmisji sprawdź czy:

• posiadasz klucz uwierzytelniania DAI typu HMAC,
• transmisja na żywo jest skonfigurowana na potrzeby DAI.

Dodawanie nowego klucza uwierzytelniania DAI HMAC

Wygeneruj i dodaj nowy klucz uwierzytelniania DAI typu HMAC:

1. Zaloguj się w usłudze Google Ad Manager.
2. Kliknij kolejno Administracja oraz Wideo i audio.
3. Wybierz „Klucze uwierzytelniania DAI”.
4. Kliknij Nowy klucz uwierzytelniania DAI.
5. Wpisz nazwę nowego klucza. Wybierz typ „HMAC”.
6. Kliknij Zapisz.

Ten klucz będzie powiązany z transmisją na żywo, gdy włączysz uwierzytelnianie.

Włączanie uwierzytelniania żądań wysyłanych do interfejsów DAI API

Powiąż klucz HMAC z transmisją:

1. Zaloguj się w usłudze Google Ad Manager.
2. Kliknij kolejno Wideo i Transmisje na żywo.
3. Wybierz transmisję na żywo z listy lub kliknij Nowa transmisja na żywo. Dowiedz się więcej o tworzeniu nowej transmisji na żywo.
4. W sekcji Ustawienia ogólne:
   1. w sekcji „Klucze uwierzytelniania zasobów bloku reklamowego” wybierz „Włączone”, aby uwierzytelniać żądania bloku reklamowego, lub
   2. w sekcji „Klucze uwierzytelniania do utworzenia transmisji” wybierz „Włączone”, aby uwierzytelniać żądania utworzenia sesji transmisji.
5. Wybierz utworzony klucz HMAC.
6. Kliknij Zapisz.

Aby wyświetlić i skopiować klucz, wróć na stronę szczegółów. Po utworzeniu aktywnego klucza uwierzytelniania DAI możesz go od razu użyć. Umieść klucz w aplikacji wideo klienta, w której wysyłasz żądania transmisji DAI.

Wskazówka: sprawdzoną metodą jest generowanie osobnych kluczy uwierzytelniania DAI dla każdej platformy klienta (np. iOS, Android i sieć).

Po zapisaniu klucza jego stan automatycznie zmieni się na „Aktywny”. Tylko prawidłowo zaimplementowane klucze „Aktywne” mogą weryfikować żądania.

Żądania używające dezaktywowanych kluczy są odrzucane. Klucz należy zdezaktywować, jeśli jego zabezpieczenia zostały naruszone lub jeśli nie ma on być wykorzystywany.

Dezaktywowanie istniejącego klucza uwierzytelniania

Aby zdezaktywować klucz uwierzytelniania, wykonaj te czynności:

1. Zaloguj się w usłudze Google Ad Manager.
2. Kliknij kolejno Administracja, Wideo i audio oraz „Klucze uwierzytelniania DAI”.
3. Wybierz z listy klucz, który chcesz dezaktywować.
4. Wybierz stan „Nieaktywny”.
5. Kliknij Zapisz.

Implementowanie klucza uwierzytelniania

Klucze HMAC

Dowiedz się, jak wdrożyć uwierzytelnianie za pomocą tokenu HMAC.

Klucze interfejsu API

Użyj pakietu IMA SDK, aby skonfigurować właściwość apiKey w obiekcie IMAStreamRequest. Więcej informacji znajdziesz w dokumentacji dla deweloperów aplikacji na iOS, Android, Chromecast lub tvOS.

W przypadku zastosowania sygnalizowania po stronie serwera na potrzeby dynamicznego wstawiania reklam użyj parametru zapytania api-key.

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

W kwestiach związanych z rozwiązywaniem problemów z systemem DAI lub przerwami w jego działaniu kontaktuj się z zespołem pomocy dla wydawców.