(Äldre) Amazon FireOS SDK med dynamisk klientregistrering amazon-fireos-sdk-with-dynamic-client-registration
Introduktion Intro
FireOS AccessEnabler SDK for FireTV har ändrats för att aktivera autentisering utan sessionscookies. I takt med att fler och fler webbläsare begränsar åtkomsten till cookies behövdes en annan metod för att tillåta autentisering.
FireOS SDK 3.0.4 ersätter den aktuella programregistreringsmekanismen baserat på autentisering av begärande-ID och sessionscookie med Översikt över registrering av dynamisk klient.
API-ändringar API
Factory.getInstance
Beskrivning: Instansierar åtkomstaktiveringsobjektet. Det ska finnas en enda instans av Access Enabler per programinstans.
returnerar AccessEnablerException
Tillgänglighet: v3.0+
Parametrar:
- appContext: Android-programkontext
- softwareStatement: värde från TVE Dashboard eller null om "software_statement" har angetts i strings.xml
- redirectUrl : för FireTV-implementeringar ska den här parametern vara null. Alla inställningar för det här attributet ignoreras.
Anteckningar
- invalid softwareStatement kommer att göra så att programmet inte initierar AccessEnabler eller registrerar program för Adobe Pass Authentication och authentication
- redirectUrl-parametern för FireTV anges av SDK till adobepass://android.app eftersom autentiseringen hanteras av den unika AccessEnabler-instansen.
setRequestor
Beskrivning: Anger kanalens identitet. Varje kanal tilldelas ett unikt ID när den registreras hos Adobe för Adobe Pass autentiseringssystem. När det gäller enkel inloggning och fjärrtoken kan autentiseringstillståndet ändras när programmet är i bakgrunden. Det går att anropa setRequestor igen när programmet försätts i förgrunden för att synkronisera med systemtillståndet (hämta en fjärrtoken om enkel inloggning är aktiverad eller ta bort den lokala token om en utloggning inträffar under tiden).
Serversvaret innehåller en lista över MVPD:er tillsammans med viss konfigurationsinformation som är kopplad till kanalens identitet. Serversvaret används internt av åtkomstaktiveringskoden. Endast åtgärdens status (d.v.s. SUCCESS/FAIL) visas för programmet via callback-funktionen setRequestorComplete().
Om parametern urls inte används anger det resulterande nätverksanropet standardtjänstleverantörens URL: Adobe Release Production Environment.
Om ett värde anges för parametern urls, anger det resulterande nätverksanropet alla URL:er som anges i parametern urls som mål. Alla konfigurationsbegäranden aktiveras samtidigt i olika trådar. Den första svararen har företräde när listan över MVPD kompileras. För varje MVPD i listan kommer Access Enabler ihåg URL:en till den associerade tjänsteleverantören. Alla efterföljande tillståndsbegäranden dirigeras till den URL som är associerad med tjänstleverantören som parats med mål-MVPD under konfigurationsfasen.
Tillgänglighet: v3.0+
public void setRequestor(String requestorId, ArrayList<String> urls)Tillgänglighet: v3.0+
Parametrar:
- requestedID: Det unika ID som är associerat med kanalen. Skicka det unika ID som tilldelats av Adobe till din webbplats när du första gången registrerar dig hos tjänsten Adobe Pass Authentication.
- urls: Valfri parameter. Som standard används Adobes tjänstleverantör (http://sp.auth.adobe.com/). Med den här arrayen kan du ange slutpunkter för autentisering och auktoriseringstjänster som tillhandahålls av Adobe (olika instanser kan användas i felsökningssyfte). Du kan använda detta för att ange flera instanser av Adobe Pass Authentication-tjänstprovidern. Då består MVPD-listan av slutpunkterna från alla tjänsteleverantörer. Varje MVPD är kopplat till den snabbaste tjänsteleverantören, dvs. den leverantör som svarade först och som stöder MVPD.
Föråldrat:
- signedRequestorID: En kopia av begärande-ID:t som har signerats digitalt med din privata nyckel. .
Återanrop har utlösts: setRequestorComplete()
utloggning
Beskrivning: Använd den här metoden för att initiera utloggningsflödet. Utloggningen är resultatet av en serie HTTP-omdirigeringsåtgärder på grund av att användaren måste loggas ut både från Adobe Pass autentiseringsservrar och från MVPD servrar. Det innebär att det här flödet öppnar ett ChromeCustomTab-fönster för att köra utloggningen.
Tillgänglighet: v3.0+
Parametrar: Inga
Återanrop har utlösts: setAuthenticationStatus()
Programmeringsimplementeringsflöde Progr
1. Registrera program
-
Hämta programvaran_statement från Adobe Pass ( TVE Dashboard )
-
Det finns två alternativ för att skicka dessa värden till Adobe Pass SDK:
-
Lägg till i strings.xml:
code language-none <string name>"software\_statement">[softwarestatement value]</string> -
Anropa AccessEnabler.getInstance(appContext,softwareStatement, null)
-
2. Konfigurera programmet
-
a. setRequestor(request_id)
SDK utför följande åtgärder:
- registreringsprogram: med software_statement får SDK en client_id, client_secrets, client_id_issued_at, redirect_uris, grant_types. Den här informationen lagras i programmets interna lagring.
- hämta en access_token med client_id, client_secrets och grant_type="client_credentials". Denna åtkomst_token kommer att användas för alla samtal som SDK gör till Adobe Pass-servrar.
-
om en MVPD kräver passiv autentisering öppnas en WebView som körs passivt med den MVPD och stängs när allt är klart
-
b. checkAuthentication()
- true : gå till auktorisering
- false : gå till Select MVPD
-
c. getAuthentication : SDK kommer att inkludera access_token i anropsparametrarna
- mvpd kom ihåg : gå till setSelectedProvider(mvpd_id)
- mvpd är inte markerat: displayProviderDialog
- mvpd selected : go to setSelectedProvider(mvpd_id)
-
d. setSelectedProvider
- mvpd_id-autentiserings-url har lästs in i ChromeCustomTabs
- inloggningen lyckades : delegate.setAuthenticationStatus ( SUCCESS)
- inloggningen avbröts: återställa MVPD-markering
- URL-schemat har etablerats som "adobepass://android.app" för hämtning när autentiseringen är klar
-
e. get/checkAuthorization: SDK inkluderar access_token i header som Authorization: Bearer access_token
-
om auktoriseringen lyckas, kommer ett anrop att göras för att erhålla medietoken
-
f. utloggning:
- SDK kommer att ta bort giltig token för den aktuella begäraren (autentiseringar som erhållits av andra program och inte via enkel inloggning fortsätter att gälla)
- SDK öppnar Chrome anpassade flikar för att nå mvpd_id-utloggningsslutpunkten. När du är klar stängs Chrome anpassade flikar
- URL-schemat är "adobepass://logout" för att fånga in tidpunkten då utloggningen är klar
- utlösaren utlöser en sendTrackingData(new Event(EVENT_LOGOUT,USER_NOT_AUTHENTICATED_ERROR) och ett återanrop : setAuthenticationStatus(0,"Logout")
Obs! eftersom varje anrop kräver en access_token hanteras eventuella felkoder nedan i SDK.