Roku SSO Cookbook (REST API v2)
- Themen:
- Authentifizierung
Die Adobe Pass-Authentifizierungs-REST-API V2 unterstützt Platform Single Sign-On (SSO) für Endbenutzer von Client-Anwendungen, die auf RokuOS ausgeführt werden.
Dieses Dokument dient als Erweiterung für die vorhandene REST API V2 - Übersicht, die eine allgemeine Ansicht bietet, sowie für das Dokument, in dem die Implementierung von Single Sign-on mithilfe von Platform-Identitätsflüssen beschrieben wird.
Roku-Single-Sign-on mit Platform-Identitätsflüssen
Die Adobe Pass-Authentifizierung arbeitet mit Roku zusammen, um das Benutzererlebnis bei der Anmeldung zu verbessern und die einmalige Anmeldung (Single Sign-On, SSO) für TV Everywhere-Programme für TV-Abonnenten zu erleichtern.
Voraussetzungen
Bevor Sie mit dem Roku-Single-Sign-on unter Verwendung von Platform-Identitätsflüssen fortfahren, stellen Sie sicher, dass Roku SSO aktiviert ist. Roku SSO ist standardmäßig aktiviert, es sei denn, die Programmierer- oder MVPD-Anfrage für SSO wird deaktiviert.
Jeder Programmierer kann das Single Sign-On (SSO) auf der Roku-Plattform für bestimmte Integrationen über das Adobe Pass TVE Dashboard aktivieren oder.
Workflow
Client-zu-Server
Für Programmieranwendungen, die eine Client-zu-Server-Architektur zur Integration der REST-API V2 verwenden, funktioniert Roku SSO nahtlos und ohne Änderungen.
RokuOS hängt automatisch zwei HTTP-Header an alle Anfragen an, die an Authentifizierungsendpunkte von Adobe Pass gesendet werden.
Server-zu-Server
Für Programmieranwendungen, die eine Server-zu-Server-Architektur zur Integration der REST-API V2 verwenden, muss sich der Programmierer mit dem Roku-Team abstimmen, um diese Kopfzeilen zu konfigurieren, damit sie in alle API-Flüsse aufgenommen werden, die an ihre Domain gerichtet sind.
Um programmübergreifendes und geräteübergreifendes SSO zu aktivieren, sollte die von Roku bereitgestellte Teilnehmer-ID anstelle der Geräte-ID verwendet werden, wenn sie von der Anwendung übergeben wird.
Weitere Informationen finden Sie in der folgenden Dokumentation:
Weitere Informationen zum Format der erforderlichen Kopfzeilen erhalten Sie von Ihrem Adobe-Support-Mitarbeiter.
Häufig gestellte Fragen
-
Wie wird das SSO funktionieren?
SSO funktioniert in allen Programmierprogrammen, die von der Adobe Pass-Authentifizierung unterstützt werden, auf allen Roku-Geräten, die mit demselben Roku-Benutzer verknüpft sind. Nicht alle MVPDs erlauben Roku SSO.
-
Werden die Authentifizierungs-TTLs geändert?
Das erste gültige Authentifizierungstoken wird zur Durchführung von SSO verwendet, und in diesem Fall verwenden alle anderen Anwendungen, die über SSO authentifiziert werden, dieselbe TTL, bis sie abläuft. Wenn Sie also von einer Anwendung zur anderen navigieren, teilt die zweite Anwendung die TTL der ersten Anwendung, die sich authentifiziert.
-
Funktionieren andere Adobe-Funktionen wie bisher?
Alle Adobe Pass-Authentifizierungsfunktionen funktionieren wie zuvor.
-
Gibt es auf der Roku-Plattform einen Opt-in-/Opt-out-Prozess für Programmierer, die von SSO profitieren?
Dies ist eine Konfigurationsänderung im TVE-Dashboard von Adobe. Jeder Programmierer kann SSO auf der Roku-Plattform für bestimmte Integrationen aktivieren oder deaktivieren.
-
Was sind einige häufige Probleme?
Programmierer sollten sicherstellen, dass ihre aktuellen Implementierungen, die auf Adobes REST-API basieren, Rokus Plattform-SSO nicht behindern.
Nachfolgend finden Sie eine Liste möglicher Probleme und deren Lösung.