(Äldre) Android SDK Cookbook android-sdk-cookbook

Ange identiteten för begärande.

Kontrollera och hämta autentisering mot en viss identitetsleverantör.

Kontrollera och få behörighet för en viss resurs.

Logga ut.

Skapa callback-funktioner:

• setRequestorComplete()

  Utlöses av setRequestor() och returnerar om åtgärden lyckades eller misslyckades.
  Slutfört visar att du kan fortsätta med berättigandeanrop.

• displayProviderDialog(mvpds)

  Utlöses endast av getAuthentication() om användaren inte har valt någon leverantör (MVPD) och ännu inte är autentiserad.
  Parametern mvpds är en matris med providers som är tillgängliga för användaren.

• setAuthenticationStatus(status, felkod)

  Utlöses av checkAuthentication() varje gång.
  Utlöses endast av getAuthentication() om användaren redan är autentiserad och har valt en leverantör.

  Status som returneras är lyckad eller misslyckad. Felkoden beskriver typen av fel.

• navigateToUrl(url)

  Utlöses av getAuthentication() efter att användaren har valt en MVPD. Parametern url anger platsen för MVPD inloggningssida.

• sendTrackingData(event, data)

  Utlöses av checkAuthentication(), getAuthentication(), checkAuthorization(), getAuthorization(), setSelectedProvider().
  Parametern event anger vilken berättigandehändelse som inträffade. Parametern data är en lista med värden som relaterar till händelsen.

• setToken(token, resource)

  Utlöses av checkAuthorization() och getAuthorization() efter en auktorisering för att visa en resurs.
  Parametern token är den kortlivade medietoken. Parametern resource är det innehåll som användaren har behörighet att visa.

• tokenRequestFailed(resource, code, description)

  Utlöses av checkAuthorization() och getAuthorization() efter en misslyckad auktorisering.
  Parametern resource är det innehåll som användaren försökte visa. Parametern code är felkoden som anger vilken typ av fel som uppstod. Parametern description beskriver felet som är associerat med felkoden.

• selectedProvider(mvpd)

  Utlöses av getSelectedProvider().
  Parametern mvpd ger information om providern som valts av användaren.

• setMetadataStatus(metadata, nyckel, argument)

  Utlöses av getMetadata().
  Parametern metadata innehåller de specifika data som du har begärt, parametern key är nyckeln som används i begäran getMetadata() och parametern arguments är samma ordlista som skickades till getMetadata().

• "preauthorizedResources(resources)`

  Utlöses av checkPreauthorizedResources().
  Parametern authorizedResources visar de resurser som användaren har behörighet att visa.

Starta programmet på den översta nivån.

Initiera Adobe Pass-autentisering

a. Anropa getInstance för att skapa en enda instans av Adobe Pass Authentication AccessEnabler.

• Beroende: Inbyggt Adobe Pass-autentisering
  Android Library (AccessEnabler)

b. Anropa setRequestor() för att upprätta identifieringen av programmeraren; skicka en matris med Adobe Pass Authentication-slutpunkter i programmerarens requestorID och (eventuellt).

• Beroende: Giltigt begärande-ID för Adobe Pass-autentisering
  (Samarbeta med kontohanteraren för Adobe Pass-autentisering för att ordna detta.)

• Utlösare: setRequestorComplete()-återanrop

Anropa checkAuthentication() om du vill söka efter en befintlig autentisering utan att initiera det fullständiga autentiseringsflödet. Om samtalet lyckas kan du gå direkt till auktoriseringsflödet. Om inte, fortsätter du till autentiseringsflödet.

• Beroende: Ett lyckat anrop till setRequestor() (det här beroendet gäller även för alla efterföljande anrop).

• Utlösare: setAuthenticationStatus() återanrop

Ring getAuthentication() för att initiera autentiseringsflödet eller för att få en bekräftelse på att användaren redan är autentiserad.
Utlösare:

• Callback-funktionen setAuthenticationStatus(), om användaren redan är autentiserad. I det här fallet går du direkt till auktoriseringsflödet.
• Callback-funktionen displayProviderDialog(), om användaren inte har autentiserats ännu.

Presentera användaren med listan över leverantörer som skickats till displayProviderDialog().

När användaren har valt en provider hämtar du URL:en för användarens MVPD från navigateToUrl()-återanropet. Öppna en WebView och dirigera WebView-kontrollen till URL:en.

Via den WebView-vy som skapades i det föregående steget markeras användaren på MVPD inloggningssida och inloggningsuppgifter. Flera omdirigeringsåtgärder utförs i WebView.

Obs! Nu har användaren möjlighet att avbryta autentiseringsflödet. Om detta inträffar ansvarar ditt UI-lager för att informera AccessEnabler om den här händelsen genom att anropa setSelectedProvider() med null som en parameter. Detta gör att AccessEnabler kan rensa upp dess interna tillstånd och återställa autentiseringsflödet.

Vid en lyckad inloggning från användaren upptäcker programlagret inläsningen av en "anpassad omdirigerings-URL" (dvs.: http://adobepass.android.app). Den här anpassade URL:en är en ogiltig URL som inte ska läsas in av WebView. Det är en signal om att autentiseringsflödet har slutförts och att WebView måste stängas.

Stäng WebView-kontrollen och anropa getAuthenticationToken(), som instruerar AccessEnabler att hämta autentiseringstoken från serverdelen.

[Valfritt] samtal checkPreauthorizedResources(resources) för att kontrollera vilka resurser användaren har behörighet att visa. Parametern resources är en matris med skyddade resurser som är associerad med användarens autentiseringstoken.
Utlösare: preAuthorizedResources() återanrop
Körningspunkt: Efter det slutförda autentiseringsflödet

Om autentiseringen lyckades fortsätter du till auktoriseringsflödet.

Anropa getAuthorization() för att initiera auktoriseringen
flöde.

Beroende: Giltiga resurs-ID:n som avtalats med MVPD(n).

Obs! Resurs-ID:n ska vara samma som de som används på andra enheter eller plattformar och ska vara samma för alla flerkanalsprogram.

Validera autentisering och auktorisering.

• Om anropet getAuthorization() lyckas: Användaren har giltiga AuthN- och AuthZ-tokens (användaren är autentiserad och har behörighet att titta på det begärda mediet).

• Om getAuthorization() misslyckas: Undersök undantaget som utlösts för att fastställa dess typ (AuthN, AuthZ eller något annat):

  • Om det var ett autentiseringsfel (AuthN) startar du om autentiseringsflödet.
  • Om det var ett auktoriseringsfel (AuthZ) har användaren inte behörighet att titta på det begärda mediet och någon typ av felmeddelande ska visas för användaren.
  • Om det finns någon annan typ av fel (anslutningsfel, nätverksfel osv.) visar du ett felmeddelande för användaren.

Validera den korta medietoken.
Använd Adobe Pass Authentication Media Token Verifier-biblioteket för att verifiera den kortlivade medietoken som returnerats från getAuthorization()-anropet ovan:

• Om valideringen lyckas: Spela upp det begärda mediet för användaren.
• Om valideringen misslyckas: AuthZ-token var ogiltig, ska mediebegäran avvisas och ett felmeddelande ska visas för användaren.

Återgå till det normala programflödet.

Ring logout() för att logga ut användaren.
AccessEnabler rensar bort alla cachelagrade värden och token för den aktuella MVPD-begäran och även för beställare med enkel inloggning. När cacheminnet har rensats gör AccessEnabler ett serveranrop för att rensa sessionerna på serversidan. Observera, att eftersom serveranropet kan resultera i en SAML-omdirigering till IdP (detta tillåter sessionsrensning på IdP-sidan), måste det här anropet följa alla omdirigeringar. Därför måste anropet hanteras i en WebView-kontroll.

a. I samma mönster som autentiseringsarbetsflödet gör AccessEnabler-domänen en en begäran till gränssnittets programlager (via navigateToUrl()-återanropet) om att skapa en WebView-kontroll och instruera den kontrollen att läsa in URL:en för utloggningsslutpunkten på serverdelen.

b. Återigen måste gränssnittet övervaka WebView-kontrollens aktivitet och upptäcka när kontrollen, när den går igenom flera omdirigeringar, läser in programmets anpassade URL (d.v.s.: http://adobepass.android.app/). När den här händelsen inträffar stänger gränssnittets programlager WebView och utloggningsprocessen är klar.

Obs! Loggoutflödet skiljer sig från autentiseringsflödet på så sätt att användaren inte behöver interagera med WebView på något sätt. Gränssnittets programlager använder en WebView för att se till att alla omdirigeringar följs. Det är därför möjligt (och rekommenderas) att göra WebView-kontrollen osynlig (dvs. dold) under utloggningsprocessen.