DokumentationAdobe PassAdobe Pass-autentisering

Grundläggande autentiseringsflöde som utförs i det primära programmet basic-authentication-flow-performed-within-primary-application

Last update: Mon Apr 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
Innehållet på den här sidan tillhandahålls endast i informationssyfte. Användning av denna API kräver en aktuell licens från Adobe. Ingen obehörig användning är tillåten.
IMPORTANT
REST API V2-implementeringen begränsas av dokumentationen för begränsningsmekanismen.
Related Articles
Gå även till REST API V2 FAQ.

Autentiseringsflödet i Adobe Pass-autentiseringsberättigandet gör att direktuppspelningsprogrammet kan verifiera att en användare har ett giltigt MVPD-konto. Den här processen kräver att användaren har ett aktivt MVPD-konto och anger giltiga inloggningsuppgifter på inloggningssidan för MVPD.

Autentiseringsflöde krävs i följande fall:

  • När användaren öppnar ett program för första gången.
  • När användarens tidigare autentisering har upphört att gälla.
  • När användaren loggar ut från MVPD-kontot.
  • När användaren vill autentisera med en annan MVPD.

I alla dessa fall får programmet som anropar någon av profilslutpunkterna ett tomt svar eller en eller flera profiler, men för olika programmeringsvideofilmsprogram.

Autentiseringsflödet kräver att en användaragent (webbläsare) slutför en serie samtal från programmet till Adobe Pass, sedan till inloggningssidan för MVPD och slutligen tillbaka till programmet. Det här flödet kan omfatta flera omdirigeringar till MVPD-system och hantering av cookies eller sessioner som lagras för varje domän, vilket kan vara en utmaning att uppnå och skydda utan användaragent.

Autentiseringsscenarierna är följande, baserat på de primära funktionerna (för direktuppspelning av program) som stöder användarinteraktion för att välja en MVPD och autentisera med den valda MVPD i en användaragent:

Utför autentisering i det primära programmet perform-authentication-within-primary-application

Förutsättningar prerequisites-perform-authentication-within-primary-application

Innan du utför autentisering genom användarinteraktion i ett primärt program måste du kontrollera att följande krav är uppfyllda:

  • Strömningsprogrammet måste välja en MVPD.
  • Strömningsprogrammet måste initiera en autentiseringssession för att kunna logga in med den valda MVPD.
  • Direktuppspelningsprogrammet måste autentisera med den valda MVPD i en användaragent.
IMPORTANT
Antaganden
  • Strömningsprogrammet stöder användarinteraktion för att välja en MVPD.
  • Strömningsprogrammet har stöd för användarinteraktion för autentisering med den valda MVPD i en användaragent.

Arbetsflöde workflow-perform-authentication-completed-on-primary-application

Följ de angivna stegen för att implementera det grundläggande autentiseringsflödet som utförs i ett primärt program enligt bilden nedan.

Utför autentisering i det primära programmet

Utför autentisering i det primära programmet

  1. Skapa autentiseringssession: Direktuppspelningsprogrammet samlar in alla data som behövs för att initiera en autentiseringssession genom att anropa sessionens slutpunkt.

    note important
    IMPORTANT
    Mer information om hur du gör det finns i API-dokumentationen för Skapa autentiseringssession:
    • Alla obligatoriska-parametrar, som serviceProvider, mvpd, domainName och redirectUrl
    • Alla obligatoriska rubriker, som Authorization, AP-Device-Identifier
    • Alla valfria parametrar och rubriker
    Direktuppspelningsprogrammet måste tillhandahålla alla nödvändiga parametrar i ett enda anrop när autentiseringssessionen skapas.

  2. Ange nästa åtgärd: Sessionernas slutpunktssvar innehåller de data som behövs för att vägleda direktuppspelningsprogrammet när det gäller nästa åtgärd.

    note important
    IMPORTANT
    Mer information om vilken information som finns i ett sessionssvar finns i API-dokumentationen för Skapa autentiseringssession.
    Sessionernas slutpunkt validerar data i begäran för att säkerställa att de grundläggande villkoren uppfylls:
    • Parametrarna och rubrikerna required måste vara giltiga.
    • Integrationen mellan angiven serviceProvider och mvpd måste vara aktiv.
    Om valideringen misslyckas genereras ett felsvar som ger ytterligare information som följer dokumentationen för Förbättrade felkoder.

  3. Fortsätt med beslutsflöden: Sessionernas slutpunktssvar innehåller följande data:

    • Attributet actionName är inställt på"auktorisera".
    • Attributet actionType är inställt på"direct".

    Om Adobe Pass serverdel identifierar en giltig profil behöver direktuppspelningsprogrammet inte autentisera igen med den valda MVPD eftersom det redan finns en profil som kan användas för efterföljande beslutsflöden.

  4. Öppna URL i användaragent: Sessionernas slutpunktssvar innehåller följande data:

    • url som kan användas för att initiera den interaktiva autentiseringen på inloggningssidan för MVPD.
    • Attributet actionName är inställt på "authenticate".
    • Attributet actionType är inställt på "interactive".

    Om Adobe Pass serverdel inte identifierar en giltig profil, öppnar direktuppspelningsprogrammet en användaragent för att läsa in url, vilket gör en begäran till slutpunkten för autentisering. Det här flödet kan innehålla flera omdirigeringar, vilket i slutänden leder till inloggningssidan för MVPD och anger giltiga inloggningsuppgifter.

  5. Fullständig MVPD-autentisering: Om autentiseringsflödet lyckas sparar användaragentinteraktionen en vanlig profil i Adobe Pass serverdel och når den angivna redirectUrl.

  6. Hämta profil för specifik kod: Direktuppspelningsprogrammet samlar in alla nödvändiga data för att hämta profilinformation genom att skicka en begäran till profilslutpunkten.

    note important
    IMPORTANT
    Mer information om följande finns i Hämta profil för specifik API-dokumentation för koden:
    • Alla obligatoriska-parametrar, som serviceProvider, code
    • Alla obligatoriska rubriker, som Authorization, AP-Device-Identifier
    • Alla valfria parametrar och rubriker
    note tip
    TIP
    Direktuppspelningsprogrammet måste vänta tills användaragenten når den angivna redirectUrl för att kontrollera om den reguljära profilen har genererats och sparats.

  7. Returinformation om vanlig profil: Profilernas slutpunktssvar innehåller information om den vanliga profil som är associerad med de mottagna parametrarna och rubrikerna.

    note important
    IMPORTANT
    Mer information om vilken information som ges i ett profilsvar finns i Hämta profil för specifik kod API-dokumentation.
    Profilens slutpunkt validerar data i begäran för att säkerställa att de grundläggande villkoren uppfylls:
    • Parametrarna och rubrikerna required måste vara giltiga.
    Om valideringen misslyckas genereras ett felsvar som ger ytterligare information som följer dokumentationen för Förbättrade felkoder.
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b