DocumentatieAdobe PassAdobe Pass-verificatie

Apple SSO Cookbook (REST API V2) apple-sso-cookbook-rest-api-v2

Last update: Wed Nov 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
De inhoud op deze pagina wordt alleen ter informatie verstrekt. Voor het gebruik van deze API is een huidige licentie van Adobe vereist. Ongeautoriseerd gebruik is niet toegestaan.

De Adobe Pass Authentication REST API V2 biedt ondersteuning voor Single Sign-On (SSO) voor eindgebruikers van clienttoepassingen die op iOS, iPadOS of tvOS worden uitgevoerd.

Dit document doet dienst als uitbreiding aan het bestaande REST API V2 Overzichtdat een mening op hoog niveau en het document verstrekt dat beschrijft hoe te om Enige sign-on uit te voeren gebruikend partnerstromen.

Apple Single Sign-On met gebruik van partnerstromen cookbook

Vereisten prerequisites

Voordat u verdergaat met de Apple Single Sign-On met behulp van partnerstromen, moet u ervoor zorgen dat aan de volgende voorwaarden wordt voldaan:

  • De streamingtoepassing moet alle vereiste gegevens voor de headers X-Device-Info en/of User-Agent verzamelen, zodat de Adobe Pass-verificatieachterkant het apparaatplatform en de mogelijkheden ervan kan identificeren. Voor meer details over X-Device-Info kopbal, verwijs naar x-apparaat-Infodocumentatie.

  • De streamingtoepassing moet toegang aanvragen tot de abonnementsgegevens van de gebruiker die op apparaatniveau zijn opgeslagen, waarvoor de gebruiker de toepassing toestemming moet geven om door te gaan, net als het verlenen van toegang tot de camera of microfoon van het apparaat. Deze toestemming moet per toepassing worden gevraagd gebruikend het Kader van de Rekening van de Abonnee van Apple Videoen het apparaat zal de selectie van de gebruiker bewaren.

    We raden gebruikers aan die geen toestemming geven om abonnementsgegevens te openen, te stimuleren door de voordelen uit te leggen van de Apple Single Sign-On gebruikerservaring, maar we raden gebruikers aan hun beslissing te wijzigen door naar de toepassingsinstellingen (toegang tot tv-provider) of Settings -> TV Provider op iOS en iPadOS of Settings -> Accounts -> TV Provider op tvOS te gaan.

    De het stromen toepassing kan om de toestemming van de gebruiker verzoeken wanneer de toepassing de voorgrondstaat ingaat, omdat de toepassing toestemming kan controleren om totde abonnementsinformatie van de gebruiker op om het even welk punt toegang te hebben alvorens gebruikersauthentificatie te vereisen.

IMPORTANT
Veronderstellingen
  • De het stromen toepassing heeft op het instappen eerste vereistenvoltooid die op een Programmer van toepassing zijn en worden vereist om Apple enige sign-on gebruikerservaring toe te laten.

Workflow workflow

Voer de bepaalde stappen uit om Apple enig teken-op uit te voeren gebruikend partnerstromen zoals aangetoond in het volgende diagram.

Apple enig teken-op gebruikend partnerstromen

Apple enig teken-op gebruikend partnerstromen

A. Registratiefase

  1. wint cliëntgeloofsbrieven terug: de het stromen toepassing verzamelt alle noodzakelijke gegevens om cliëntgeloofsbrieven terug te winnen door het eindpunt van het Register van de Cliënt te roepen.

    note important
    IMPORTANT
    Verwijs naar terugwinnen cliëntgeloofsbrievenAPI documentatie voor details op:
    • Alle vereiste parameters, als software_statement
    • Alle vereiste kopballen, als Content-Type, X-Device-Info
    • Alle facultatieve parameters en kopballen

  2. de cliëntgeloofsbrieven van de Terugkeer: De het eindpuntreactie van het Register van de Cliënt bevat informatie over de cliëntgeloofsbrieven verbonden aan de ontvangen parameters en kopballen.

    note important
    IMPORTANT
    Verwijs naar terugwinnen cliëntgeloofsbrievenAPI documentatie voor details over de informatie die in een reactie van de cliëntgeloofsbrieven wordt verstrekt.
    In het clientregister worden de aanvraaggegevens gevalideerd om ervoor te zorgen dat aan de basisvoorwaarden wordt voldaan:
    • De vereiste parameters en de kopballen moeten geldig zijn.
    Als de bevestiging ontbreekt, zal een foutenreactie worden geproduceerd, die extra informatie verstrekken die aan voldoet wint cliëntgeloofsbrievenAPI documentatie terug.
    note tip
    TIP
    Suggestie: de clientgegevens moeten in de cache worden opgeslagen en kunnen voor onbepaalde tijd worden gebruikt.

  3. wint toegangstoken terug: de het stromen toepassing verzamelt alle noodzakelijke gegevens om toegangstoken terug te winnen door het Symbolische eindpunt van de Cliënt te roepen.

    note important
    IMPORTANT
    Verwijs naar ophalen toegangstokenAPI documentatie voor details op:
    • Alle vereiste parameters, als client_id, client_secret, en grant_type
    • Alle vereiste kopballen, als Content-Type, X-Device-Info
    • Alle facultatieve parameters en kopballen

  4. het toegangstoken van de Terugkeer: De het eindpuntreactie van het Symbolische van de Cliënt bevat informatie over het toegangstoken verbonden aan de ontvangen parameters en kopballen.

    note important
    IMPORTANT
    Verwijs naar ophalen toegangstokenAPI documentatie voor details over de informatie die in een reactie van het toegangstoken wordt verstrekt.
    De Clienttoken valideert de aanvraaggegevens om ervoor te zorgen dat aan de basisvoorwaarden wordt voldaan:
    • De vereiste parameters en de kopballen moeten geldig zijn.
    Als de bevestiging ontbreekt, zal een foutenreactie worden geproduceerd, die extra informatie verstrekken die aan voldoet verkrijgt toegangstokenAPI documentatie.
    note tip
    TIP
    Suggestie: het toegangstoken moet in de cache worden opgeslagen en alleen binnen de opgegeven tijdsduur worden gebruikt (bijvoorbeeld 24-uurs time-to-live). Nadat deze is verlopen, moet de streamingtoepassing een nieuw toegangstoken aanvragen.
B. Verificatiefase controleren

  1. wint de status van het partnerkader terug: de het stromen toepassing roept het Video Kader van de Rekening van de Abonneedat door Apple wordt ontwikkeld, om gebruikerstoestemming en leveranciersinformatie te verkrijgen.

    note important
    IMPORTANT
    Verwijs naar de 🔗 documentatie van het Kader van de Rekening van de Abonnee van 0} Video voor details op:
    • De het stromen toepassing moet toestemming controleren om totde het abonnementinformatie van de gebruiker toegang te hebben en slechts te werk te gaan als de gebruiker het toeliet.
    • De het stromen toepassing moet a afgevaardigdevoor VSAccountManager verstrekken.
    • De het stromen toepassing moet a verzoekvoor de informatie van de abonneerekening voorleggen.
    • De het stromen toepassing moet de meta-gegevensinformatie wachten en verwerken.
    De streamingtoepassing moet ervoor zorgen dat deze een Booleaanse waarde opgeeft die gelijk is aan false voor de eigenschap isInterruptionAllowedin het VSAccountMetadataRequest -object, om aan te geven dat de gebruiker in deze fase niet kan worden onderbroken.

  2. de statusinformatie van het partnerkader van de Terugkeer: De het stromen toepassing bevestigt de reactiegegevens om ervoor te zorgen dat de basisvoorwaarden worden voldaan aan:

    • De toegangsstatus van de gebruikerstoestemming wordt verleend.
    • De toewijzingsaanduiding van de gebruikersprovider is aanwezig en geldig.
    • De vervaldatum (indien beschikbaar) van het gebruikersprovider-profiel is geldig.

  3. wint profielen terug: de het stromen toepassing verzamelt alle noodzakelijke gegevens om alle profielinformatie terug te winnen door een verzoek naar het eindpunt van Profielen te verzenden.

    note important
    IMPORTANT
    Verwijs naar terugwinnen profielenAPI documentatie voor details op:
    • Alle vereiste parameters, als serviceProvider
    • Alle vereiste kopballen, als Authorization, AP-Device-Identifier, en AP-Partner-Framework-Status
    • Alle facultatieve parameters en kopballen
    De streamingtoepassing moet ervoor zorgen dat deze een geldige waarde bevat voor de status van het partnerframework, zodat de opgehaalde reactie een "appleSSO"-typeprofiel kan bevatten.
    Voor meer details over AP-Partner-Framework-Status kopbal, verwijs naar AP-partner-kader-statusdocumentatie.

  4. de informatie van de Terugkeer over gevonden profielen: de het eindpuntreactie van Profielen bevat informatie over de gevonden profielen verbonden aan de ontvangen parameters en kopballen.

  5. kies een profiel en ga met besluitvormingsstromen te werk: als de het eindpuntreactie van Profielen profielen bevat, gebruikt de het stromen toepassing zijn interne logica (uiteindelijk door met de eindgebruiker in wisselwerking te staan) om één van de beschikbare profielen te kiezen om met verdere besluitvormingsstromen verder te gaan.

  6. ga met de stroom van de partnerauthentificatie te werk: als de het eindpuntreactie van Profielen geen profiel bevat, gaat de het stromen toepassing met de stroom van de partnerauthentificatie verder.

C. Verificatiefase voor partners

  1. wint configuratie terug: de het stromen toepassing verzamelt alle noodzakelijke gegevens om de lijst van MVPDs terug te winnen die een actieve integratie hebben door een verzoek naar het eindpunt van de Configuratie te verzenden.

    note important
    IMPORTANT
    Verwijs naar terugwinnen configuratie voor specifieke dienstverlenerAPI documentatie voor details op:
    • Alle vereiste parameters, als serviceProvider
    • Alle vereiste kopballen, als Authorization, AP-Device-Identifier, en X-Device-Info
    • Alle facultatieve parameters en kopballen

  2. de configuratie van de Terugkeer: De het eindpuntreactie van de Configuratie bevat informatie over MVPDs die een actieve integratie met de dienstverlener hebben.

    note important
    IMPORTANT
    Verwijs naar terugwinnen configuratie voor specifieke dienstverlenerAPI documentatie voor details op de informatie die in een configuratiereactie wordt verstrekt.
    Het eindpunt van de Configuratie bevestigt de verzoekgegevens om ervoor te zorgen dat de basisvoorwaarden worden voldaan aan:
    • De vereiste parameters en de kopballen moeten geldig zijn.
    Als de bevestiging ontbreekt, zal een foutenreactie worden geproduceerd, die extra informatie verstrekken die aan de Verbeterde Codes van de Foutvolgt
    note important
    IMPORTANT
    De streamingtoepassing moet ervoor zorgen dat de volgende details voor elke MVPD worden verwerkt wanneer verder wordt gegaan:
    • enablePlatformServices: geeft aan of de MVPD momenteel ondersteuning biedt voor het eenmalige aanmelding voor Apple.
    • displayInPlatformPicker: geeft aan of de MVPD kan worden weergegeven in de Apple-kiezer.
    • boardingStatus: geeft aan of de MVPD is ingeschakeld in het eenmalige Apple-teken.

  3. wint de status van het partnerkader terug: de het stromen toepassing roept het Video Kader van de Rekening van de Abonneedat door Apple wordt ontwikkeld, om gebruikerstoestemming en leveranciersinformatie te verkrijgen.

    note important
    IMPORTANT
    Verwijs naar de 🔗 documentatie van het Kader van de Rekening van de Abonnee van 0} Video voor details op:
    • De het stromen toepassing moet toestemming controleren om totde het abonnementinformatie van de gebruiker toegang te hebben en slechts te werk te gaan als de gebruiker het toeliet.
    • De het stromen toepassing moet a afgevaardigdevoor VSAccountManager verstrekken.
    • De het stromen toepassing moet a verzoekvoor de informatie van de abonneerekening voorleggen.
    • De het stromen toepassing moet de meta-gegevensinformatie wachten en verwerken.
    De streamingtoepassing moet ervoor zorgen dat deze een Booleaanse waarde opgeeft die gelijk is aan true voor de eigenschap isInterruptionAllowedin het VSAccountMetadataRequest -object, om aan te geven dat de gebruiker kan worden onderbroken om in deze fase een tv-provider te selecteren.

  4. de statusinformatie van het partnerkader van de Terugkeer: De het stromen toepassing bevestigt de reactiegegevens om ervoor te zorgen dat de basisvoorwaarden worden voldaan aan:

    • De toegangsstatus van de gebruikerstoestemming wordt verleend.
    • De toewijzingsaanduiding van de gebruikersprovider is aanwezig en geldig.
    • De vervaldatum (indien beschikbaar) van het gebruikersprovider-profiel is geldig.

  5. wint het verzoek van de partnerauthentificatie terug: de het stromen toepassing verzamelt alle noodzakelijke gegevens om een authentificatiesessie in werking te stellen door het eindpunt van de Partner van Sessies te roepen.

    note important
    IMPORTANT
    Verwijs naar ophalen de verzoek van de partnerauthentificatieAPI documentatie voor details op:
    • Alle vereiste parameters, als serviceProvider en partner
    • Alle vereiste kopballen zoals Authorization, AP-Device-Identifier, Content-Type, X-Device-Info, en AP-Partner-Framework-Status
    • Alle facultatieve kopballen en parameters
    De het stromen toepassing moet ervoor zorgen het een geldige waarde voor de status van het partnerkader omvat dusdanig dat de teruggewonnen reactie een verzoek van de partnerauthentificatie (het verzoek van SAML) kan omvatten.
    Voor meer details over AP-Partner-Framework-Status kopbal, verwijs naar AP-partner-kader-statusdocumentatie.

  6. wijs op de volgende actie: De het eindpuntreactie van de Partner van Sessies bevat de noodzakelijke gegevens om de het stromen toepassing betreffende de volgende actie te begeleiden.

    note important
    IMPORTANT
    Verwijs naar ophalen de verzoek van de partnerauthentificatieAPI documentatie voor details over de informatie die in een zittingsreactie wordt verstrekt.
    Het eindpunt van de Partner van Sessies bevestigt de verzoekgegevens om ervoor te zorgen dat aan basisvoorwaarden wordt voldaan:
    • De vereiste parameters en de kopballen moeten geldig zijn.
    • De integratie tussen de opgegeven serviceProvider en mvpd moet actief zijn.
    Als de basisbevestiging ontbreekt, zal een foutenreactie worden geproduceerd, verstrekkend extra informatie die aan de Verbeterde documentatie van de Codes van de Foutvolgt.
    Het eindpunt van de Partner van Sessies bevestigt de verzoekgegevens om ervoor te zorgen dat de partner enige sign-on voorwaarden wordt voldaan aan:
    • De partner enige sign-on configuratie in de server van Adobe Pass moet geldig en toegelaten zijn.
    • De de statuslading van het partnerkader die via wordt ontvangen AP-partner-kader-statuskopbal moet geldig zijn.
    Als de partner enige sign-on bevestiging ontbreekt, zal de reactie aan de basisauthentificatiestroom in gebreke blijven.

  7. ga met besluitvormingsstromen te werk: De het eindpuntreactie van de Partner van Sessies bevat de volgende gegevens:

    • Het attribuut actionName wordt ingesteld op "authorize".
    • Het attribuut actionType wordt ingesteld op "direct".

    Als de Adobe Pass-backend een geldig profiel identificeert, hoeft de streamingtoepassing niet opnieuw te worden geverifieerd met de geselecteerde MVPD, omdat er al een profiel is dat kan worden gebruikt voor volgende beslissingsstromen.

  8. ga met basisauthentificatiestroom te werk: De het eindpuntreactie van de Partner van Sessies bevat de volgende gegevens:

    • Het kenmerk actionName wordt ingesteld op "authenticate" of "resume".
    • Het attribuut actionType wordt ingesteld op "interactive" of "direct".

    Als de Adobe Pass backend geen geldig profiel identificeert en de partner enige sign-on bevestiging ontbreekt, valt de server van Adobe Pass terug naar de basisauthentificatiestroom.

    Raadpleeg de volgende documenten voor meer informatie over de basisverificatiestroom:

  9. ga met terug profiel gebruikend de stroom van de partnerauthentificatiereactie: De het eindpuntreactie van de Partner van Sessies bevat de volgende gegevens:

    • Het attribuut actionName wordt ingesteld op "partner_profile".
    • Het attribuut actionType wordt ingesteld op "direct".
    • Het attribuut authenticationRequest - type omvat het veiligheidsprotocol dat door het partnerkader voor MVPD login wordt gebruikt (momenteel geplaatst aan SAML slechts).
    • Het attribuut authenticationRequest - request omvat het SAML- verzoek dat tot het partnerkader wordt overgegaan.
    • Het attribuut authenticationRequest - attributesNames omvat de attributen SAML die tot het partnerkader worden overgegaan.

    Als de Adobe Pass backend geen geldig profiel identificeert en de partner enige sign-on bevestiging overgaat, ontvangt de het stromen toepassing een reactie met acties en gegevens om tot het partnerkader over te gaan om de authentificatiestroom met MVPD te beginnen.

  10. Volledige authentificatie MVPD met partnerkader: door:sturen het verzoek van de partnerauthentificatie (SAML verzoek) in vorige stap aan het Video Kader van de Rekening van de Abonneewordt verkregen. Als de authentificatiestroom succesvol is, veroorzaakt de 🔗 interactie van het Kader van de Rekening van de Abonnee 0} Video met MVPD een reactie van de partnerauthentificatie (reactie van SAML) die samen met de informatie van de de statusstatus van het partnerkader is teruggekeerd.

    note important
    IMPORTANT
    Verwijs naar de 🔗 documentatie van het Kader van de Rekening van de Abonnee van 0} Video voor details op:
    • De het stromen toepassing moet toestemming controleren om totde het abonnementinformatie van de gebruiker toegang te hebben en slechts te werk te gaan als de gebruiker het toeliet.
    • De het stromen toepassing moet a afgevaardigdevoor VSAccountManager verstrekken.
    • De het stromen toepassing moet a verzoekvoor de informatie van de abonneerekening voorleggen en moet het verzoek van de partnerauthentificatie (SAML verzoek) omvatten die in vorige stap wordt verkregen.
    • De het stromen toepassing moet de meta-gegevensinformatie wachten en verwerken.
    De het stromen toepassing moet ervoor zorgen het een waarde Van Boole gelijk aan true voor het isInterruptionAllowedbezit in het VSAccountMetadataRequest voorwerp specificeert, om erop te wijzen dat de gebruiker kan worden onderbroken om met de geselecteerde leverancier van TV in deze fase voor authentiek te verklaren.

  11. de reactie van de partnerauthentificatie van de Terugkeer: De het stromen toepassing bevestigt de reactiegegevens om ervoor te zorgen dat de basisvoorwaarden worden voldaan aan:

    • De toegangsstatus van de gebruikerstoestemming wordt verleend.
    • De toewijzingsaanduiding van de gebruikersprovider is aanwezig en geldig.
    • De vervaldatum (indien beschikbaar) van het gebruikersprovider-profiel is geldig.
    • De reactie van de partnerauthentificatie (de reactie van SAML) is aanwezig en geldig.

  12. wint profiel terug gebruikend de reactie van de partnerauthentificatie: de het stromen toepassing verzamelt alle noodzakelijke gegevens om een profiel tot stand te brengen en terug te winnen door het eindpunt van de Partner van Profielen te roepen.

    note important
    IMPORTANT
    Verwijs naar terug wint profiel gebruikend de reactie van de partnerauthentificatieAPI documentatie voor details op:
    • Alle vereiste parameters, als serviceProvider, partner, en SAMLResponse
    • Alle vereiste kopballen, als Authorization, AP-Device-Identifier, Content-Type, X-Device-Info, en AP-Partner-Framework-Status
    • Alle facultatieve kopballen en parameters
    De het stromen toepassing moet ervoor zorgen het geldige waarden voor de status van het partnerkader en de reactie van de partnerauthentificatie (de reactie van SAML) omvat zodat de teruggewonnen reactie een "appleSSO"typeprofiel kan omvatten.
    Voor meer details over AP-Partner-Framework-Status kopbal, verwijs naar AP-partner-kader-statusdocumentatie.

  13. de informatie van de Terugkeer over partnerprofiel: de het eindpuntreactie van Profielen bevat informatie over het partnerprofiel, met inbegrip van de attributen type die aan "appleSSO"worden geplaatst.

    note important
    IMPORTANT
    Verwijs naar terugwinnen profiel gebruikend de reactie van de partnerauthentificatieAPI documentatie voor details op de informatie die in een profielreactie wordt verstrekt.
    Het eindpunt van de Partner van Profielen bevestigt de verzoekgegevens om ervoor te zorgen dat de basisvoorwaarden worden voldaan aan:
    • De vereiste parameters en de kopballen moeten geldig zijn.
    • De integratie tussen de opgegeven serviceProvider en mvpd moet actief zijn.
    Als de bevestiging ontbreekt, zal een foutenreactie worden geproduceerd, verstrekkend extra informatie die aan de Verbeterde documentatie van de Codes van de Foutvolgt.
    Het eindpunt van de Partner van Profielen bevestigt de verzoekgegevens om ervoor te zorgen dat de partner enige sign-on voorwaarden wordt voldaan aan:
    • De partner enige sign-on configuratie in de server van Adobe Pass moet geldig en toegelaten zijn.
    • De de statuslading van het partnerkader die via wordt ontvangen AP-partner-kader-statuskopbal moet geldig zijn.
    Als de partner enige sign-on bevestiging ontbreekt, zal de reactie aan de basisstroom van de profielherwinning in gebreke blijven.

  14. ga met besluitvormingsstromen te werk: De het stromen toepassing kan met verdere besluitvormingsstromen verdergaan.

D. Besluiten fase

  1. wint de status van het partnerkader terug: de het stromen toepassing roept het Video Kader van de Rekening van de Abonneedat door Apple wordt ontwikkeld, om gebruikerstoestemming en leveranciersinformatie te verkrijgen.

    note important
    IMPORTANT
    Verwijs naar de 🔗 documentatie van het Kader van de Rekening van de Abonnee van 0} Video voor details op:
    • De het stromen toepassing moet toestemming controleren om totde het abonnementinformatie van de gebruiker toegang te hebben en slechts te werk te gaan als de gebruiker het toeliet.
    • De het stromen toepassing moet a afgevaardigdevoor VSAccountManager verstrekken.
    • De het stromen toepassing moet a verzoekvoor de informatie van de abonneerekening voorleggen.
    • De het stromen toepassing moet de meta-gegevensinformatie wachten en verwerken.
    De streamingtoepassing moet ervoor zorgen dat deze een Booleaanse waarde opgeeft die gelijk is aan false voor de eigenschap isInterruptionAllowedin het VSAccountMetadataRequest -object, om aan te geven dat de gebruiker in deze fase niet kan worden onderbroken.
    note tip
    TIP
    Suggestie: de streamingtoepassing kan een in cache opgeslagen waarde gebruiken voor de statusinformatie van het partnerframework. We raden u aan deze waarde te vernieuwen wanneer de toepassing van achtergrond naar voorgrondstatus overgaat.

  2. de statusinformatie van het partnerkader van de Terugkeer: De het stromen toepassing bevestigt de reactiegegevens om ervoor te zorgen dat de basisvoorwaarden worden voldaan aan:

    • De toegangsstatus van de gebruikerstoestemming wordt verleend.
    • De toewijzingsaanduiding van de gebruikersprovider is aanwezig en geldig.
    • De vervaldatum (indien beschikbaar) van het gebruikersprovider-profiel is geldig.

  3. wint pre-vergunningsbesluiten terug: De het stromen toepassing verzamelt alle noodzakelijke gegevens om pre-vergunningsbesluiten voor een lijst van middelen te verkrijgen door de Besluiten te roepen preauthorize eindpunt.

    note important
    IMPORTANT
    Verwijs naar terugwinnen pre-vergunningsbesluiten gebruikend specifieke mvpdAPI documentatie voor details op:
    • Alle vereiste parameters, als serviceProvider, mvpd, en resources
    • Alle vereiste kopballen, als Authorization en AP-Device-Identifier
    • Alle facultatieve parameters en kopballen
    De streamingtoepassing moet ervoor zorgen dat deze een geldige waarde voor de partnerframestatus bevat voordat u een aanvraag verder indient, wanneer het gekozen profiel een "appleSSO"-typeprofiel is.
    Voor meer details over AP-Partner-Framework-Status kopbal, verwijs naar AP-partner-kader-statusdocumentatie.

  4. de besluiten van de Terugkeer voorafgaand aan autorisatie: De Besluiten pre-autoriseren eindpuntreactie bevat a Permit of Deny besluit voor elk middel:

    • Een Permit -beslissing betekent dat de bron kan worden afgespeeld. De reactie omvat geen media teken, aangezien de pre-vergunningsstroom niet moet worden gebruikt om middelen te spelen.
    • Een Deny -beslissing betekent dat de bron niet kan worden afgespeeld. De reactie omvat een foutenlading die aan de Verbeterde documentatie van de Codes van de Foutvolgt.
    note important
    IMPORTANT
    Verwijs naar terugwinnen pre-vergunningsbesluiten gebruikend specifieke mvpdAPI documentatie voor details over de informatie die in een besluitreactie wordt verstrekt.
    Het eindpunt van Besluiten pre-autoriseert bevestigt de verzoekgegevens om ervoor te zorgen dat de basisvoorwaarden worden voldaan:
    • De vereiste parameters en de kopballen moeten geldig zijn.
    • De integratie tussen de opgegeven serviceProvider en mvpd moet actief zijn.
    Als de bevestiging ontbreekt, zal een foutenreactie worden geproduceerd, verstrekkend extra informatie die aan de Verbeterde documentatie van de Codes van de Foutvolgt.

  5. wint de status van het partnerkader terug: de het stromen toepassing roept het Video Kader van de Rekening van de Abonneedat door Apple wordt ontwikkeld, om gebruikerstoestemming en leveranciersinformatie te verkrijgen.

    note important
    IMPORTANT
    Verwijs naar de 🔗 documentatie van het Kader van de Rekening van de Abonnee van 0} Video voor details op:
    • De het stromen toepassing moet toestemming controleren om totde het abonnementinformatie van de gebruiker toegang te hebben en slechts te werk te gaan als de gebruiker het toeliet.
    • De het stromen toepassing moet a afgevaardigdevoor VSAccountManager verstrekken.
    • De het stromen toepassing moet a verzoekvoor de informatie van de abonneerekening voorleggen.
    • De het stromen toepassing moet de meta-gegevensinformatie wachten en verwerken.
    De streamingtoepassing moet ervoor zorgen dat deze een Booleaanse waarde opgeeft die gelijk is aan false voor de eigenschap isInterruptionAllowedin het VSAccountMetadataRequest -object, om aan te geven dat de gebruiker in deze fase niet kan worden onderbroken.
    note tip
    TIP
    Suggestie: de streamingtoepassing kan een in cache opgeslagen waarde gebruiken voor de statusinformatie van het partnerframework. We raden u aan deze waarde te vernieuwen wanneer de toepassing van achtergrond naar voorgrondstatus overgaat.

  6. de statusinformatie van het partnerkader van de Terugkeer: De het stromen toepassing bevestigt de reactiegegevens om ervoor te zorgen dat de basisvoorwaarden worden voldaan aan:

    • De toegangsstatus van de gebruikerstoestemming wordt verleend.
    • De toewijzingsaanduiding van de gebruikersprovider is aanwezig en geldig.
    • De vervaldatum (indien beschikbaar) van het gebruikersprovider-profiel is geldig.

  7. wint vergunningsbesluit terug: De het stromen toepassing verzamelt alle noodzakelijke gegevens om een vergunningsbesluit voor een specifiek middel te verkrijgen door Besluiten te roepen machtigt eindpunt.

    note important
    IMPORTANT
    Verwijs naar terugwinnen vergunningsbesluiten gebruikend specifieke mvpdAPI documentatie voor details op:
    • Alle vereiste parameters, als serviceProvider, mvpd, en resources
    • Alle vereiste kopballen, als Authorization en AP-Device-Identifier
    • Alle facultatieve parameters en kopballen
    De streamingtoepassing moet ervoor zorgen dat deze een geldige waarde voor de partnerframestatus bevat voordat u een aanvraag verder indient, wanneer het gekozen profiel een "appleSSO"-typeprofiel is.
    Voor meer details over AP-Partner-Framework-Status kopbal, verwijs naar AP-partner-kader-statusdocumentatie.

  8. de vergunningsbesluit van de Terugkeer: De Besluiten machtigen eindpuntreactie bevat a Permit of Deny besluit voor het specifieke middel:

    • Een Permit -beslissing betekent dat de bron kan worden afgespeeld. De reactie bevat een media-token.
    • Een Deny -beslissing betekent dat de bron niet kan worden afgespeeld. De reactie omvat een foutenlading die aan de Verbeterde documentatie van de Codes van de Foutvolgt.
    note important
    IMPORTANT
    Verwijs naar terugwinnen vergunningsbesluiten gebruikend specifieke mvpdAPI documentatie voor details over de informatie die in een besluitreactie wordt verstrekt.
    De Besluiten machtigen eindpunt bevestigt de verzoekgegevens om ervoor te zorgen dat de basisvoorwaarden worden voldaan:
    • De vereiste parameters en de kopballen moeten geldig zijn.
    • De integratie tussen de opgegeven serviceProvider en mvpd moet actief zijn.
    Als de bevestiging ontbreekt, zal een foutenreactie worden geproduceerd, verstrekkend extra informatie die aan de Verbeterde documentatie van de Codes van de Foutvolgt.
D. Afmeldingsfase

  1. stelt Adobe Pass logout in werking: de het stromen toepassing verzamelt alle noodzakelijke gegevens om de logout stroom in werking te stellen door het de Logout van Adobe Pass eindpunt te roepen.

    note important
    IMPORTANT
    Verwijs naar Logout van het Begin voor specifieke mvpdAPI documentatie voor details op:
    • Alle vereiste parameters, als serviceProvider, mvpd, en redirectUrl
    • Alle vereiste kopballen, als Authorization, AP-Device-Identifier
    • Alle facultatieve parameters en kopballen

  2. wijs op de volgende actie: De het eindpuntreactie van het Logout van Adobe Pass bevat de noodzakelijke gegevens om de het stromen toepassing betreffende de volgende actie te begeleiden.

    note important
    IMPORTANT
    Verwijs naar Logout van het Begin voor specifieke mvpdAPI documentatie voor details op de informatie die in een logout reactie wordt verstrekt.
    Het Adobe Pass Logout eindpunt valideert de verzoekgegevens om ervoor te zorgen dat de basisvoorwaarden worden voldaan:
    • De vereiste parameters en de kopballen moeten geldig zijn.
    • De integratie tussen de opgegeven serviceProvider en mvpd moet actief zijn.
    Als de bevestiging ontbreekt, zal een foutenreactie worden geproduceerd, verstrekkend extra informatie die aan de Verbeterde documentatie van de Codes van de Foutvolgt.
    note important
    IMPORTANT
    De het stromen toepassing moet ervoor zorgen het op de gebruiker wijst om zich van partnerniveau verder uit te melden.
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b