Integrationshandbuch für Programmierer programmer-integration-guide
Dieses Integrationshandbuch richtet sich an Inhaltsanbieter (Programmierer), die eine Integration mit der Adobe® Pass-Authentifizierung planen.
In der heutigen digitalen Landschaft können Betrachter jederzeit und überall auf das Internet zugreifen und den Zugriff auf Ihre geschützten Inhalte anfordern. Vielleicht wollen sie eine einmalige Veranstaltung sehen oder die Rechte für eine ganze Fernsehserie, die sie gerade ausstrahlen, einholen.
Bevor Sie Zugriff auf geschützte Inhalte gewähren, müssen Sie feststellen, ob der Viewer dazu berechtigt ist. Zu den wichtigsten Fragen gehören:
- Hat der Betrachter ein aktives Abonnement bei einem Mehrkanal-Videoprogrammierungsverteiler (MVPD)?
- Enthält dieses Abonnement Ihre Programmierung?
Adobe Pass-Authentifizierung für TV Everywhere adobe-pass-authentication-for-tv-everywhere
Für Programmierer ist die Bestimmung von Berechtigungen nicht immer einfach. MVPDs sind die Verwahrer der Identifizierungsdaten und Zugriffsberechtigungen ihrer Kunden. Erschwerend kommt hinzu, dass Programmierer und Zuschauer eine Vielzahl von MVPDs abonnieren können, von denen jedes mit einzigartigen Systemen arbeitet. Aufgrund dieser Komplexität ist die Überprüfung von Berechtigungen sowohl technisch schwierig als auch ressourcenintensiv.
Benutzerberechtigungen, die direkt vom Programmierer bestimmt werden
Die Adobe Pass-Authentifizierung erleichtert auf sichere Weise Berechtigungstransaktionen zwischen Programmierern und MVPDs, wodurch die Bereitstellung geschützter Inhalte für geeignete Betrachter schnell, einfach und sicher ist.
Benutzerberechtigung vermittelt durch Adobe Pass-Authentifizierung
Die Adobe Pass-Authentifizierung dient als Proxy und erleichtert den Berechtigungsfluss zwischen Programmierern und MVPDs, indem sie sichere und konsistente Schnittstellen für beide Parteien bietet.
Für Programmierer stellt die Adobe Pass-Authentifizierung APIs als Teil einer Standard- oder Premium-Ebene bereit:
-
Standard-APIs zur Adobe Pass-Authentifizierung:
-
Premium Adobe Pass-Authentifizierungs-APIs:
Anwendungsfälle use-cases
In diesem Abschnitt werden die von der Adobe Pass-Authentifizierung unterstützten Anwendungsfälle für die Programmierer-Integration näher erläutert:
-
Programmieranwendung (TVE) mit einem Einkanalnetz
Dadurch kann der Programmierer den Zuschauern innerhalb einer TVE-Anwendung den Zugriff auf die Inhalte über ein Single-Branded-Kanalnetzwerk ermöglichen.
-
Programmieranwendung (TVE) mit Mehrkanalnetzen
Dadurch kann der Programmierer den Zuschauern innerhalb einer TVE-Anwendung Zugriff auf die Inhalte aus mehreren Kanalnetzen gewähren.
-
Programmierprogramm (TVE) für spezielle Ereignisse
Dadurch kann der Programmierer Betrachtern Zugriff auf den Inhalt spezieller Ereignisse gewähren, bei denen es sich möglicherweise nicht um Ressourcen handelt, die sich wie normale Kanäle in der MVPD-Berechtigungsdatenbank befinden.
Berechtigungsfluss entitlement-flow
Der Berechtigungsfluss ist eine Reihe von Schritten, die ein Programmierprogramm (TVE) durchführen muss, um geschützte Inhalte zu streamen. Der Fluss besteht aus den folgenden Phasen:
Beim ersten Besuch eines Benutzers bei einem Programmierer-Programm (TVE) folgt der Berechtigungsfluss der beschriebenen Reihenfolge. Bei nachfolgenden Besuchen kann die Anwendung jedoch bestimmte Schritte umgehen, die vom Status der Registrierung oder Authentifizierung und den geltenden Anzeigerichtlinien abhängen.
Um eine detaillierte Untersuchung des Berechtigungsflusses und seiner Phasen zu erhalten, lesen Sie dieses Dokument weiter und lesen Sie anschließend die zugehörigen Cookbook-Handbücher, um weitere Einblicke zu erhalten:
Registrierungsphase registration-phase
In der Registrierungsphase wird die Client-Anwendung über den DCR-Prozess (Dynamic Client Registration für die Adobe Pass-Authentifizierung.
Für den Prozess der dynamischen Client-Registrierung (DCR) muss die Client-Anwendung ein Paar von Client-Anmeldeinformationen abrufen und ein Zugriffstoken als Endziel der Registrierungsphase abrufen.
APIs
Flows
FAQs
Konfigurationsphase configuration-phase
Die Konfigurationsphase dient dazu, der Client-Anwendung die Liste der MVPDs bereitzustellen, mit denen sie aktiv integriert ist, sowie die Konfigurationsdetails, die von der Adobe Pass-Authentifizierung für jede MVPD gespeichert wurden.
Die Konfigurationsphase dient als erforderlicher Schritt für die Authentifizierungsphase, wenn das Client-Programm den Benutzer bzw. die Benutzerin auffordern muss, seinen/ihren TV-Anbieter auszuwählen.
APIs
FAQs
Authentifizierungsphase authentication-phase
In der Authentifizierungsphase soll die Client-Anwendung die Möglichkeit erhalten, die Identität des Benutzers mit der MVPD zu überprüfen und Informationen zu Benutzermetadaten abzurufen.
Die Authentifizierungsphase fungiert als erforderlicher Schritt für die Vorautorisierungsphase oder Autorisierungsphase, wenn die Client-Anwendung Inhalte wiedergeben muss.
Bei erfolgreicher Authentifizierung wird ein Profil generiert, das mit der Anwendung, dem Gerät und dem Dienstleister verknüpft ist und auch Informationen zu Benutzermetadaten enthält.
Allgemeine Schritte
In den folgenden Schritten werden die allgemeinen Schritte für den Fall einer SAML-Integration beschrieben:
-
Laden der Anwendung (Website) des Programmierers
Der/die Benutzende navigiert zur Programmieranwendung (Website), die die Adobe Pass-Authentifizierung (-API V2). -
Geschützte Inhaltsanfrage
Wenn Benutzende versuchen, auf geschützte Inhalte zuzugreifen, zeigt die Anwendung des Programmierers eine Liste von MVPDs an, aus denen die Benutzenden auswählen können. -
Initialisierung der Authentifizierungsanfrage
Nach Auswahl von MVPD wird der Benutzer an einen Adobe Pass-Authentifizierungsserver umgeleitet. Hier wird im Falle einer SAML-Integration eine verschlüsselte SAML-Authentifizierungsanfrage für den ausgewählten MVPD generiert. Diese Anfrage wird im Namen des Programmierers an die MVPD gesendet. Je nach System von MVPD wird der Browser des Benutzers entweder zur Anmeldeseite von MVPD umgeleitet oder ein Anmelde-iFrame ist in die Anwendung des Programmierers eingebettet. -
MVPD-Anmeldung
Der MVPD akzeptiert die Anfrage und stellt seine Anmeldeschnittstelle bereit, entweder über Umleitung oder iFrame. -
Benutzeranmeldung und -validierung
Der Benutzer meldet sich mit seinen MVPD-Anmeldeinformationen an. MVPD überprüft den Abonnementstatus des Benutzers und richtet eine eigene HTTP-Sitzung ein. -
MVPD-Antwort auf Adobe Pass-Authentifizierung
Nach Abschluss der Validierung generiert der MVPD eine SAML-Antwort (verschlüsselt) und sendet sie zurück an die Adobe Pass-Authentifizierung. -
Profilgenerierung
Die Adobe Pass-Authentifizierung überprüft die SAML-Antwort, generiert ein Benutzerprofil, das zwischengespeichert wird, und leitet den Benutzer zurück zur Anwendung des Programmierers (Website).
APIs
Flows
- Grundlegender Authentifizierungsfluss innerhalb der primären Anwendung
- Grundlegender Authentifizierungsfluss innerhalb der sekundären Anwendung
- Fluss von grundlegenden Profilen, der in der primären Anwendung ausgeführt wird
- Fluss der grundlegenden Profile, der in der sekundären Anwendung ausgeführt wird
FAQs
Single Sign-On (SSO) single-sign-on
APIs
Flows
(Optional) Phase vor der Autorisierung preauthorization-phase
Der Zweck der Vorautorisierungsphase besteht darin, der Client-Anwendung die Möglichkeit zu geben, eine Untergruppe von Ressourcen aus ihrem Katalog darzustellen, auf die der Benutzer zugreifen könnte.
Die Vorautorisierungsphase kann das Benutzererlebnis verbessern, wenn der Benutzer die Client-Anwendung zum ersten Mal öffnet oder zu einem neuen Abschnitt navigiert.
APIs
Flows
FAQs
Autorisierungsphase authorization-phase
In der Autorisierungsphase soll der Client-Anwendung die Möglichkeit gegeben werden, die von den Benutzenden angeforderten Ressourcen abzuspielen, nachdem ihre Rechte bei der MVPD validiert wurden.
Bei erfolgreicher Autorisierung wird eine Entscheidung generiert, die auch ein Medien-Token enthält, das dem Programmierprogramm (TVE) zu Sicherheitszwecken bereitgestellt wird.
Allgemeine Schritte
Die folgenden Schritte beschreiben die allgemeinen Schritte:
-
Umgang mit Ressourcenkennungen
Der geschützte Inhalt wird durch eine Ressourcenkennung“ identifiziert die eine einfache Zeichenfolge oder eine komplexere Struktur sein kann. Diese Kennung ist vordefiniert und wird vom Programmierer und der MVPD vereinbart. Die Anwendung des Programmierers sendet die Ressourcenkennung an die Adobe Pass-Authentifizierung REST API V2. -
MVPD-Autorisierungsprüfung
Der Adobe Pass-Authentifizierungsserver kommuniziert mithilfe standardisierter Protokolle mit dem Autorisierungsendpunkt von MVPD. -
MVPD-Antwort auf Adobe Pass-Authentifizierung
Nach Abschluss der Validierung bestätigt der MVPD, dass der Benutzer berechtigt ist (oder nicht), auf den Inhalt zuzugreifen, und sendet eine Antwort zurück an die Adobe Pass-Authentifizierung. -
Generieren von Entscheidungs- und Medien-Token
Die Adobe Pass-Authentifizierung überprüft die Antwort, generiert eine Entscheidung die zwischengespeichert wird und gibt die Entscheidung mit einem Medien-Token zurück an die Anwendung des Programmierers (Website). -
Überprüfung des Inhaltszugriffs
Das Programm des Programmierers verwendet den Media Token Verifier um zu bestätigen, dass der richtige Benutzer auf den richtigen Inhalt zugreift. Nach der Validierung erhält der Benutzer Zugriff, um die geschützten Inhalte anzuzeigen.
APIs
Flows
FAQs
Abmeldephase logout-phase
Die Abmeldephase soll der Client-Anwendung die Möglichkeit geben, das authentifizierte Benutzerprofil innerhalb der Adobe Pass-Authentifizierung auf Benutzeranfrage zu beenden.
APIs
Flows
FAQs
Single Logout (SLO) single-logout
Flows
Grundlegendes zu Berechtigungen understanding-entitlements
Die Adobe Pass-Authentifizierungslösung umfasst die Erstellung von Berechtigungen - spezifische Datenelemente, die nach erfolgreichem Abschluss der Authentifizierungs- und Autorisierungs-Workflows generiert werden. Diese Berechtigungen gewähren Zugriff auf geschützte Inhalte, haben jedoch eine begrenzte Lebensdauer. Sobald eine Berechtigung abläuft, muss sie erneuert werden, indem die Authentifizierungs- oder Autorisierungsprozesse erneut initiiert werden.
Weitere Informationen zu Berechtigungen finden Sie in den folgenden Dokumenten:
-
Profile
Bei erfolgreicher Authentifizierung erstellt die Adobe Pass-Authentifizierung ein authentifiziertes Profil („langlebig„), das mit der ID der anfragenden Anwendung, des Geräts und des Dienstleisters (Anfordererkennung) verknüpft ist.
-
Nach erfolgreicher Authentifizierung (und in einigen Fällen auch nach der Autorisierung) empfängt die Adobe Pass-Authentifizierung Benutzermetadaten von der MVPD, die sie für die anfragende Anwendung verfügbar machen.
-
Nach erfolgreicher Autorisierung erstellt die Adobe Pass-Authentifizierung eine Autorisierungsentscheidung („langlebig„), die mit der anfragenden Anwendung, dem Gerät, der Kennung des Dienstleisters (Anfordererkennung) und einer bestimmten geschützten Ressource (Ressourcenkennung) verknüpft ist.
-
Nach erfolgreicher Autorisierung erstellt die Adobe Pass-Authentifizierung ein Medien-Token („kurzlebig„), das mit einer erfolgreichen Wiedergabeanfrage verknüpft ist, und bietet Unterstützung für Best Practices der Branche zur Risikominderung (z. B. Stream-Ripping).
Die TTL-Werte (Time-to-Live) für Profile und Entscheidungen werden auf der Grundlage von Vereinbarungen zwischen Programmierern und Pay-TV-Anbietern festgelegt, die sich auf einen Wert einigen, der allen Beteiligten am besten dient.