(Verouderd) Android SDK Cookbook android-sdk-cookbook

Stel de identiteit van de aanvrager in.

Controleer en krijg authentificatie tegen een bepaalde identiteitsleverancier.

Controleer en krijg vergunning voor een bepaalde bron.

Afmelden.

Maak uw callback-functies:

• setRequestorComplete()`

  Wordt geactiveerd door setRequestor() en retourneert een geslaagde of mislukte bewerking.
  Het succes wijst erop u met machtigingsvraag kunt te werk gaan.

• displayProviderDialog(mvpds)

  Wordt alleen geactiveerd door getAuthentication() als de gebruiker geen provider (MVPD) heeft geselecteerd en nog niet is geverifieerd.
  De parameter mvpds is een array van providers die beschikbaar zijn voor de gebruiker.

• setAuthenticationStatus(status, errorCode)`

  Wordt telkens geactiveerd door checkAuthentication() .
  Wordt alleen geactiveerd door getAuthentication() als de gebruiker al is geverifieerd en een provider heeft geselecteerd.

  De geretourneerde status is geslaagd of mislukt. De foutcode beschrijft het type fout.

• navigateToUrl(url)

  Wordt geactiveerd door getAuthentication() nadat de gebruiker een MVPD selecteert. De parameter url biedt de locatie van de MVPD-aanmeldingspagina.

• sendTrackingData(event, data)

  Wordt geactiveerd door checkAuthentication(), getAuthentication(), checkAuthorization(), getAuthorization(), setSelectedProvider() .
  De parameter event geeft aan welke gebeurtenis entitlement heeft plaatsgevonden. De parameter data is een lijst met waarden die betrekking hebben op de gebeurtenis.

• setToken(token, resource)`

  Wordt geactiveerd door checkAuthorization() en getAuthorization() nadat u een resource hebt bekeken.
  De parameter token is het kortstondige media-token; de parameter resource is de inhoud die de gebruiker mag bekijken.

• tokenRequestFailed(resource, code, description)

  Wordt geactiveerd door checkAuthorization() en getAuthorization() nadat de autorisatie is mislukt.
  De parameter resource is de inhoud die de gebruiker probeerde te bekijken. De parameter code is de foutcode die aangeeft welk type fout is opgetreden. De parameter description beschrijft de fout die aan de foutcode is gekoppeld.

• selectedProvider(mvpd)

  Wordt geactiveerd door getSelectedProvider() .
  De parameter mvpd biedt informatie over de provider die door de gebruiker is geselecteerd.

• setMetadataStatus(metadata, key, arguments)

  geactiveerd door getMetadata().
  De parameter metadata bevat de specifieke gegevens die u hebt aangevraagd. De parameter key is de sleutel die wordt gebruikt in de aanvraag getMetadata() en de parameter arguments is hetzelfde woordenboek dat is doorgegeven aan getMetadata() .

• "preauthorisedResources(resources)"

  Wordt geactiveerd door checkPreauthorizedResources() .
  De parameter authorizedResources geeft de bronnen weer die de gebruiker mag bekijken.

Start de toepassing op het hoogste niveau.

Adobe Pass-verificatie starten

a. Vraag getInstance aan om één instantie van Adobe Pass Authentication AccessEnabler te maken.

• Afhankelijkheid: Eigen de Authentificatie van Adobe Pass
  Android Library (AccessEnabler)

b. Vraag setRequestor() om de identificatie van de Programmer te vestigen; ga in de 1} van de Programmer en (facultatief) een serie van de eindpunten van de Authentificatie van Adobe Pass over.requestorID

• Afhankelijkheid: Geldige VraagID van de Authentificatie van Adobe Pass
  (Gebruik hiervoor Adobe Pass Authentication Account Manager.)

• Trekkers: setRequestorComplete () callback

Vraag ​ checkAuthentication () ​ om een bestaande authentificatie te controleren zonder de volledige stroom van de Authentificatie in werking te stellen. Als deze vraag slaagt, kunt u aan de stroom van de Vergunning direct te werk gaan. Zo niet, ga dan door naar de verificatiestroom.

• Afhankelijkheid: Een succesvolle vraag aan setRequestor() (dit gebiedsdeel is eveneens op alle verdere vraag van toepassing).

• Trekkers: setAuthenticationStatus () callback

Vraag getAuthentication() om de authentificatiestroom in werking te stellen, of bevestiging te krijgen dat de gebruiker reeds voor authentiek verklaard is.
Trekkers:

• De callback setAuthenticationStatus(), als de gebruiker al is geverifieerd. In dit geval, ga direct aan de ​ Stroom van de Vergunning ​ te werk.
• De callback displayProviderDialog(), als de gebruiker nog niet is geverifieerd.

Geef de gebruiker de lijst met providers weer die naar displayProviderDialog() is verzonden.

Nadat de gebruiker een provider selecteert, verkrijgt u de URL van de MVPD van de gebruiker via de callback van navigateToUrl() . Open een WebView en richt die controle WebView aan URL.

Via WebView die in de vorige stap wordt geconcretiseerd, landt de gebruiker op de MVPD login pagina en input login geloofsbrieven. Verscheidene omleidingsverrichtingen vinden binnen WebView plaats.

Nota: Op dit punt, heeft de gebruiker de kans om de authentificatiestroom te annuleren. Als dit voorkomt, is uw UI laag verantwoordelijk voor het informeren van AccessEnabler over deze gebeurtenis door setSelectedProvider() met null als parameter te roepen. Dit staat AccessEnabler toe om het interne staat op te schonen en de Stroom van de Authentificatie terug te stellen.

Wanneer de gebruiker zich met succes heeft aangemeld, detecteert de toepassingslaag het laden van een aangepaste omleidings-URL (d.w.z.: http://adobepass.android.app). Deze aangepaste URL is in feite een ongeldige URL die niet is bedoeld voor het laden van de WebView. Het is een signaal dat de Stroom van de Authentificatie heeft voltooid, en dat WebView moet worden gesloten.

Sluit de controle WebView en vraag getAuthenticationToken(), die AccessEnabler opdraagt om het authentificatietoken van de backendserver terug te winnen.

[ Facultatieve ] Vraag checkPreauthorizedResources(resources) om te controleren welke middelen de gebruiker aan mening wordt gemachtigd. De parameter resources is een array met beveiligde bronnen die is gekoppeld aan het verificatietoken van de gebruiker.
Trekkers: preAuthorizedResources() callback
het punt van de Uitvoering: na de voltooide Stroom van de Authentificatie

Ga door naar de machtigingsstroom als de verificatie is gelukt.

Vraag ​ getAuthorization () ​ om de vergunning in werking te stellen
stroom.

Afhankelijkheid: geldige ResourceID('s) overeengekomen met de MVPD(s).

Nota: ResourceIDs zou het zelfde moeten zijn als die gebruikt op andere apparaten of platforms, en zal het zelfde over MVPDs zijn.

Verificatie en autorisatie valideren.

• Als de getAuthorization() vraag slaagt: De gebruiker heeft geldige tokens AuthN en AuthZ (de gebruiker wordt voor authentiek verklaard en gemachtigd om de gevraagde media te bekijken).

• Als getAuthorization() ontbreekt: Onderzoek de geworpen uitzondering om zijn type (AuthN, AuthZ, of iets anders) te bepalen:

  • Als het een authentificatie (AuthN) fout was dan herstart de authentificatiestroom.
  • Als het een autorisatiefout (AuthZ) was, dan is de gebruiker niet geautoriseerd om de gevraagde media te bekijken en een soort foutbericht zou aan de gebruiker moeten worden getoond.
  • Als er een ander type fout is opgetreden (verbindingsfout, netwerkfout, enz.), geeft u een geschikt foutbericht weer voor de gebruiker.

Valideer de token voor korte media.
Gebruik de Adobe Pass Authentication Media Token Verifier-bibliotheek om het kortstondige mediatoken te verifiëren dat door de bovenstaande getAuthorization() oproep wordt geretourneerd:

• Als de validatie is gelukt: de gevraagde media afspelen voor de gebruiker.
• Als de validatie mislukt: de AuthZ-token was ongeldig, wordt de mediaquery geweigerd en wordt een foutbericht weergegeven aan de gebruiker.

Ga terug naar de normale stroom van de toepassing.

Roep logout() aan om de gebruiker af te melden.
AccessEnabler wist alle in het cachegeheugen opgeslagen waarden en tokens voor de huidige MVPD voor de huidige aanvrager en ook voor aanvragers met Single Sign On. Na het ontruimen van het geheime voorgeheugen, richt AccessEnabler een servervraag om de server-zijzittingen schoon te maken. Merk op dat aangezien de servervraag in SAML kon resulteren die aan IdP (dit staat voor de zittingsschoonmaak op de kant IdP toe) wordt omgeleid, deze vraag moet alle omleidingen volgen. Om deze reden, moet deze vraag binnen een controle worden behandeld WebView.

a. Na het zelfde patroon zoals het authentificatiewerkschema, doet het domein AccessEnabler een verzoek aan de UI toepassingslaag (via navigateToUrl() callback) om tot een controle te leiden WebView en die controle op te dragen om URL van het logout eindpunt op de backendserver te laden.

b. Opnieuw, moet UI de activiteit van de controle controleren WebView en het ogenblik ontdekken wanneer de controle, aangezien het door verscheidene omleidingen gaat, de douane URL van de toepassing laadt (d.w.z.: http://adobepass.android.app/). Zodra deze gebeurtenis plaatsvindt, sluit de UI toepassingslaag WebView en het logout proces volledig is.

Nota: de logout stroom verschilt van de authentificatiestroom in die zin dat de gebruiker niet wordt vereist om met WebView op om het even welke manier in wisselwerking te staan. De toepassingslaag UI gebruikt een WebView om ervoor te zorgen dat alle omleidingen worden gevolgd. Aldus is het mogelijk (en geadviseerd) om de controle WebView onzichtbaar (d.w.z. verborgen) tijdens het logout proces te maken.