Apple SSO Cookbook (REST API V2) apple-sso-cookbook-rest-api-v2
Adobe Pass Authentication REST API V2 har stöd för enkel inloggning (SSO) för slutanvändare av klientprogram som körs på iOS, iPadOS eller tvOS.
Det här dokumentet fungerar som ett tillägg till den befintliga REST API V2-översikten som ger en högnivåvy och det dokument som beskriver hur du implementerar enkel inloggning med partnerflöden.
Apple enkel inloggning med partnerflöden cookbook
Förutsättningar prerequisites
Innan du fortsätter med Apple enkel inloggning med partnerflöden måste du kontrollera att följande krav är uppfyllda:
-
Strömningsprogrammet måste samla in alla nödvändiga data som krävs av rubrikerna
X-Device-Infooch/ellerUser-Agentså att Adobe Pass Authentication-backend kan identifiera enhetsplattformen och dess funktioner. Mer information om rubrikenX-Device-Infofinns i X-Device-Info -dokumentationen. -
Strömningsprogrammet måste begära åtkomst till användarens prenumerationsinformation som sparats på enhetsnivå, och användaren måste ge programmet behörighet att fortsätta, på samma sätt som att ge åtkomst till enhetens kamera eller mikrofon. Den här behörigheten måste begäras per program med Apple Video Subscriber Account Framework och enheten sparar användarens val.
Vi rekommenderar att du uppmuntrar användare som vägrar ge åtkomst till prenumerationsinformation genom att förklara fördelarna med Apple användarupplevelse med enkel inloggning, men tänk på att användaren kan ändra sitt beslut genom att gå till programinställningarna (behörighet för TV-leverantör) eller till
Settings -> TV Providerpå iOS och iPadOS ellerSettings -> Accounts -> TV Providerpå tvOS.Strömningsprogrammet kan begära användarens tillstånd när programmet försätts i förgrundstillstånd, eftersom programmet när som helst kan kontrollera behörighet att komma åt användarens prenumerationsinformation innan användarautentisering krävs.
- Strömningsprogrammet har slutfört de startkrav som gäller för en programmerare och som krävs för att aktivera Apple Single Sign-On-användarupplevelsen.
Arbetsflöde workflow
Utför de angivna stegen för att implementera enkel inloggning från Apple med partnerflöden enligt bilden nedan.
Apple enkel inloggning med partnerflöden
-
Hämta klientautentiseringsuppgifter: Direktuppspelningsprogrammet samlar in alla nödvändiga data för att hämta klientautentiseringsuppgifter genom att anropa slutpunkten för klientregistret.
note important IMPORTANT Mer information om följande finns i Hämta klientautentiseringsuppgifter API-dokumentationen: - Alla obligatoriska-parametrar, som
software_statement - Alla obligatoriska rubriker, som
Content-Type,X-Device-Info - Alla valfria parametrar och rubriker
- Alla obligatoriska-parametrar, som
-
Returnera klientautentiseringsuppgifter: Svaret på klientregisterslutpunkten innehåller information om klientautentiseringsuppgifterna som är associerade med de mottagna parametrarna och rubrikerna.
note important IMPORTANT Mer information om vilken information som ges i ett svar på klientautentiseringsuppgifter finns i Hämta klientautentiseringsuppgifter API-dokumentationen. Klientregistret 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 Hämta klientautentiseringsuppgifter API-dokumentationen. note tip TIP Klientens autentiseringsuppgifter måste cachelagras och användas i oändlighet. -
Hämta åtkomsttoken: Direktuppspelningsprogrammet samlar in alla data som behövs för att hämta åtkomsttoken genom att anropa klienttokenslutpunkten.
note important IMPORTANT Mer information om följande finns i Hämta åtkomsttoken API-dokumentationen: - Alla obligatoriska-parametrar, som
client_id,client_secretochgrant_type - Alla obligatoriska rubriker, som
Content-Type,X-Device-Info - Alla valfria parametrar och rubriker
- Alla obligatoriska-parametrar, som
-
Returåtkomsttoken: Slutpunktssvaret för klienttoken innehåller information om åtkomsttoken som är associerad med de mottagna parametrarna och rubrikerna.
note important IMPORTANT Mer information om vilken information som ges i ett åtkomsttoken-svar finns i Hämta åtkomsttoken API-dokumentationen. Klienttoken validerar data för 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 Hämta åtkomsttoken API-dokumentationen. note tip TIP Åtkomsttoken måste cachelagras och användas endast inom den angivna varaktigheten (t.ex. 24 timmars time-to-live). När direktuppspelningsprogrammet har upphört att gälla måste det begära en ny åtkomsttoken.
-
Hämta partnerramverkets status: Direktuppspelningsprogrammet anropar Video Subscriber Account Framework som utvecklats av Apple för att få användarbehörighet och providerinformation.
note important IMPORTANT Mer information finns i dokumentationen för Video Subscriber Account Framework: - Direktuppspelningsprogrammet måste kontrollera behörighet att komma åt användarens prenumerationsinformation och fortsätta endast om användaren tillåter det.
- Strömningsprogrammet måste tillhandahålla en delegat för
VSAccountManager. - Strömningsprogrammet måste skicka en begäran för prenumerantkontoinformation.
- Direktuppspelningsprogrammet måste vänta och bearbeta metadata-informationen.
Strömningsprogrammet måste se till att det anger ett booleskt värde som är lika med falseför egenskapenisInterruptionAllowedi objektetVSAccountMetadataRequest, vilket anger att användaren inte kan avbrytas i den här fasen. -
Returnera statusinformation för partnerramverket: Direktuppspelningsprogrammet validerar svarsdata för att säkerställa att grundläggande villkor uppfylls:
- Åtkomststatus för användarbehörighet beviljas.
- Mappningsidentifieraren för användarprovidern finns och är giltig.
- Användarleverantörsprofilens förfallodatum (om tillgängligt) är giltigt.
-
Hämta profiler: Direktuppspelningsprogrammet samlar in alla nödvändiga data för att hämta all profilinformation genom att skicka en begäran till profilslutpunkten.
note important IMPORTANT Mer information om följande finns i Hämta profiler API-dokumentationen: - Alla obligatoriska-parametrar, som
serviceProvider - Alla obligatoriska rubriker, som
Authorization,AP-Device-IdentifierochAP-Partner-Framework-Status - Alla valfria parametrar och rubriker
Strömningsprogrammet måste se till att det innehåller ett giltigt värde för partnerramverkets status så att det hämtade svaret kan innehålla en AppleSSO-typprofil. Mer information om rubriken AP-Partner-Framework-Statusfinns i dokumentationen för AP-Partner-Framework-Status. - Alla obligatoriska-parametrar, som
-
Returnera information om hittade profiler: Profilernas slutpunktssvar innehåller information om de hittade profiler som är associerade med de mottagna parametrarna och rubrikerna.
-
Välj en profil och fortsätt med beslutsflöden: Om slutpunktssvaret för profiler innehåller profiler använder direktuppspelningsprogrammet sin interna logik (genom att till slut interagera med slutanvändaren) för att välja en av de tillgängliga profilerna för att fortsätta med efterföljande beslutsflöden.
-
Fortsätt med partnerautentiseringsflödet: Om slutpunktssvaret för profiler inte innehåller någon profil fortsätter direktuppspelningsprogrammet med partnerautentiseringsflödet.
-
Hämta konfiguration: Direktuppspelningsprogrammet samlar in alla nödvändiga data för att hämta listan över MVPD-filer som har en aktiv integrering genom att skicka en begäran till Configuration-slutpunkten.
note important IMPORTANT Mer information om följande finns i Hämta konfiguration för specifik API-dokumentation för tjänstprovidern: - Alla obligatoriska-parametrar, som
serviceProvider - Alla obligatoriska rubriker, som
Authorization,AP-Device-IdentifierochX-Device-Info - Alla valfria parametrar och rubriker
- Alla obligatoriska-parametrar, som
-
Returkonfiguration: Konfigurationsslutpunktssvaret innehåller information om de MVPD-filer som har en aktiv integrering med tjänstprovidern.
note important IMPORTANT Mer information om informationen som tillhandahålls i ett konfigurationssvar finns i Hämta konfiguration för specifik API-dokumentation för tjänstleverantör. Konfigurationsslutpunkten 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. note important IMPORTANT Strömningsprogrammet måste se till att följande information för varje MVPD bearbetas när du fortsätter: enablePlatformServices: Anger om MVPD har stöd för enkel inloggning från Apple.displayInPlatformPicker: Anger om MVPD kan visas i Apple-väljaren.boardingStatus: Anger om MVPD har registrerats i Apple Single Sign-on.
-
Hämta partnerramverkets status: Direktuppspelningsprogrammet anropar Video Subscriber Account Framework som utvecklats av Apple för att få användarbehörighet och providerinformation.
note important IMPORTANT Mer information finns i dokumentationen för Video Subscriber Account Framework: - Direktuppspelningsprogrammet måste kontrollera behörighet att komma åt användarens prenumerationsinformation och fortsätta endast om användaren tillåter det.
- Strömningsprogrammet måste tillhandahålla en delegat för
VSAccountManager. - Strömningsprogrammet måste skicka en begäran för prenumerantkontoinformation.
- Direktuppspelningsprogrammet måste vänta och bearbeta metadata-informationen.
Strömningsprogrammet måste se till att det anger ett booleskt värde som är lika med trueför egenskapenisInterruptionAllowedi objektetVSAccountMetadataRequest, vilket anger att användaren kan avbrytas för att välja TV-leverantör i den här fasen. -
Returnera statusinformation för partnerramverket: Direktuppspelningsprogrammet validerar svarsdata för att säkerställa att grundläggande villkor uppfylls:
- Åtkomststatus för användarbehörighet beviljas.
- Mappningsidentifieraren för användarprovidern finns och är giltig.
- Användarleverantörsprofilens förfallodatum (om tillgängligt) är giltigt.
-
Hämta partnerautentiseringsbegäran: Direktuppspelningsprogrammet samlar in alla nödvändiga data för att initiera en autentiseringssession genom att anropa Sessions-partnerslutpunkten.
note important IMPORTANT Mer information om följande finns i Hämta API-dokumentationen för partnerautentiseringsbegäran: - Alla obligatoriska-parametrar, som
serviceProviderochpartner - Alla obligatoriska rubriker som
Authorization,AP-Device-Identifier,Content-Type,X-Device-InfoochAP-Partner-Framework-Status - Alla valfria rubriker och parametrar
Strömningsprogrammet måste se till att det innehåller ett giltigt värde för partnerramverkets status så att det hämtade svaret kan innehålla en begäran om partnerautentisering (SAML-begäran). Mer information om rubriken AP-Partner-Framework-Statusfinns i dokumentationen för AP-Partner-Framework-Status. - Alla obligatoriska-parametrar, som
-
Ange nästa åtgärd: Sessions-partnerns slutpunktssvar innehåller de data som krävs för att vägleda direktuppspelningsprogrammet angående nästa åtgärd.
note important IMPORTANT Mer information om vilken information som finns i ett sessionssvar finns i Hämta API-dokumentationen för partnerautentiseringsbegäran. Slutpunkten för Sessions-partnern validerar data för 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
serviceProviderochmvpdmåste vara aktiv.
Om den grundläggande valideringen misslyckas genereras ett felsvar som ger ytterligare information som följer dokumentationen för Förbättrade felkoder. Slutpunkten för Sessions-partnern verifierar data för begäran för att säkerställa att villkoren för enkel inloggning för partner uppfylls: - Partnerkonfigurationen för enkel inloggning på Adobe Pass-servern måste vara giltig och aktiverad.
- Statusnyttolasten för partnerramverket som togs emot via rubriken AP-Partner-Framework-Status måste vara giltig.
Om partnervalideringen för enkel inloggning misslyckas, används standardvärdet för det grundläggande autentiseringsflödet. -
Fortsätt med beslutsflöden: Sessionspartnerns 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.
- Attributet
-
Fortsätt med grundläggande autentiseringsflöde: Sessions-partnerns slutpunktssvar innehåller följande data:
- Attributet
actionNameär inställt på antingen "authenticate" eller "resume". - Attributet
actionTypeär inställt på antingen "interaktiv" eller "direct".
Om Adobe Pass serverdel inte kan identifiera en giltig profil och partnerverifieringen för enkel inloggning misslyckas, återgår Adobe Pass-servern till det grundläggande autentiseringsflödet.
Mer information om det grundläggande autentiseringsflödet finns i följande dokument:
- Attributet
-
Fortsätt med att skapa och hämta profil med hjälp av svarsflöde för partnerautentisering: Sessionernas partnersvar innehåller följande data:
- Attributet
actionNameär inställt på "partner_profile". - Attributet
actionTypeär inställt på"direct". - Attributet
authenticationRequest - typeinnehåller säkerhetsprotokollet som används av partnerramverket för MVPD-inloggning (som för närvarande endast är inställt på SAML). - Attributet
authenticationRequest - requestinnehåller SAML-begäran som skickas till partnerramverket. - Attributet
authenticationRequest - attributesNamesinnehåller de SAML-attribut som skickas till partnerramverket.
Om Adobe Pass-serverdelen inte identifierar en giltig profil och partnervalideringen för enkel inloggning godkänns, får direktuppspelningsprogrammet ett svar med åtgärder och data som skickas till partnerramverket för att starta autentiseringsflödet med MVPD.
- Attributet
-
Fullständig MVPD-autentisering med partnerramverket: Vidarebefordra partnerautentiseringsbegäran (SAML-begäran) som hämtades i föregående steg till Video Subscriber Account Framework. Om autentiseringsflödet lyckas skapar Video Subscriber Account Framework-interaktionen med MVPD ett partnerautentiseringssvar (SAML-svar) som returneras tillsammans med partnerramverkets statusinformation.
note important IMPORTANT Mer information finns i dokumentationen för Video Subscriber Account Framework: - Direktuppspelningsprogrammet måste kontrollera behörighet att komma åt användarens prenumerationsinformation och fortsätta endast om användaren tillåter det.
- Strömningsprogrammet måste tillhandahålla en delegat för
VSAccountManager. - Strömningsprogrammet måste skicka en begäran för prenumerantkontoinformation och måste innehålla partnerautentiseringsbegäran (SAML-begäran) som hämtades i föregående steg.
- Direktuppspelningsprogrammet måste vänta och bearbeta metadata-informationen.
Strömningsprogrammet måste se till att det anger ett booleskt värde som är lika med trueför egenskapenisInterruptionAllowedi objektetVSAccountMetadataRequest, vilket anger att användaren kan avbrytas för att autentisera med den valda TV-leverantören i den här fasen. -
Retursvar på partnerautentisering: Direktuppspelningsprogrammet validerar svarsdata för att säkerställa att grundläggande villkor uppfylls:
- Åtkomststatus för användarbehörighet beviljas.
- Mappningsidentifieraren för användarprovidern finns och är giltig.
- Användarleverantörsprofilens förfallodatum (om tillgängligt) är giltigt.
- SAML-svar (Partner Authentication Response) finns och är giltigt.
-
Skapa och hämta profil med partnerautentiseringssvar: Direktuppspelningsprogrammet samlar in alla nödvändiga data för att skapa och hämta en profil genom att anropa slutpunkten för Profiles Partner.
note important IMPORTANT Mer information om hur du gör det finns i Skapa och hämta profil med API-dokumentationen för partnerautentiseringssvar: - Alla obligatoriska-parametrar, som
serviceProvider,partnerochSAMLResponse - Alla obligatoriska-huvuden, som
Authorization,AP-Device-Identifier,Content-Type,X-Device-InfoochAP-Partner-Framework-Status - Alla valfria rubriker och parametrar
Strömningsprogrammet måste se till att det innehåller giltiga värden för partnerramverkets status och partnerautentiseringssvaret (SAML-svar) så att det hämtade svaret kan innehålla en AppleSSO-typprofil. Mer information om rubriken AP-Partner-Framework-Statusfinns i dokumentationen för AP-Partner-Framework-Status. - Alla obligatoriska-parametrar, som
-
Returinformation om partnerprofil: Profilernas slutpunktssvar innehåller information om partnerprofilen, inklusive attributet
typesom är inställt på "appleSSO".note important IMPORTANT Mer information om vilken information som ges i ett profilsvar finns i Skapa och hämta profil med API-dokumentationen för partnerautentiseringssvar. Profiles Partner-slutpunkten verifierar data för 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
serviceProviderochmvpdmåste vara aktiv.
Om valideringen misslyckas genereras ett felsvar som ger ytterligare information som följer dokumentationen för Förbättrade felkoder. Profiles Partner-slutpunkten verifierar data för begäran för att säkerställa att villkoren för enkel inloggning för partner uppfylls: - Partnerkonfigurationen för enkel inloggning på Adobe Pass-servern måste vara giltig och aktiverad.
- Statusnyttolasten för partnerramverket som togs emot via rubriken AP-Partner-Framework-Status måste vara giltig.
Om valideringen av enkel inloggning från partner misslyckas, används standardvärdet för det grundläggande flödet för hämtning av profiler. -
Fortsätt med beslutsflöden: Direktuppspelningsprogrammet kan fortsätta med efterföljande beslutsflöden.
-
Hämta partnerramverkets status: Direktuppspelningsprogrammet anropar Video Subscriber Account Framework som utvecklats av Apple för att få användarbehörighet och providerinformation.
note important IMPORTANT Strömningsprogrammet kan hoppa över det här steget om den valda användarprofiltypen inte är "appleSSO". note important IMPORTANT Mer information finns i dokumentationen för Video Subscriber Account Framework: - Direktuppspelningsprogrammet måste kontrollera behörighet att komma åt användarens prenumerationsinformation och fortsätta endast om användaren tillåter det.
- Strömningsprogrammet måste tillhandahålla en delegat för
VSAccountManager. - Strömningsprogrammet måste skicka en begäran för prenumerantkontoinformation.
- Direktuppspelningsprogrammet måste vänta och bearbeta metadata-informationen.
Strömningsprogrammet måste se till att det anger ett booleskt värde som är lika med falseför egenskapenisInterruptionAllowedi objektetVSAccountMetadataRequest, vilket anger att användaren inte kan avbrytas i den här fasen.note tip TIP Direktuppspelningsprogrammet kan i stället använda ett cachelagrat värde för partnerramverkets statusinformation, som vi rekommenderar att du uppdaterar när programmet övergår från bakgrund till förgrundstillstånd. I så fall måste direktuppspelningsprogrammet se till att det cachelagrar och endast använder giltiga värden för partnerramverkets status enligt beskrivningen i steget"Returnera partnerramverkets statusinformation". -
Returnera statusinformation för partnerramverket: Direktuppspelningsprogrammet validerar svarsdata för att säkerställa att grundläggande villkor uppfylls:
- Åtkomststatus för användarbehörighet beviljas.
- Mappningsidentifieraren för användarprovidern finns och är giltig.
- Användarleverantörsprofilens förfallodatum är giltigt.
note important IMPORTANT Strömningsprogrammet kan hoppa över det här steget om den valda användarprofiltypen inte är "appleSSO". -
Hämta förauktoriseringsbeslut: Direktuppspelningsprogrammet samlar in alla nödvändiga data för att erhålla förauktoriseringsbeslut för en lista med resurser genom att anropa slutpunkten för förauktorisering av beslut.
note important IMPORTANT Se Hämta beslut om förhandsauktorisering med hjälp av specifik mvpd API-dokumentation för mer information om: - Alla obligatoriska-parametrar, som
serviceProvider,mvpdochresources - Alla obligatoriska rubriker, som
AuthorizationochAP-Device-Identifier - Alla valfria parametrar och rubriker
Direktuppspelningsprogrammet måste se till att det innehåller ett giltigt värde för partnerramverkets status innan en begäran görs vidare, när den valda profilen är en AppleSSO-typprofil. Det här steget kan dock hoppas över om den valda användarprofiltypen inte är "appleSSO". Mer information om rubriken AP-Partner-Framework-Statusfinns i dokumentationen för AP-Partner-Framework-Status. - Alla obligatoriska-parametrar, som
-
Returbeslut om förauktorisering: Slutpunktssvaret för förauktorisering av beslut innehåller ett
Permit- ellerDeny-beslut för varje resurs:- Ett
Permit-beslut betyder att resursen kan spelas upp. Svaret innehåller ingen medietoken eftersom förauktoriseringsflödet inte får användas för att spela upp resurser. - Ett
Deny-beslut betyder att resursen inte kan spelas upp. Svaret innehåller en felnyttolast som följer dokumentationen för Förbättrade felkoder.
note important IMPORTANT Mer information om vilken information som ges i ett beslutssvar finns i Hämta förhandsauktoriseringsbeslut med hjälp av specifik mvpd API-dokumentation. Slutpunkten för förauktorisering av beslut validerar data för 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
serviceProviderochmvpdmåste vara aktiv.
Om valideringen misslyckas genereras ett felsvar som ger ytterligare information som följer dokumentationen för Förbättrade felkoder. - Ett
-
Hämta partnerramverkets status: Direktuppspelningsprogrammet anropar Video Subscriber Account Framework som utvecklats av Apple för att få användarbehörighet och providerinformation.
note important IMPORTANT Strömningsprogrammet kan hoppa över det här steget om den valda användarprofiltypen inte är "appleSSO". note important IMPORTANT Mer information finns i dokumentationen för Video Subscriber Account Framework: - Direktuppspelningsprogrammet måste kontrollera behörighet att komma åt användarens prenumerationsinformation och fortsätta endast om användaren tillåter det.
- Strömningsprogrammet måste tillhandahålla en delegat för
VSAccountManager. - Strömningsprogrammet måste skicka en begäran för prenumerantkontoinformation.
- Direktuppspelningsprogrammet måste vänta och bearbeta metadata-informationen.
Strömningsprogrammet måste se till att det anger ett booleskt värde som är lika med falseför egenskapenisInterruptionAllowedi objektetVSAccountMetadataRequest, vilket anger att användaren inte kan avbrytas i den här fasen.note tip TIP Direktuppspelningsprogrammet kan i stället använda ett cachelagrat värde för partnerramverkets statusinformation, som vi rekommenderar att du uppdaterar när programmet övergår från bakgrund till förgrundstillstånd. I så fall måste direktuppspelningsprogrammet se till att det cachelagrar och endast använder giltiga värden för partnerramverkets status enligt beskrivningen i steget"Returnera partnerramverkets statusinformation". -
Returnera statusinformation för partnerramverket: Direktuppspelningsprogrammet validerar svarsdata för att säkerställa att grundläggande villkor uppfylls:
- Åtkomststatus för användarbehörighet beviljas.
- Mappningsidentifieraren för användarprovidern finns och är giltig.
- Användarleverantörsprofilens förfallodatum är giltigt.
note important IMPORTANT Strömningsprogrammet kan hoppa över det här steget om den valda användarprofiltypen inte är "appleSSO". -
Hämta auktoriseringsbeslut: Direktuppspelningsprogrammet samlar in alla nödvändiga data för att erhålla ett auktoriseringsbeslut för en specifik resurs genom att anropa auktoriseringsslutpunkten för beslut.
note important IMPORTANT Mer information om följande finns i Hämta auktoriseringsbeslut med hjälp av specifik API-dokumentation för mvpd: - Alla obligatoriska-parametrar, som
serviceProvider,mvpdochresources - Alla obligatoriska rubriker, som
AuthorizationochAP-Device-Identifier - Alla valfria parametrar och rubriker
Direktuppspelningsprogrammet måste se till att det innehåller ett giltigt värde för partnerramverkets status innan en begäran görs vidare, när den valda profilen är en AppleSSO-typprofil. Det här steget kan dock hoppas över om den valda användarprofiltypen inte är "appleSSO". Mer information om rubriken AP-Partner-Framework-Statusfinns i dokumentationen för AP-Partner-Framework-Status. - Alla obligatoriska-parametrar, som
-
Beslut om returauktorisering: Slutpunktssvaret för auktorisering av beslut innehåller ett
Permit- ellerDeny-beslut för den specifika resursen:- Ett
Permit-beslut betyder att resursen kan spelas upp. Svaret innehåller en medietoken. - Ett
Deny-beslut betyder att resursen inte kan spelas upp. Svaret innehåller en felnyttolast som följer dokumentationen för Förbättrade felkoder.
note important IMPORTANT Mer information om vilken information som ges i ett beslutssvar finns i Hämta auktoriseringsbeslut med hjälp av specifik mvpd API-dokumentation. Slutpunkten för beslutsauktorisering validerar data för 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
serviceProviderochmvpdmåste vara aktiv.
Om valideringen misslyckas genereras ett felsvar som ger ytterligare information som följer dokumentationen för Förbättrade felkoder. - Ett
-
Initiera Adobe Pass-utloggning: Direktuppspelningsprogrammet samlar in alla data som behövs för att initiera utloggningsflödet genom att anropa Adobe Pass utloggningsslutpunkt.
note important IMPORTANT Mer information om hur du använder API-dokumentationen för mvpd🔗 finns i Initiera utloggning: - Alla obligatoriska-parametrar, som
serviceProvider,mvpdochredirectUrl - Alla obligatoriska rubriker, som
Authorization,AP-Device-Identifier - Alla valfria parametrar och rubriker
- Alla obligatoriska-parametrar, som
-
Ange nästa åtgärd: Slutpunktssvaret för Adobe Pass-utloggningen innehåller de data som krävs för att vägleda direktuppspelningsprogrammet angående nästa åtgärd:
- Attributet
urlsaknas eftersom användaren måste interagera med partnernivån (systemnivån) för att slutföra utloggningsflödet. - Attributet
actionNameär inställt på "partner_logOut". - Attributet
actionTypeär inställt på "partner_interactive".
note important IMPORTANT Strömningsprogrammet måste uppmana användaren att slutföra utloggningsprocessen på partnernivå, enligt attributen actionNameochactionType, när den borttagna användarprofiltypen är AppleSSO.note important IMPORTANT Mer information om vilken information som ges i ett utloggningssvar finns i Initiera utloggning för specifik mvpd API-dokumentation. Adobe Pass utloggningsslutpunkt 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
serviceProviderochmvpdmåste vara aktiv.
Om valideringen misslyckas genereras ett felsvar som ger ytterligare information som följer dokumentationen för Förbättrade felkoder. - Attributet