Besluiten decisions

De besluiten worden geproduceerd door de Authentificatie van Adobe Pass VERTONING API V2die op de de vergunning van MVPD van de gebruiker of voorvergunningsonderzoeken wordt gebaseerd, die bepalen of de toegang tot beschermde inhoudwordt verleend of ontkend.

Er zijn twee soorten besluiten die, afhankelijk van aangehaalde API worden verstrekt:

Voorbereidende besluiten preauthorization-decisions

Het pre-vergunningsbesluit is een informatief besluit dat de cliënttoepassing om toelaat worden geïnformeerd of MVPD de toegang van de gebruiker tot a beschermde middelkan toestaan of ontkennen.

Het doel van voorafgaande toestemming (Preflight-autorisatie) is de toepassing in staat te stellen nauwkeurige informatie weer te geven over de inhoud die de gebruiker kan bekijken. Dit wordt bereikt door de gebruikersinterface te verbeteren met indicatoren, zoals vergrendelde of ontgrendelde pictogrammen, die de toegangsstatus weerspiegelen.

Het gebruik van de API voor voorafgaande toestemming is niet verplicht. De clienttoepassing kan dit overslaan als deze een catalogus met bronnen wil presenteren zonder filtering.

Als de clienttoepassing van plan is deze functie te gebruiken, is het belangrijk om te weten dat beslissingen vóór toelating alleen kunnen worden verkregen voor een beperkt aantal bronnen per API-aanvraag, meestal maximaal 5.

MVPD's kunnen preautorisatie door diverse mechanismen steunen, elk met duidelijke implicaties voor prestaties en het maximumaantal middelen dat in één enkele API verzoek kan worden behandeld.

Voor meer details over de bestaande mechanismen ondersteunend prepermission, verwijs naar de Preflight 1} documentatie van MVPD.

Toelatingsbesluiten authorization-decisions

Het vergunningsbesluit is een gebiedend besluit dat de cliënttoepassing toestaat om met het besluit van MVPD volgzaam te zijn om de toegang van de gebruiker tot a beschermde middeltoe te laten of te ontkennen.

Het doel van de autorisatie is om de toepassing in staat te stellen de door de gebruiker gevraagde bronnen af te spelen, na rechtenvalidatie met de MVPD en ontvangst van een media-token van Adobe Pass-verificatie.

Het gebruik van de autorisatie-API is verplicht. De clienttoepassing kan deze fase niet overslaan als deze bronnen wil afspelen die de gebruiker vraagt, omdat de toepassing eerst met de MVPD moet controleren of de gebruiker gerechtigd is voordat de stream wordt vrijgegeven.

Het is belangrijk om op te merken dat vergunningsbesluiten slechts voor een beperkt aantal middelen per API verzoek kunnen worden verkregen, typisch 1.

Autorisatietijd-aan-Levend (TTL) Beheer authorization-ttl-management

De Tijd-aan-Levende van de vergunning (TTL) bepaalt hoe lang een middel alvorens het moet opnieuw machtigen wordt toegelaten. Deze termijn is beperkt en moet worden overeengekomen met vertegenwoordigers van MVPD. De waarden van TTL kunnen variëren gebaseerd op:

De vergunning (authZ) TTL kan door het Dashboard van Adobe Pass worden bekeken en worden veranderd TVEdoor één van uw organisatiebeheerders of door een vertegenwoordiger van de Authentificatie van Adobe Pass handelend namens u.

Voor meer details, verwijs naar de 🔗 documentatie van de Gebruiker van de Gids van de Integratie van het Dashboard van 0} TVE.

Beveiligde bronnen protected-resources

De beschermde middelen verwijzen naar stroombare inhoud, die door unieke waarden wordt geïdentificeerd die door overeenkomsten tussen MVPDs en deelnemende Programmers worden bepaald.

De beschermde middelen volgen een hiërarchische boomstructuur, met elk niveau dat grotere granulariteit voor inhoudsvergunning verstrekt:

Resource Identifier resource-identifier

De unieke resource-id kan twee indelingen hebben:

In het geval van een eenvoudige middel herkenningsteken, zoals "REF30"(verondersteld om een kanaal te vertegenwoordigen), kan het in een RSS middelherkenningsteken als volgt worden vertaald:

    <rss version="2.0">
        <channel>
            <title>REF30</title>
        </channel>
    </rss>

In het geval van een complexere resource-id kan de RSS-resource-id als volgt aanvullende classificatiegegevens bevatten:

    <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 unieke id's zijn voornamelijk ondoorzichtig voor Adobe Pass-verificatie, maar transformatoren kunnen worden toegepast op basis van de MVPD-mogelijkheden en -vereisten. Als MVPD een middelherkenningsteken niet herkent of ontleedt, keert het een fout aan de Authentificatie van Adobe Pass terug, die later de fout aan de cliënttoepassing gebruikend een Verbeterde Code van de Foutopnieuw afspeelt.

REST API V2 rest-api-v2

De voorafgaande beslissingen kunnen worden opgehaald met behulp van de volgende API:

De vergunningsbesluiten kunnen worden teruggewonnen gebruikend volgende API:

Verwijs naar de secties van de Reactie en Steekproeven van bovengenoemde APIs om de structuur van pre- toestemmings en vergunningsbesluiten te begrijpen.

Raadpleeg de volgende documenten voor meer informatie over hoe en wanneer u de bovenstaande API's wilt integreren: