(Legacy) Amazon FireOS-Integrations-Cookbook amazon-fireos-integration-cookbook

Erstellen Sie Ihre Callback-Funktionen:

• setRequestorComplete()

  • Wird durch setRequestor() ausgelöst und gibt „Erfolg“ oder „Fehler“ zurück. Der Erfolg zeigt an, dass Sie mit Berechtigungsaufrufen fortfahren können.

• displayProviderDialog(mvpds)

  • Wird nur von getAuthentication() ausgelöst, wenn der Benutzer keinen Provider (MVPD) ausgewählt hat und noch nicht authentifiziert ist. Der mvpds Parameter ist ein Array von Anbietern, die den Benutzenden zur Verfügung stehen.

• setAuthenticationStatus(status, reason)

  • Wird jedes Mal von checkAuthentication() ausgelöst. Wird nur von getAuthentication() ausgelöst, wenn der Benutzer bereits authentifiziert ist und einen Anbieter ausgewählt hat.

  • Der zurückgegebene Status ist authentifiziert oder nicht authentifiziert. Der Grund dafür ist ein Authentifizierungsfehler oder eine Abmeldeaktion.

• navigateToUrl(url)

  • Wird in AmazonFireOS SDK ignoriert, wird die Methode auf Android-Plattformen verwendet, wo sie durch getAuthentication() ausgelöst wird, nachdem der Benutzer eine MVPD ausgewählt hat. Der url gibt den Speicherort der Anmeldeseite von MVPD an.

• sendTrackingData(event, data)

  • Ausgelöst durch checkAuthentication(), getAuthentication(), checkAuthorization(), getAuthorization(), setSelectedProvider().
    Der event Parameter gibt an, welches Berechtigungsereignis aufgetreten ist. Der data Parameter ist eine Liste von Werten, die sich auf das Ereignis beziehen.

• setToken(token, resource)

  • Wird durch checkAuthorization() und getAuthorization() nach erfolgreicher Autorisierung zum Anzeigen einer Ressource ausgelöst.
  • Der token ist das kurzlebige Medien-Token. Der resource ist der Inhalt, den der Benutzer anzeigen darf.

• tokenRequestFailed(resource, code, description)

  • Wird durch checkAuthorization() und getAuthorization() nach erfolgloser Autorisierung ausgelöst.
  • Der resource ist der Inhalt, den die Benutzerin oder der Benutzer versucht hat anzuzeigen. Der code ist der Fehlercode, der angibt, welche Art von Fehler aufgetreten ist. Der description Parameter beschreibt den Fehler, der mit dem Fehlercode verbunden ist.

• selectedProvider(mvpd)

  • Ausgelöst durch getSelectedProvider().
  • Der Parameter mvpd enthält Informationen zum vom Benutzer ausgewählten Anbieter.

• setMetadataStatus(metadata, key, arguments)

  • Ausgelöst durch getMetadata().
  • Der metadata-Parameter liefert die angeforderten spezifischen Daten, der key-Parameter ist der in der getMetadata()-Anfrage verwendete Schlüssel und der arguments ist dasselbe Wörterbuch, das an getMetadata() übergeben wurde.

• preauthorizedResources(resources)

  • Ausgelöst durch checkPreauthorizedResources().
  • Der authorizedResources Parameter stellt die Ressourcen dar, die der Benutzer anzeigen darf.

Starten Sie die Anwendung auf höherer Ebene.

Adobe Pass-Authentifizierung starten.

1. Rufen Sie getInstance auf, um eine einzelne Instanz des Adobe Pass-Authentifizierungs-AccessEnabler zu erstellen.

   • Abhängigkeit: Adobe Pass Authentication Native Amazon FireOS Library (AccessEnabler)

2. Aufruf setRequestor(), um die Kennung des Programmierers zu ermitteln; übergeben Sie die requestorID des Programmierers und (optional) ein Array von Adobe Pass-Authentifizierungsendpunkten.

   • Abhängigkeit: Valid Adobe Pass Authentication RequestorID (Wenden Sie sich an Ihren Adobe Pass Authentication Account Manager, um dies zu arrangieren.)

   • Trigger: setRequestorComplete()-Rückruf

Berechtigungsanfragen können erst abgeschlossen werden, wenn die Identität des Antragstellers vollständig ermittelt wurde. Dies bedeutet effektiv, dass während der Ausführung von setRequestor() alle nachfolgenden Berechtigungsanfragen (z. B. checkAuthentication()) blockiert werden.

Sie haben zwei Implementierungsoptionen: Sobald die Anfordereridentifizierungsinformationen an den Backend-Server gesendet wurden, kann die Benutzeroberflächen-Anwendungsebene einen der beiden folgenden Ansätze wählen:

1. Warten Sie, bis der setRequestorComplete()-Rückruf ausgelöst wird (Teil des AccessEnabler-Delegaten). Diese Option bietet die größte Sicherheit, dass abgeschlossen setRequestor(). Daher wird sie für die meisten Implementierungen empfohlen.
2. Fahren Sie fort, ohne auf das Auslösen des setRequestorComplete()-Callbacks zu warten, und beginnen Sie mit der Ausgabe von Berechtigungsanfragen. Diese Aufrufe (checkAuthentication, checkAuthorization, getAuthentication, getAuthorization, checkPreauthorizedResource, getMetadata, logout) werden von der AccessEnabler-Bibliothek in die Warteschlange gestellt, die die eigentlichen Netzwerkaufrufe nach dem setRequestor() ausführt. Diese Option kann gelegentlich unterbrochen werden, wenn beispielsweise die Netzwerkverbindung instabil ist.

Rufen Sie checkAuthentication() auf, um auf eine vorhandene Authentifizierung zu prüfen, ohne den vollständigen Authentifizierungsfluss zu initiieren. Wenn dieser Aufruf erfolgreich ist, können Sie direkt mit dem Autorisierungsfluss fortfahren. Andernfalls fahren Sie mit dem Authentifizierungsfluss fort.

Rufen Sie getAuthentication() auf, um den Authentifizierungsfluss zu initiieren oder um eine Bestätigung zu erhalten, dass der Benutzer bereits authentifiziert ist.

Trigger:

• Der Rückruf setAuthenticationStatus() , wenn der Benutzer bereits authentifiziert ist. Fahren Sie in diesem Fall direkt mit dem Autorisierungsfluss“.
• Der Rückruf displayProviderDialog() , wenn der Benutzer noch nicht authentifiziert ist.

Zeigen Sie dem Benutzer die Liste der an displayProviderDialog() gesendeten Anbieter.

Nachdem der Benutzer einen Anbieter ausgewählt hat, öffnet WebView die Anbieterseite, auf der sich der Benutzer anmelden kann

Nach erfolgreicher Anmeldung durch den Benutzer wird die WebView geschlossen.

Rufen Sie getAuthenticationToken(), auf, um den AccessEnabler anzuweisen, das Authentifizierungstoken vom Backend-Server abzurufen.

[Optional] Rufen Sie checkPreauthorizedResources(resources) auf, um zu überprüfen, welche Ressourcen der Benutzer anzeigen darf. Der resources ist ein Array geschützter Ressourcen, das mit dem Authentifizierungstoken des Benutzers verknüpft ist.

Trigger: preAuthorizedResources() Callback
Ausführungspunkt: Nach Abschluss des Authentifizierungsflusses

Wenn die Authentifizierung erfolgreich war, fahren Sie mit dem Autorisierungsfluss fort.

Rufen Sie getAuthorization() auf, um den Autorisierungsfluss zu initiieren.

Abhängigkeit: Gültige ResourceID(s), die mit den MVPD vereinbart wurden.

Hinweis Die Ressourcen-IDs müssen mit den auf anderen Geräten oder Plattformen verwendeten IDs übereinstimmen und für alle MVPDs identisch sein.

Authentifizierung und Autorisierung überprüfen.

• Wenn der getAuthorization()-Aufruf erfolgreich ist: Der Benutzer verfügt über gültige AuthN- und AuthZ-Token (der Benutzer ist authentifiziert und berechtigt, die angeforderten Medien zu sehen).

• Wenn getAuthorization() fehlschlägt: Untersuchen Sie die ausgelöste Ausnahme, um ihren Typ (AuthN, AuthZ oder etwas Anderes) zu bestimmen:

  • Wenn es sich um einen Authentifizierungsfehler (AuthN) handelte, starten Sie den Authentifizierungsfluss erneut.
  • Wenn es sich um einen Autorisierungsfehler (AuthZ) handelte, ist der Benutzer nicht berechtigt, die angeforderten Medien anzusehen, und dem Benutzer sollte eine Fehlermeldung angezeigt werden.
  • Wenn ein anderer Fehlertyp aufgetreten ist (Verbindungsfehler, Netzwerkfehler usw.), zeigen Sie dem Benutzer eine entsprechende Fehlermeldung an.

Validieren des Short Media Token.

Verwenden Sie die Media Token Verifier-Bibliothek der Adobe Pass-Authentifizierung, um das vom obigen getAuthorization()-Aufruf zurückgegebene kurzlebige Medien-Token zu überprüfen:

• Wenn die Validierung erfolgreich ist: Geben Sie die angeforderten Medien für den Benutzer wieder.
• Wenn die Validierung fehlschlägt: Das AuthZ-Token war ungültig, sollte die Medienanfrage abgelehnt werden und dem Benutzer sollte eine Fehlermeldung angezeigt werden.

Kehren Sie zu Ihrem normalen Programmablauf zurück.

Der Benutzer wählt die anzuzeigenden Medien aus.

Sind die Medien geschützt? Ihre Anwendung prüft, ob das ausgewählte Medium geschützt ist:

• Wenn das ausgewählte Medium geschützt ist, startet Ihre Anwendung den Autorisierungsfluss oben.
• Wenn das ausgewählte Medium nicht geschützt ist, geben Sie das Medium für den Benutzer wieder.

Rufen Sie logout() auf, um den Benutzer abzumelden. Die AccessEnabler löscht alle zwischengespeicherten Werte und Token, die Benutzende für die aktuelle MVPD erhalten haben, aus allen Anforderern, die die Anmeldung über Single Sign-On teilen. Nachdem der Cache gelöscht wurde, führt der AccessEnabler einen Server-Aufruf durch, um die Server-seitigen Sitzungen zu bereinigen. Da der Server-Aufruf zu einer SAML-Umleitung an den IdP führen kann (dies ermöglicht die Sitzungsbereinigung auf der IdP-Seite), muss dieser Aufruf allen Umleitungen folgen. Aus diesem Grund wird dieser Aufruf innerhalb eines WebView-Steuerelements verarbeitet, das für den Benutzer unsichtbar ist.

Hinweis: Der Abmeldefluss unterscheidet sich vom Authentifizierungsfluss insofern, als der Benutzer in keiner Weise mit der WebView interagieren muss. Daher ist es möglich (und empfohlen), das WebView-Steuerelement während des Abmeldevorgangs unsichtbar (d. h. ausgeblendet) zu machen.