Temporäre Zugriffsflüsse
- Themen:
- Authentifizierung
Mit TempPass können Programmierer temporären Zugriff auf ihre geschützten Inhalte gewähren, ohne die Benutzer zur Authentifizierung mit einem gültigen MVPD-Konto aufzufordern.
Weitere Informationen zur TempPass-Funktion finden Sie in der Dokumentation TempPass.
Temporäre Zugriffsflüsse ermöglichen die Abfrage für die folgenden Szenarien:
- Abrufen von Autorisierungsentscheidungen mit einfachem TempPass
- Abrufen von Autorisierungsentscheidungen mithilfe von Werbe-TempPass
- Maximale Ressourcenanzahl mit Werbe-TempPass verbrauchen
- Abrufen von Autorisierungsentscheidungen bei Ablauf von Standard- oder Promotion-TempPass
- Profil für einfache TempPass-Funktion abrufen
- Profil für Werbe-TempPass abrufen
Abrufen von Autorisierungsentscheidungen mit einfachem TempPass
Voraussetzungen
Stellen Sie vor dem Abrufen von Autorisierungsentscheidungen mit Basic TempPass sicher, dass die folgenden Voraussetzungen erfüllt sind:
- Die Streaming-Anwendung möchte einen temporären Zugriff bereitstellen, um Inhalte wiederzugeben, ohne den Benutzer zur Authentifizierung aufzufordern.
- Die Streaming-Anwendung muss eine Autorisierungsentscheidung abrufen, bevor eine vom Benutzer ausgewählte Ressource wiedergegeben wird.
- Es muss eine gültige Konfigurationseinstellung von Basic TempPass vorhanden sein, die auf die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
angewendet wird. - Die für „Basic TempPass“ konfigurierte Time-to-Live (TTL) ist noch nicht abgelaufen.
Workflow
Führen Sie die angegebenen Schritte aus, um den Autorisierungsfluss mit einfachem TempPass zu implementieren, wie im folgenden Diagramm dargestellt.
Abrufen von Autorisierungsentscheidungen mit einfachem TempPass
-
Autorisierungsentscheidung abrufen: Die Streaming-Anwendung erfasst alle erforderlichen Daten, um eine Autorisierungsentscheidung für eine bestimmte Ressource zu erhalten, indem sie den Decisions Authorize-Endpunkt aufruft.
IMPORTANT
Weitere Informationen zu folgenden Themen finden in der APIDokumentation zum Abrufen von Autorisierungsentscheidungen mithilfe bestimmter MVPD:- Alle erforderlichen Parameter wie
serviceProvider
,mvpd
undresources
- Alle erforderlichen Kopfzeilen wie
Authorization
undAP-Device-Identifier
- Alle optionalen Parameter und Kopfzeilen
- Alle erforderlichen Parameter wie
-
Einfache TempPass validieren: Der Adobe Pass-Server überprüft, ob eine gültige Konfigurationseinrichtung von einfachem TempPass vorhanden ist, die auf die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
angewendet wird. -
Rückgabe
Permit
Entscheidung mit Medien-Token: Die Endpunktantwort „Entscheidungen autorisieren“ enthält einePermit
Entscheidung und ein Medien-Token.IMPORTANT
Weitere Informationen zu den in einer Entscheidungsantwort bereitgestellten Informationen finden Sie in der APIDokumentation zum Abrufen von Autorisierungsentscheidungen mithilfe einer bestimmten mvpd.Der Decisions-Autorisierungs-Endpunkt validiert die Anfragedaten, um sicherzustellen, dass grundlegende Bedingungen erfüllt werden:- Die erforderlichen Parameter und Kopfzeilen müssen gültig sein.
- Die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
muss aktiv sein.
Wenn die einfache Validierung fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehlercodes bereitstellt.Der Endpunkt Decisions-Autorisierung verwendet die Anfragedaten, um zu überprüfen, ob temporäre Zugriffsbedingungen erfüllt sind:- Die für den grundlegenden TempPass konfigurierte Time-to-Live (TTL) darf nicht abgelaufen sein.
Wenn die Validierung des temporären Zugriffs fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehler-Codes bereitstellt. -
Stream mit Medien-Token starten: Die Streaming-Anwendung verwendet das Medien-Token, um den Inhalt wiederzugeben.
Abrufen von Autorisierungsentscheidungen mithilfe von Werbe-TempPass
Voraussetzungen
Stellen Sie vor dem Abrufen von Autorisierungsentscheidungen mit dem Werbe-TempPass sicher, dass die folgenden Voraussetzungen erfüllt sind:
- Die Streaming-Anwendung möchte einen temporären Zugriff bereitstellen, um eine maximale Anzahl von Ressourcen abzuspielen, ohne den Benutzer zur Authentifizierung aufzufordern.
- Die Streaming-Anwendung muss beim Abrufen einer Autorisierungsentscheidung eindeutige Informationen zur Identität des Benutzers enthalten.
- Die Streaming-Anwendung muss eine Autorisierungsentscheidung abrufen, bevor eine vom Benutzer ausgewählte Ressource wiedergegeben wird.
- Es muss eine gültige Konfigurationseinrichtung für den temporären Werbepass vorhanden sein, die auf die Integration zwischen der bereitgestellten
serviceProvider
undmvpd
angewendet wird. - Die für den Werbe-TempPass konfigurierte Time-to-Live (TTL) ist noch nicht abgelaufen.
- Die maximale Anzahl von Ressourcen, die für den Werbe-TempPass konfiguriert sind, wurde nicht verbraucht.
Workflow
Führen Sie die angegebenen Schritte aus, um den Autorisierungsfluss mithilfe von Promotion-TempPass zu implementieren, wie im folgenden Diagramm dargestellt.
Abrufen von Autorisierungsentscheidungen mithilfe von Werbe-TempPass
-
Autorisierungsentscheidung abrufen: Die Streaming-Anwendung erfasst alle erforderlichen Daten, um eine Autorisierungsentscheidung für eine bestimmte Ressource zu erhalten, indem sie den Decisions Authorize-Endpunkt aufruft.
IMPORTANT
Weitere Informationen zu folgenden Themen finden in der APIDokumentation zum Abrufen von Autorisierungsentscheidungen mithilfe bestimmter MVPD:- Alle erforderlichen Parameter wie
serviceProvider
,mvpd
undresources
- Alle erforderlichen Kopfzeilen wie
Authorization
undAP-Device-Identifier
- Alle optionalen Parameter und Kopfzeilen
Der Endpunkt Decisions Authorize erfordert bei Verwendung von Werbe-TempPass das VorhandenseinAP-TempPass-Identity
-Headers. Die Kopfzeile enthält eindeutige Informationen über die Identität des Benutzers, der auf den Inhalt zugreift.Weitere Informationen zuAP-TempPass-Identity
-Header finden Sie in der Dokumentation AP-TempPass-Identity. - Alle erforderlichen Parameter wie
-
Promotion-TempPass validieren: Der Adobe Pass-Server überprüft, ob eine gültige Konfigurationseinrichtung für Promotion-TempPass vorhanden ist, die auf die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
angewendet wird. -
Rückgabe
Permit
Entscheidung mit Medien-Token: Die Endpunktantwort „Entscheidungen autorisieren“ enthält einePermit
Entscheidung und ein Medien-Token.IMPORTANT
Weitere Informationen zu den in einer Entscheidungsantwort bereitgestellten Informationen finden Sie in der APIDokumentation zum Abrufen von Autorisierungsentscheidungen mithilfe einer bestimmten mvpd.Der Decisions-Autorisierungs-Endpunkt validiert die Anfragedaten, um sicherzustellen, dass grundlegende Bedingungen erfüllt werden:- Die erforderlichen Parameter und Kopfzeilen müssen gültig sein.
- Die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
muss aktiv sein.
Wenn die einfache Validierung fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehlercodes bereitstellt.Der Endpunkt Decisions-Autorisierung verwendet die Anfragedaten, um zu überprüfen, ob temporäre Zugriffsbedingungen erfüllt sind:- Die für den Werbe-TempPass konfigurierte Time-to-Live (TTL) darf nicht abgelaufen sein.
- Die maximale Anzahl von Ressourcen, die für den Werbe-TempPass konfiguriert sind, darf nicht verbraucht werden.
Wenn die Validierung des temporären Zugriffs fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehler-Codes bereitstellt. -
Stream mit Medien-Token starten: Die Streaming-Anwendung verwendet das Medien-Token, um den Inhalt wiederzugeben.
Maximale Ressourcenanzahl mit Werbe-TempPass verbrauchen
Voraussetzungen
Bevor Sie eine maximale Anzahl von Ressourcen mit dem Werbe-TempPass verbrauchen, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:
- Die Streaming-Anwendung möchte einen temporären Zugriff bereitstellen, um eine maximale Anzahl von Ressourcen abzuspielen, ohne den Benutzer zur Authentifizierung aufzufordern.
- Die Streaming-Anwendung muss beim Abrufen einer Autorisierungsentscheidung eindeutige Informationen zur Identität des Benutzers enthalten.
- Die Streaming-Anwendung muss eine Autorisierungsentscheidung abrufen, bevor eine vom Benutzer ausgewählte Ressource wiedergegeben wird.
- Es muss eine gültige Konfigurationseinrichtung für den temporären Werbepass vorhanden sein, die auf die Integration zwischen der bereitgestellten
serviceProvider
undmvpd
angewendet wird. - Die für den Werbe-TempPass konfigurierte Time-to-Live (TTL) ist noch nicht abgelaufen.
- Die maximale Anzahl von Ressourcen, die für den Werbe-TempPass konfiguriert sind, ist 1.
Workflow
Befolgen Sie die angegebenen Schritte, um den Autorisierungsfluss zu implementieren, wenn Sie eine maximale Anzahl von Ressourcen mit dem Werbe-TempPass verbrauchen, wie im folgenden Diagramm dargestellt.
Verwenden Sie die maximale Anzahl von Ressourcen mit dem Werbe-TempPass
-
Profil für Werbe-TempPass abrufen: Die Streaming-Anwendung sammelt alle erforderlichen Daten, um Profilinformationen für Werbe-TempPass abzurufen, indem sie eine Anfrage an den Endpunkt „Profiles“ sendet.
IMPORTANT
Weitere Informationen zu folgenden Themen finden in der APIDokumentation zum Abrufen von Profilen für bestimmte MVPD:- Alle erforderlichen Parameter wie
serviceProvider
undmvpd
- Alle erforderlichen Kopfzeilen wie
Authorization
undAP-Device-Identifier
- Alle optionalen Parameter und Kopfzeilen
Die Abfrage des Profilendpunkts ist optional und kann verwendet werden, um festzustellen, wie viele Ressourcen mit dem Werbe-TempPass noch wiedergegeben werden können. - Alle erforderlichen Parameter wie
-
Promotion-TempPass validieren: Der Adobe Pass-Server überprüft, ob eine gültige Konfigurationseinrichtung für Promotion-TempPass vorhanden ist, die auf die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
angewendet wird. -
Rückgabeinformationen zum temporären Profil: Die Antwort des Endpunkts „Profiles“ enthält Informationen zum temporären Profil, einschließlich des Attributs, das auf „temporär“ festgelegt
type
.IMPORTANT
Weitere Informationen zu in einer Profilantwort angegebenen Informationen finden Sie in der APIDokumentation zum Abrufen von Profilen für bestimmte mvpd.Der Profiles-Endpunkt validiert die Anfragedaten, um sicherzustellen, dass die grundlegenden Bedingungen erfüllt sind:- Die erforderlichen Parameter und Kopfzeilen müssen gültig sein.
- Die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
muss aktiv sein.
Wenn die einfache Validierung fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehlercodes bereitstellt.Der Profilendpunkt verwendet die Anfragedaten, um zu überprüfen, ob temporäre Zugriffsbedingungen erfüllt sind:- Die für den Werbe-TempPass konfigurierte Time-to-Live (TTL) darf nicht abgelaufen sein.
- Die maximale Anzahl von Ressourcen, die für den Werbe-TempPass konfiguriert sind, darf nicht verbraucht werden.
Wenn die Validierung des temporären Zugriffs fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehler-Codes bereitstellt. -
Fahren Sie mit Entscheidungsflüssen fort: Wenn die Antwort des Endpunkts „Profile“ ein Profil enthält, verwendet die Streaming-Anwendung die temporären Profilinformationen, um mit nachfolgenden Entscheidungsflüssen fortzufahren.
-
Autorisierungsentscheidung abrufen: Die Streaming-Anwendung erfasst alle erforderlichen Daten, um eine Autorisierungsentscheidung für eine bestimmte Ressource zu erhalten, indem sie den Decisions Authorize-Endpunkt aufruft.
IMPORTANT
Weitere Informationen zu folgenden Themen finden in der APIDokumentation zum Abrufen von Autorisierungsentscheidungen mithilfe bestimmter MVPD:- Alle erforderlichen Parameter wie
serviceProvider
,mvpd
undresources
- Alle erforderlichen Kopfzeilen wie
Authorization
undAP-Device-Identifier
- Alle optionalen Parameter und Kopfzeilen
Der Endpunkt Decisions Authorize erfordert bei Verwendung von Werbe-TempPass das VorhandenseinAP-TempPass-Identity
-Headers. Die Kopfzeile enthält eindeutige Informationen über die Identität des Benutzers, der auf den Inhalt zugreift.Weitere Informationen zuAP-TempPass-Identity
-Header finden Sie in der Dokumentation AP-TempPass-Identity. - Alle erforderlichen Parameter wie
-
Promotion-TempPass validieren: Der Adobe Pass-Server überprüft, ob eine gültige Konfigurationseinrichtung für Promotion-TempPass vorhanden ist, die auf die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
angewendet wird. -
Rückgabe
Permit
Entscheidung mit Medien-Token: Die Endpunktantwort „Entscheidungen autorisieren“ enthält einePermit
Entscheidung und ein Medien-Token.IMPORTANT
Weitere Informationen zu den in einer Entscheidungsantwort bereitgestellten Informationen finden Sie in der APIDokumentation zum Abrufen von Autorisierungsentscheidungen mithilfe einer bestimmten mvpd.Der Decisions-Autorisierungs-Endpunkt validiert die Anfragedaten, um sicherzustellen, dass grundlegende Bedingungen erfüllt werden:- Die erforderlichen Parameter und Kopfzeilen müssen gültig sein.
- Die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
muss aktiv sein.
Wenn die einfache Validierung fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehlercodes bereitstellt.Der Endpunkt Decisions-Autorisierung verwendet die Anfragedaten, um zu überprüfen, ob temporäre Zugriffsbedingungen erfüllt sind:- Die für den Werbe-TempPass konfigurierte Time-to-Live (TTL) darf nicht abgelaufen sein.
- Die maximale Anzahl von Ressourcen, die für den Werbe-TempPass konfiguriert sind, darf nicht verbraucht werden.
Wenn die Validierung des temporären Zugriffs fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehler-Codes bereitstellt. -
Autorisierungsentscheidung abrufen: Die Streaming-Anwendung erfasst alle erforderlichen Daten, um eine Autorisierungsentscheidung für eine bestimmte Ressource zu erhalten, indem sie den Decisions Authorize-Endpunkt aufruft.
IMPORTANT
Weitere Informationen zu folgenden Themen finden in der APIDokumentation zum Abrufen von Autorisierungsentscheidungen mithilfe bestimmter MVPD:- Alle erforderlichen Parameter wie
serviceProvider
,mvpd
undresources
- Alle erforderlichen Kopfzeilen wie
Authorization
undAP-Device-Identifier
- Alle optionalen Parameter und Kopfzeilen
Der Endpunkt Decisions Authorize erfordert bei Verwendung von Werbe-TempPass das VorhandenseinAP-TempPass-Identity
-Headers. Die Kopfzeile enthält eindeutige Informationen über die Identität des Benutzers, der auf den Inhalt zugreift.Weitere Informationen zuAP-TempPass-Identity
-Header finden Sie in der Dokumentation AP-TempPass-Identity. - Alle erforderlichen Parameter wie
-
Promotion-TempPass validieren: Der Adobe Pass-Server überprüft, ob eine gültige Konfigurationseinrichtung für Promotion-TempPass vorhanden ist, die auf die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
angewendet wird. -
Rückgabe
Deny
Entscheidung mit Details: Die Endpunktantwort „Decisions Authorize“ enthält eineDeny
Entscheidung und eine Fehler-Payload, die der Dokumentation zu Enhanced Error Codes entsprechen.IMPORTANT
Weitere Informationen zu den in einer Entscheidungsantwort bereitgestellten Informationen finden Sie in der APIDokumentation zum Abrufen von Autorisierungsentscheidungen mithilfe einer bestimmten mvpd.Der Decisions-Autorisierungs-Endpunkt validiert die Anfragedaten, um sicherzustellen, dass grundlegende Bedingungen erfüllt werden:- Die erforderlichen Parameter und Kopfzeilen müssen gültig sein.
- Die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
muss aktiv sein.
Wenn die einfache Validierung fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehlercodes bereitstellt.Der Endpunkt Decisions-Autorisierung verwendet die Anfragedaten, um zu überprüfen, ob temporäre Zugriffsbedingungen erfüllt sind:- Die für den Werbe-TempPass konfigurierte Time-to-Live (TTL) darf nicht abgelaufen sein.
- Die maximale Anzahl von Ressourcen, die für den Werbe-TempPass konfiguriert sind, darf nicht verbraucht werden.
Wenn die Validierung des temporären Zugriffs fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehler-Codes bereitstellt. -
Handhabung
Deny
Entscheidungsdetails: Die Streaming-Anwendung verarbeitet die Fehlerinformationen aus der Antwort und kann sie verwenden, um optional eine bestimmte Nachricht auf der Benutzeroberfläche anzuzeigen.TIP
Die Streaming-Anwendung kann Benutzende darüber informieren, dass die maximale Anzahl von Ressourcen überschritten wurde, und ihnen empfehlen, einen einfachen Authentifizierungsfluss mithilfe einer regulären MVPD einzuleiten, um den Überwachungsvorgang fortzusetzen.
Abrufen von Autorisierungsentscheidungen bei Ablauf von Standard- oder Promotion-TempPass
Voraussetzungen
Stellen Sie vor dem Abrufen von Autorisierungsentscheidungen bei Ablauf des Standard- oder Promotion-TempPass sicher, dass die folgenden Voraussetzungen erfüllt sind:
- Es muss eine gültige Konfigurationseinstellung von Basic oder Promotion TempPass vorhanden sein, die auf die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
angewendet wird. - Die Time-to-Live (TTL), die für die Standard- oder Werbeanzeige konfiguriert wurde. Die zeitweilige Zugriffsdauer wurde überschritten.
Workflow
Befolgen Sie die angegebenen Schritte, um den Autorisierungsfluss zu implementieren, wenn der Standard- oder Promotion-TempPass abläuft, wie in der folgenden Abbildung dargestellt.
Abrufen von Autorisierungsentscheidungen bei Ablauf von Standard- oder Promotion-TempPass
-
Autorisierungsentscheidung abrufen: Die Streaming-Anwendung erfasst alle erforderlichen Daten, um eine Autorisierungsentscheidung für eine bestimmte Ressource zu erhalten, indem sie den Decisions Authorize-Endpunkt aufruft.
IMPORTANT
Weitere Informationen zu folgenden Themen finden in der APIDokumentation zum Abrufen von Autorisierungsentscheidungen mithilfe bestimmter MVPD:- Alle erforderlichen Parameter wie
serviceProvider
,mvpd
undresources
- Alle erforderlichen Kopfzeilen wie
Authorization
undAP-Device-Identifier
- Alle optionalen Parameter und Kopfzeilen
Der Endpunkt Decisions Authorize erfordert bei Verwendung von Werbe-TempPass das VorhandenseinAP-TempPass-Identity
-Headers. Die Kopfzeile enthält eindeutige Informationen über die Identität des Benutzers, der auf den Inhalt zugreift.Weitere Informationen zuAP-TempPass-Identity
-Header finden Sie in der Dokumentation AP-TempPass-Identity. - Alle erforderlichen Parameter wie
-
Validieren von Standard- oder Promotion-TempPass: Der Adobe Pass-Server überprüft, ob eine gültige Konfigurationseinrichtung von Standard- oder Promotion-TempPass vorhanden ist, die auf die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
angewendet wird. -
Rückgabe
Deny
Entscheidung mit Details: Die Endpunktantwort „Decisions Authorize“ enthält eineDeny
Entscheidung und eine Fehler-Payload, die der Dokumentation zu Enhanced Error Codes entsprechen.IMPORTANT
Weitere Informationen zu den in einer Entscheidungsantwort bereitgestellten Informationen finden Sie in der APIDokumentation zum Abrufen von Autorisierungsentscheidungen mithilfe einer bestimmten mvpd.Der Decisions-Autorisierungs-Endpunkt validiert die Anfragedaten, um sicherzustellen, dass grundlegende Bedingungen erfüllt werden:- Die erforderlichen Parameter und Kopfzeilen müssen gültig sein.
- Die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
muss aktiv sein.
Wenn die einfache Validierung fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehlercodes bereitstellt.Der Endpunkt Decisions-Autorisierung verwendet die Anfragedaten, um zu überprüfen, ob temporäre Zugriffsbedingungen erfüllt sind:- Die für den Standard- oder Werbe-TempPass konfigurierte Time-to-Live (TTL) darf nicht abgelaufen sein.
- Die maximale Anzahl von Ressourcen, die für den Werbe-TempPass konfiguriert sind, darf nicht verbraucht werden.
Wenn die Validierung des temporären Zugriffs fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehler-Codes bereitstellt. -
Handhabung
Deny
Entscheidungsdetails: Die Streaming-Anwendung verarbeitet die Fehlerinformationen aus der Antwort und kann sie verwenden, um optional eine bestimmte Nachricht auf der Benutzeroberfläche anzuzeigen.TIP
Die Streaming-Anwendung kann Benutzende darüber informieren, dass der temporäre Zugriff abgelaufen ist, und ihnen empfehlen, einen einfachen Authentifizierungsfluss mithilfe einer regulären MVPD einzuleiten, um den Überwachungsvorgang fortzusetzen.
Profil für einfache TempPass-Funktion abrufen
Voraussetzungen
Stellen Sie vor dem Abrufen des Profils für Basic TempPass sicher, dass die folgenden Voraussetzungen erfüllt sind:
- Die Streaming-Anwendung möchte das temporäre Profil abrufen, um sicherzustellen, dass der temporäre Zugriff nicht abgelaufen ist.
- Es muss eine gültige Konfigurationseinstellung von Basic TempPass vorhanden sein, die auf die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
angewendet wird. - Die für den grundlegenden TempPass konfigurierte Time-to-Live (TTL) darf nicht abgelaufen sein.
Workflow
Führen Sie die angegebenen Schritte aus, um den Fluss zum Abrufen von Profilen für einfache TempPass zu implementieren, wie im folgenden Diagramm dargestellt.
Profil für einfachen TempPass abrufen
-
Profil für einfache TempPass abrufen: Die Streaming-Anwendung sammelt alle erforderlichen Daten, um Profilinformationen für einfache TempPass abzurufen, indem sie eine Anfrage an den Endpunkt „Profiles“ sendet.
IMPORTANT
Weitere Informationen zu folgenden Themen finden in der APIDokumentation zum Abrufen von Profilen für bestimmte MVPD:- Alle erforderlichen Parameter wie
serviceProvider
undmvpd
- Alle erforderlichen Kopfzeilen wie
Authorization
undAP-Device-Identifier
- Alle optionalen Parameter und Kopfzeilen
- Alle erforderlichen Parameter wie
-
Einfache TempPass validieren: Der Adobe Pass-Server überprüft, ob eine gültige Konfigurationseinrichtung von einfachem TempPass vorhanden ist, die auf die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
angewendet wird. -
Rückgabeinformationen zum temporären Profil: Die Antwort des Endpunkts „Profiles“ enthält Informationen zum temporären Profil, einschließlich des Attributs, das auf „temporär“ festgelegt
type
.IMPORTANT
Weitere Informationen zu in einer Profilantwort angegebenen Informationen finden Sie in der APIDokumentation zum Abrufen von Profilen für bestimmte mvpd.Der Profiles-Endpunkt validiert die Anfragedaten, um sicherzustellen, dass die grundlegenden Bedingungen erfüllt sind:- Die erforderlichen Parameter und Kopfzeilen müssen gültig sein.
- Die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
muss aktiv sein.
Wenn die einfache Validierung fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehlercodes bereitstellt.Der Profilendpunkt verwendet die Anfragedaten, um zu überprüfen, ob temporäre Zugriffsbedingungen erfüllt sind:- Die für den grundlegenden TempPass konfigurierte Time-to-Live (TTL) darf nicht abgelaufen sein.
Wenn die Validierung des temporären Zugriffs fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehler-Codes bereitstellt. -
Fahren Sie mit Entscheidungsflüssen fort: Wenn die Antwort des Endpunkts „Profile“ ein Profil enthält, verwendet die Streaming-Anwendung die temporären Profilinformationen, um mit nachfolgenden Entscheidungsflüssen fortzufahren.
Profil für Werbe-TempPass abrufen
Voraussetzungen
Stellen Sie vor dem Abrufen des Profils für den Werbe-TempPass sicher, dass die folgenden Voraussetzungen erfüllt sind:
- Die Streaming-Anwendung möchte das temporäre Profil abrufen, um sicherzustellen, dass der temporäre Zugriff nicht abgelaufen ist, oder um zu bestimmen, wie viele Ressourcen noch wiedergegeben werden können.
- Es muss eine gültige Konfigurationseinrichtung für den temporären Werbepass vorhanden sein, die auf die Integration zwischen der bereitgestellten
serviceProvider
undmvpd
angewendet wird. - Die für den Werbe-TempPass konfigurierte Time-to-Live (TTL) ist noch nicht abgelaufen.
- Die maximale Anzahl von Ressourcen, die für den Werbe-TempPass konfiguriert sind, wurde nicht verbraucht.
Workflow
Führen Sie die angegebenen Schritte aus, um den Fluss zum Abrufen von Profilen für den Werbe-TempPass zu implementieren, wie in der folgenden Abbildung dargestellt.
Profil für Werbe-TempPass abrufen
-
Profil für Werbe-TempPass abrufen: Die Streaming-Anwendung sammelt alle erforderlichen Daten, um Profilinformationen für Werbe-TempPass abzurufen, indem sie eine Anfrage an den Endpunkt „Profiles“ sendet.
IMPORTANT
Weitere Informationen zu folgenden Themen finden in der APIDokumentation zum Abrufen von Profilen für bestimmte MVPD:- Alle erforderlichen Parameter wie
serviceProvider
undmvpd
- Alle erforderlichen Kopfzeilen wie
Authorization
undAP-Device-Identifier
- Alle optionalen Parameter und Kopfzeilen
- Alle erforderlichen Parameter wie
-
Promotion-TempPass validieren: Der Adobe Pass-Server überprüft, ob eine gültige Konfigurationseinrichtung für Promotion-TempPass vorhanden ist, die auf die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
angewendet wird. -
Rückgabeinformationen zum temporären Profil: Die Antwort des Endpunkts „Profiles“ enthält Informationen zum temporären Profil, einschließlich des Attributs, das auf „temporär“ festgelegt
type
.IMPORTANT
Weitere Informationen zu in einer Profilantwort angegebenen Informationen finden Sie in der APIDokumentation zum Abrufen von Profilen für bestimmte mvpd.Der Profiles-Endpunkt validiert die Anfragedaten, um sicherzustellen, dass die grundlegenden Bedingungen erfüllt sind:- Die erforderlichen Parameter und Kopfzeilen müssen gültig sein.
- Die Integration zwischen den bereitgestellten
serviceProvider
undmvpd
muss aktiv sein.
Wenn die einfache Validierung fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehlercodes bereitstellt.Der Profilendpunkt verwendet die Anfragedaten, um zu überprüfen, ob temporäre Zugriffsbedingungen erfüllt sind:- Die für den Werbe-TempPass konfigurierte Time-to-Live (TTL) darf nicht abgelaufen sein.
- Die maximale Anzahl von Ressourcen, die für den Werbe-TempPass konfiguriert sind, darf nicht verbraucht werden.
Wenn die Validierung des temporären Zugriffs fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehler-Codes bereitstellt. -
Fahren Sie mit Entscheidungsflüssen fort: Wenn die Antwort des Endpunkts „Profile“ ein Profil enthält, verwendet die Streaming-Anwendung die temporären Profilinformationen, um mit nachfolgenden Entscheidungsflüssen fortzufahren.