Apple SSO - översikt apple-sso-overview

NOTE
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.

Introduktion Introduction

Apple tillhandahåller ett API som gör att man kan logga in på sitt TV-leverantörskonto på enhetssystemnivå, vilket eliminerar behovet av att autentisera appvis.

Apple och Adobe Pass Authentication samarbetade därför för att skapa plattformen Single Sign-On (SSO) för användare i TV Everywhere-ekosystemet för iPhone-, iPad- och Apple TV-ägare.

För att kunna dra nytta av SSO-användarupplevelsen (Single Sign-On) på en Apple-enhet finns det en lista över krav som måste uppfyllas.

Förutsättningar Prerequisites

Förutsättningen kan gälla för en eller flera enheter som deltar i TVE-verksamheten, t.ex. programmerare, distributörer av videoprogrammeringstjänster, Adobe Pass-autentisering eller Apple.

Programmer Programmer

För att kunna dra nytta av SSO-användarupplevelsen (Single Sign-On) måste en programmerare

  1. Använd minst Xcode version 8 och iOS/tvOS version 10.

  2. Låt Video-prenumerantens Single Sign-On-berättigande konfigureras till deras Apple Developer Account. Kontakta Apple för att aktivera ramverket för videoprenumerantkonto för ditt Apple Team-ID.

  3. Aktivera enkel inloggning (YES) för varje önskad integrering (Channel x MVPD) och önskad plattform (iOS/tvOS) via Adobe Primetime TVE Dashboard.

  4. Integrera Apple SSO-arbetsflöden med någon av följande två lösningar från Adobe Pass Authentication Team:

    • Adobe Pass Authentication REST API har stöd för plattformsautentisering med enkel inloggning (SSO) för slutanvändare av klientprogram som körs på iOS, iPadOS eller tvOS. Se även Apple SSO Cookbook (REST API).

    • Adobe Pass Authentication AccessEnabler iOS/tvOS SDK har stöd för plattformsautentisering med enkel inloggning (SSO) för slutanvändare av klientprogram som körs på iOS, iPadOS eller tvOS. Se även Apple SSO Cookbook (iOS/tvOS SDK).

    • Pro Tip: För att få tillgång till användarens prenumerationsinformation måste användaren 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 och enheten kommer att spara användarens val. 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 avsnittet från Settings -> TV Provider på iOS/iPadOS eller Settings -> Accounts -> TV Provider på tvOS.

    • Pro Tips! Vi rekommenderar att du begär användarens tillstånd när programmet förgrundsvisas, men det är bara ett förslag, eftersom programmet kan kontrollera om användaren har åtkomstbehörighet innan användarautentisering krävs. Dessutom kommer API:erna för AccessEnabler iOS/tvOS SDK automatiskt att begära användarens tillstånd när användaren behöver det.

    • Pro Tips! Vi rekommenderar att du uppmuntrar användare som vägrar ge behörighet till prenumerationsinformation genom att förklara fördelarna med SSO-användarupplevelsen (Single Sign-On). 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 avsnittet från Settings -> TV Provider på iOS/iPadOS eller Settings -> Accounts -> TV Provider på tvOS.

Resultatet bör ge en upplevelse som överensstämmer med följande användarflöden, som vi rekommenderar att du tittar på innan du börjar utveckla dina program:

IMPORTANT
När funktionen för enkel inloggning är aktiverad för iOS/tvOS och för Apple onboarding (supported) eller picker MVPD:er kommer autentiserings-/utloggningsflödena från Apple SSO-arbetsflöden att omfatta både Apple- och Adobe Pass-autentiseringslösningar, medan alla andra flöden (auktorisering, förauktorisering, metadata osv.) kommer endast att hanteras av Adobe Pass Authentication.
IMPORTANT
När funktionen för enkel inloggning är inaktiverad för iOS/tvOS eller för Apple inte introducerad (stöds inte) MVPD:er, kommer autentiserings-/utloggningsflödena att återgå från Apple SSO-arbetsflöden till de vanliga arbetsflöden som enbart hanteras av Adobe Pass-autentisering.
IMPORTANT
En stor fördel med Apple SSO-arbetsflödet är användarflödet för autentisering på en skärm, som också kan levereras på Apple TV när funktionen för enkel inloggning är aktiverad för tvOS och när det gäller Apple onboarding (supported) MVPD-program.

MVPD MVPD

För att kunna dra nytta av SSO-användarupplevelsen (Single Sign-On) behöver du en
MVPD måste

  1. Bli medlem i arbetsflödet för Apple SSO på Apple. Kontakta Apple för att underlätta introduktionsprocessen.
  2. Tillhandahåll en JavaScript TVML-applikation som kan hantera användarens inloggningsformulär. Kontakta Apple för att få rätt dokumentation.
  3. Ange ett strängvärde som representerar den provider-ID som tilldelats av Apple under introduktionsprocessen. Kontakta Adobe Pass-autentiseringen för att utföra konfigurationsändringar.

Vanliga frågor FAQ

  1. Om något går fel i Apple SSO-arbetsflöde, kan programmet som använder AccessEnabler iOS/tvOS SDK återgå till det reguljära autentiseringsflödet?

    • Detta är möjligt men kräver att en konfigurationsändring utförs på Adobe Primetime TVE Dashboard. Aktivera enkel inloggning måste anges på NO för den önskade integreringen (Channel x MVPD) och den önskade plattformen (iOS/tvOS).
    • Programmet skulle bara bekräfta konfigurationsändringen efter att ha anropat setRequestor API om det använder AccessEnabler iOS/tvOS SDK.
  2. Vet programmet när en autentisering har skett till följd av en inloggning via plattformens SSO på en annan enhet eller ett annat program?

    • Den här informationen kommer inte att vara tillgänglig.
  3. Vet programmet när en autentisering har skett som ett resultat av en inloggning via plattformens SSO på samma enhet?

    • Den här informationen är tillgänglig som en del av användarens metadatanyckel: tokenSource, som bör returnera strängvärdet: "Apple" i det här fallet.
  4. Vad händer om en användare loggar in genom att gå till Settings -> TV Provider på iOS/iPadOS eller Settings -> Accounts -> TV Provider på tvOS med ett MVPD som inte är integrerat med programmet?

    • När användaren startar programmet autentiseras inte användaren via arbetsflödet för enkel inloggning i Apple. Därför måste programmet återgå till det reguljära autentiseringsflödet och presentera en egen MVPD-väljare.
  5. Vad händer om en användare loggar in genom att gå till Settings -> TV Provider på iOS/iPadOS eller Settings -> Accounts -> TV Provider på tvOS med ett MVPD som har Aktivera enkel inloggning inställt på NOAdobe Primetime TVE Dashboard för iOS/tvOS-plattformen?

    • När användaren startar programmet autentiseras inte användaren via arbetsflödet för enkel inloggning i Apple. Därför måste programmet återgå till det reguljära autentiseringsflödet och presentera en egen MVPD-väljare.
  6. Vad händer om en användare har ett MVPD-program som inte har introducerats (stöds inte) av Apple, men som finns i Apple-väljaren?

    • När användaren startar programmet väljer användaren bara MVPD via Apple SSO-arbetsflöde utan att slutföra autentiseringsflödet. Därför måste programmet återgå till det reguljära autentiseringsflödet, men kan använda det redan valda MVPD.
  7. Vad händer om en användare har ett MVPD som inte har anammats (stöds inte) av Apple?

    • När användaren startar programmet väljer användaren alternativet "Andra TV-leverantörer" via arbetsflödet för enkel inloggning i Apple. Därför måste programmet återgå till det reguljära autentiseringsflödet och presentera en egen MVPD-väljare.
  8. Vad händer om en användare har ett MVPD som bryts ned via Adobe Primetime TVE Dashboard?

    • När användaren startar programmet autentiseras användaren via nedbrytningsmekanismen och inte via Apple SSO-arbetsflöde.
    • Användargränssnittet bör vara sömlöst, medan programmet informeras via varningskoden N010 om det använder AccessEnabler iOS/tvOS SDK.
  9. Kommer MVPD-användar-ID att ändras mellan Apple SSO och SSO-autentiseringsflödet utanför Apple?

    • Förväntningen är att användar-ID inte ändras, men måste verifieras för varje vald leverantör.
  10. Kommer autentiserings-TTL att ändras?

    • Adobe Pass Authentication fortsätter att respektera de TTL:er som krävs av programmerarna för deras integrering med varje MVPD.
    • När du navigerar från ett programmeringsprogram till ett annat programmeringsprogram via Apple SSO, kommer det andra programmet att ha en TTL för motsvarande programmeringsprogram x MVPD-integrering (det delar inte TTL-värdet för det första programmet som autentiseras)
Adobe Pass-autentiserings-TTL har gått ut
Adobe Pass Authentication TTL valid
Token för Apple-enhet har upphört att gälla
användaren är INTE autentiserad (MVPD-väljaren ska visas)
användaren är autentiserad och TTL är den återstående tiden för denna Adobe Pass Authentication-token
Apple enhetstoken TTL giltig
användaren är tyst autentiserad och hämtar en annan Adobe Pass-autentiseringstoken med den TTL som anges i TVE Dashboard
användaren är autentiserad och TTL är den återstående tiden för denna Adobe Pass Authentication-token
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b