Programmeringsintegratiegids
- Onderwerpen:
- Authenticatie
BELANGRIJKDeze integratiehandleiding is bedoeld voor inhoudsproviders (programmeurs) die van plan zijn te integreren met Adobe® Pass Authentication.
In het huidige digitale landschap hebben gebruikers altijd en overal toegang tot internet en kunnen ze toegang aanvragen tot uw beveiligde inhoud. Misschien kijken ze naar een eenmalig evenement of zoeken ze de rechten om een hele televisieserie te streamen die je stuurt.
Voordat u toegang tot beveiligde inhoud verleent, moet u bepalen of de viewer er recht op heeft. De belangrijkste vragen zijn:
- heeft de kijker een actief abonnement met een Multichannel Video Programming Distributor (MVPD)?
- omvat dat abonnement uw programmering?
Adobe Pass-verificatie voor tv overal
Voor programmeurs is het bepalen van de aanspraak niet altijd eenvoudig. MVPD’s zijn de bewaarnemers van de identificatiegegevens en toegangsrechten van hun klanten. Bovendien kunnen programmeurs zich op een groot aantal verschillende MVPD's abonneren, elk met unieke systemen. Deze complexiteit maakt het controleren van het recht technisch lastig en hulpbronnenintensief.
die} gebruikerstoestemming direct door programmeur wordt bepaald
Adobe Pass-verificatie vergemakkelijkt op veilige wijze machtigingstransacties tussen programmeurs en MVPD's, waardoor het snel, gemakkelijk en veilig is om beveiligde inhoud aan in aanmerking komende viewers te leveren.
Gebruikersnaam die door de Authentificatie van Adobe Pass wordt gemedieerd
De Authentificatie van Adobe Pass werkt als volmacht en vergemakkelijkt de machtigingsstroom tussen Programmers en MVPDs door veilige en verenigbare interfaces voor beide partijen aan te bieden.
Voor Programmeurs, verstrekt de Authentificatie van Adobe Pass APIs als deel van a Standaard of a Premium rij:
-
Standaard Adobe Pass-verificatie-API's:
-
Premium-API's voor Adobe Pass-verificatie:
Gevallen gebruiken
In deze sectie worden de Gebruiksgevallen voor de integratie van de programmeur beschreven die door Adobe Pass-verificatie worden ondersteund:
-
Programmeertoepassing (TVE) met één kanaalnetwerk
Hierdoor kan de programmeur gebruikers toegang tot de inhoud bieden via een kanaalnetwerk voor één merk binnen een TVE-toepassing.
-
Programmeertoepassing (TVE) met meerdere kanaalnetwerken
Hierdoor kan de programmeur gebruikers toegang verschaffen tot de inhoud via meerdere kanaalnetwerken in één TVE-toepassing.
-
Programmeertoepassing (TVE) voor speciale gebeurtenissen
Hierdoor kan de programmeur gebruikers toegang geven tot de inhoud van speciale gebeurtenissen die mogelijk geen bronnen zijn die zich in de MVPD-machtigingsdatabase bevinden, zoals normale kanalen.
Entitlement Flow
De machtigingsstroom is een reeks stappen die een programmeertoepassing (TVE) moet voltooien om beveiligde inhoud te streamen. De stroom bestaat uit de volgende fasen:
Bij het eerste bezoek van een gebruiker aan een programmeertoepassing (TVE) volgt de stroom voor machtigingen de geschetste volgorde. Bij volgende bezoeken kan de toepassing echter bepaalde stappen omzeilen op basis van de status van de registratie of verificatie en het toepasselijke weergavebeleid.
Voor een gedetailleerde verkenning van de machtigingsstroom en de bijbehorende fasen, blijft u dit document lezen en raadpleegt u de bijbehorende handleidingen voor cookies voor meer informatie:
NOTERegistratiefase
Het doel van de Fase van de Registratie is de cliënttoepassing tegen de Authentificatie van Adobe Pass door het Dynamische Registratie van de Cliënt (DCR) te registrerenproces.
Het dynamische proces van de Registratie van de Cliënt (DCR) vereist de cliënttoepassing om een paar cliëntgeloofsbrieven te verkrijgen en een toegangstoken als einddoel van de Fase van de Registratie terug te winnen.
APIs
Stromen
FAQs
Configuratiefase
Het doel van de Fase van de Configuratie is de cliënttoepassing de lijst van MVPDs te verstrekken waarmee het samen met configuratiedetails actief wordt geïntegreerd die door de Authentificatie van Adobe Pass voor elke MVPD wordt bewaard.
De configuratiefase fungeert als een noodzakelijke stap voor de verificatiefase wanneer de clienttoepassing de gebruiker moet vragen zijn of haar tv-provider te selecteren.
APIs
FAQs
TIPVerificatiefase
Het doel van de verificatiefase is om de clienttoepassing de mogelijkheid te bieden de identiteit van de gebruiker met de MVPD te verifiëren en om metagegevens van de gebruiker te verkrijgen.
De verificatiefase fungeert als een noodzakelijke stap voor de fase voorafgaand aan autorisatie of de machtigingsfase wanneer de clienttoepassing inhoud moet afspelen.
Met geslaagde verificatie wordt een profiel gegenereerd dat is gekoppeld aan de toepassing, het apparaat en de serviceprovider, en dat ook informatie over gebruikersmetagegevens bevat.
Stappen op hoog niveau
De volgende stappen schetsen de stappen op hoog niveau in het geval van een integratie van SAML:
-
de Lading van de Toepassing van de Programmer (Website)
De gebruiker navigeert aan de toepassing van de Programmer (website), die de Authentificatie van Adobe Pass REST API V2integreert. -
het Beschermde Verzoek van de Inhoud
Wanneer de gebruiker toegang probeert te krijgen tot beveiligde inhoud, geeft de toepassing van de programmeur een lijst van MVPD's weer waaruit de gebruiker kan kiezen. -
Initialisatie van het Verzoek van de Authentificatie
Als MVPD is geselecteerd, wordt de gebruiker omgeleid naar een Adobe Pass-verificatieserver. Hier, wordt een gecodeerd de authentificatieverzoek van SAML voor geselecteerde MVPD geproduceerd, in het geval van een integratie SAML. Dit verzoek wordt namens de programmeur naar de MVPD verzonden. Afhankelijk van het MVPD-systeem wordt de browser van de gebruiker omgeleid naar de aanmeldingspagina van MVPD of wordt een inlogiFrame ingesloten in de toepassing van de programmeur. -
Login MVPD
MVPD accepteert de aanvraag en presenteert zijn aanmeldingsinterface via omleiding of iFrame. -
Login en Bevestiging van de Gebruiker
De gebruiker meldt zich aan met zijn MVPD-referenties. De MVPD valideert de abonnementsstatus van de gebruiker en stelt een eigen HTTP-sessie in. -
MVPD Reactie op de Authentificatie van Adobe Pass
Nadat de validatie is voltooid, genereert de MVPD een (gecodeerde) SAML-reactie en stuurt deze terug naar de Adobe Pass-verificatie. -
de Generatie van het Profiel
De Authentificatie van Adobe Pass verifieert de reactie van SAML, produceert een gebruikersprofiel dat caching wordt, en richt de gebruiker terug naar de toepassing van de Programmer (website).
APIs
Stromen
FAQs
TIPEenmalige aanmelding (SSO)
APIs
Stromen
(Optioneel) Preautorisatiefase
Het doel van de fase van voorafgaande toestemming is de clienttoepassing de mogelijkheid te bieden een subset van bronnen uit de catalogus te presenteren waartoe de gebruiker toegang zou hebben.
De fase voorafgaand aan autorisatie kan de gebruikerservaring verbeteren wanneer de gebruiker de cliënttoepassing voor het eerst opent of aan een nieuwe sectie navigeert.
APIs
Stromen
FAQs
TIPAutorisatiefase
Het doel van de machtigingsfase is om de clienttoepassing de mogelijkheid te bieden om bronnen af te spelen die de gebruiker vraagt nadat hij zijn rechten met de MVPD heeft gevalideerd.
Succesvolle autorisatie genereert een beslissing, die ook een media-token bevat dat voor beveiligingsdoeleinden aan de toepassing Programmer (TVE) wordt geleverd.
Stappen op hoog niveau
In de volgende stappen worden de stappen op hoog niveau beschreven:
-
Verwerking van het Herkenningsteken van het Middel
De beschermde inhoud wordt geïdentificeerd door a middelherkenningsteken, dat een eenvoudig koord of een complexere structuur kan zijn. Deze id is vooraf gedefinieerd en overeengekomen door de programmeur en de MVPD. De toepassing van de Programmer verzendt het middelherkenningsteken naar de Authentificatie van Adobe Pass REST API V2. -
de Controle van de Vergunning van MVPD
De server van de Authentificatie van Adobe Pass communiceert met het de vergunningseindpunt van MVPD gebruikend gestandaardiseerde protocollen. -
MVPD Reactie op de Authentificatie van Adobe Pass
Zodra de validatie is voltooid, bevestigt de MVPD dat de gebruiker (of niet) gerechtigd is om toegang te krijgen tot de inhoud en een reactie terug te sturen naar de Adobe Pass-verificatie. -
Besluit en de Symbolische Generatie van Media
De Authentificatie van Adobe Pass verifieert de reactie, produceert a besluitdat in het voorgeheugen ondergebracht wordt, en keert het besluit terug dat een media teken terug naar de toepassing van de Programmer (website) bevat. -
de Verificatie van de Toegang van de Inhoud
De toepassing van de Programmer gebruikt Symbolische Verifier van Mediaom te bevestigen dat de correcte gebruiker tot de correcte inhoud toegang heeft. Na de validatie krijgt de gebruiker toegang om de beveiligde inhoud weer te geven.
APIs
Stromen
FAQs
TIPAfmeldingsfase
Het doel van de afmeldingsfase is om de clienttoepassing de mogelijkheid te bieden het geverifieerde profiel van de gebruiker binnen de Adobe Pass-verificatie op verzoek te beëindigen.
APIs
Stromen
FAQs
Single Logout (SLO)
Stromen
Entitlement
De oplossing van de Authentificatie van Adobe Pass draait rond de verwezenlijking van recht-specifieke stukken gegevens die op de succesvolle voltooiing van authentificatie en vergunningswerkschema's worden geproduceerd. Deze rechten verlenen toegang tot beschermde inhoud, maar hebben een beperkte duur. Nadat een machtiging is verlopen, moet deze worden vernieuwd door de verificatie- of autorisatieprocessen opnieuw te starten.
Raadpleeg de volgende documenten voor meer informatie over rechten:
-
Profielen
Na succesvolle verificatie maakt Adobe Pass Authentication een geverifieerd profiel ("long-live") dat is gekoppeld aan de aanvraag-id voor de toepassing, het apparaat en de serviceprovider (aanvrager-id).
-
Bij geslaagde verificatie (en in sommige gevallen ook na autorisatie) ontvangt Adobe Pass Authentication gebruikersmetagegevens van de MVPD die deze toegankelijk kunnen maken voor de toepassing die het verzoek indient.
-
Na een geslaagde autorisatie maakt Adobe Pass Authentication een machtigingsbesluit ("langlevende") dat verband houdt met de aanvraag, het apparaat, de dienstverlener-id (aanvrager-id) en een specifieke beschermde bron (bron-id).
-
Na een geslaagde autorisatie maakt Adobe Pass Authentication een mediatoken ("kortstondig") die aan een succesvol afspeelverzoek is gekoppeld en die ondersteuning biedt voor best practices van de branche voor het beperken van fraude (bijvoorbeeld 'streaming ripping').
De time-to-live ("TTL") waarden voor profielen en besluiten worden vastgesteld op basis van overeenkomsten tussen programmeurs en betaaltelevisieproviders, die het eens zijn over een waarde die het best alle betrokkenen ten goede komt.