Beslut
- Ämnen:
- Autentisering
Beslut genereras av Adobe Pass-autentiseringen REST API V2 baserat på användarens MVPD-auktoriserings- eller förauktoriseringsfrågor och avgör om åtkomst till skyddat innehåll beviljas eller nekas.
Det finns två typer av beslut, beroende på vilket API som anropas:
- Förhandsauktoriseringsbeslut som är informativa beslut.
- Auktoriseringsbeslut som är auktoritativa beslut.
Förauktoriseringsbeslut
Förauktoriseringsbeslutet är ett informativt beslut som gör att klientprogrammet kan informeras om huruvida MVPD kan tillåta eller neka användarens åtkomst till en skyddad resurs.
Syftet med förhandsauktoriseringen (preflight-auktorisering) är att programmet ska kunna visa korrekt information om det innehåll som användaren kan ha rätt att visa. Detta uppnås genom att förbättra användargränssnittet med indikatorer, t.ex. låsta eller olåsta ikoner, för att återspegla åtkomststatusen.
Det är inte obligatoriskt att använda API:t för förhandsauktorisering. Klientprogrammet kan hoppa över detta om det vill visa en katalog med resurser utan någon filtrering.
Om klientprogrammet har för avsikt att använda den här funktionen är det viktigt att observera att beslut om förauktorisering bara kan erhållas för ett begränsat antal resurser per API-begäran, vanligtvis upp till 5.
MVPD-program kan ha stöd för förauktorisering via olika mekanismer, var och en med tydliga följder för prestanda och det maximala antalet resurser som kan hanteras i en enda API-begäran.
Mer information om de mekanismer som stöder förauktorisering finns i dokumentationen för MVPD Preflight Authorization.
Beslut om tillstånd
Auktoriseringsbeslutet är ett auktoritativt beslut som gör att klientprogrammet följer MVPD beslut att tillåta eller neka användarens åtkomst till en skyddad resurs.
Syftet med auktoriseringen är att göra det möjligt för programmet att spela upp de resurser som begärts av användaren, efter rättighetsvalidering med MVPD och mottagande av en medietoken från Adobe Pass Authentication.
Användningen av auktoriserings-API är obligatorisk, klientprogrammet kan inte hoppa över den här fasen om det vill spela upp resurser som användaren begär, eftersom det kräver verifiering med MVPD att användaren har rätt innan strömmen släpps.
Det är viktigt att komma ihåg att auktoriseringsbeslut bara kan erhållas för ett begränsat antal resurser per API-begäran, vanligtvis 1.
TTL-hantering (Time-to-Live) för auktorisering
TTL (Time-to-Live) för auktorisering anger hur länge en resurs förblir auktoriserad innan den behöver auktoriseras igen. Denna tidsram är begränsad och måste avtalas med MVPD representanter. TTL-värdena kan variera beroende på:
- Plattformskategori (t.ex. dator, mobil, tv-anslutna enheter)
- Specifik plattform (t.ex. iOS, Android, tvOS, Roku, FireTV)
TTL för auktorisering (authZ) kan visas och ändras via Adobe Pass TVE Dashboard av en av dina företagsadministratörer eller av en Adobe Pass-autentiseringsrepresentant som agerar för din räkning.
Mer information finns i dokumentationen för TVE Dashboard Integrations User Guide .
Skyddade resurser
Skyddade resurser avser strömlinjeformat innehåll, som identifieras av unika värden som definieras genom avtal mellan distributörer av videoprogrammeringstjänster och deltagande programmerare.
Skyddade resurser följer en hierarkisk trädstruktur, där varje nivå ger större detaljrikedom vid innehållsauktorisering:
- Nätverk
- Kanal
- Visa
- Episod
- Tillgång
- Episod
- Visa
- Kanal
CDATA
avsnitt vid förauktorisering, eftersom de i första hand används för resurser på tillgångsnivå som definieras av en MRSS.Resurs-ID
Den unika identifieraren för resursen kan ha två format:
- Ett enkelt strängformat, till exempel en unik identifierare för en kanal (varumärke).
- Ett medie-RSS-format (MRSS) som innehåller ytterligare information som titel, gradering och metadata för föräldrakontroll.
När det gäller en enkel resursidentifierare, t.ex. "REF30" (antas representera en kanal), kan den översättas till en RSS-resursidentifierare enligt följande:
<rss version="2.0">
<channel>
<title>REF30</title>
</channel>
</rss>
Om resursidentifieraren är mer komplex kan den innehålla ytterligare klassificeringsinformation enligt följande:
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/">
<channel>
<title>REF30</title>
<media:rating scheme="urn:mpaa">pg</media:rating>
</channel>
</rss>
De unika identifierarna är i första hand ogenomskinliga för Adobe Pass Authentication, men transformerare kan tillämpas baserat på MVPD funktioner och krav. Om MVPD inte känner igen eller tolkar en resursidentifierare returneras ett fel till Adobe Pass Authentication, som därefter skickar felet till klientprogrammet med hjälp av en Förbättrad felkod.
REST API V2
Förauktoriseringsbesluten kan hämtas med följande API:
Behörighetsbesluten kan hämtas med följande API:
Se avsnitten Svar och Exempel i ovanstående API:er för att förstå strukturen för beslut om förauktorisering och auktorisering.
Mer information om hur och när ovanstående API:er ska integreras finns i följande dokument: