DokumentationAdobe PassAdobe Pass-Authentifizierung

Grundlegender Abmeldefluss innerhalb der primären Anwendung

20. Dezember 2024
  • Themen:
  • Authentifizierung
IMPORTANT
Der Inhalt dieser Seite dient nur zu Informationszwecken. Die Verwendung dieser API erfordert eine aktuelle Lizenz von Adobe. Eine unbefugte Nutzung ist nicht zulässig.
IMPORTANT
Die REST-API-V2-Implementierung ist an die Dokumentation Drosselungsmechanismus gebunden.

Mit dem Abmeldefluss innerhalb der Adobe Pass-Authentifizierungsberechtigung kann die Streaming-Anwendung zwei Hauptschritte ausführen:

  • Löschen der im Adobe Pass-Backend gespeicherten Standardprofile.
  • Navigieren Sie mit einem Benutzeragenten (Browser) zum Abmelde-Endpunkt von MVPD und lösen Sie eine Bereinigung im MVPD-Backend aus.

Mit dem einfachen Abmeldefluss können Sie Abfragen für die folgenden Szenarien durchführen:

  • Starten des Abmeldens für ein bestimmtes MVPD mit dem Abmeldeendpunkt
  • Starten des Abmeldens für einen bestimmten MVPD ohne Abmeldeendpunkt

Initiieren des Abmeldens für ein bestimmtes MVPD mit Abmeldeendpunkt

Voraussetzungen

Bevor Sie mit dem Abmelden für eine bestimmte MVPD mit einem Abmeldeendpunkt beginnen, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

  • Die Streaming-Anwendung muss über ein gültiges reguläres Profil verfügen, das mithilfe eines der grundlegenden Authentifizierungsflüsse erfolgreich für die MVPD erstellt wurde:

    • Authentifizierung innerhalb der primären Anwendung durchführen
    • Authentifizierung innerhalb der sekundären Anwendung mit vorab ausgewähltem mvpd durchführen
    • Authentifizierung innerhalb der sekundären Anwendung ohne vorab ausgewählte mvpd durchführen

  • Die Streaming-Anwendung muss den Abmeldefluss initiieren, wenn sie sich von der MVPD abmelden muss.

IMPORTANT
Annahmen
  • Die MVPD unterstützt den Abmeldefluss und verfügt über einen Abmeldeendpunkt.

Workflow

Führen Sie die angegebenen Schritte aus, um den grundlegenden Abmeldefluss für eine bestimmte MVPD mit einem Abmelde-Endpunkt zu implementieren, der in einer primären Anwendung ausgeführt wird, wie im folgenden Diagramm dargestellt.

Initiieren des Abmeldens für bestimmte MVPDs mit dem Abmeldeendpunkt

Initiieren des Abmeldens für bestimmte MVPDs mit dem Abmeldeendpunkt

  1. Adobe Pass-Abmeldung initiieren: Die Streaming-Anwendung sammelt alle erforderlichen Daten, um den Abmeldefluss zu initiieren, indem sie den Adobe Pass-Abmelde-Endpunkt aufruft.

    IMPORTANT
    Weitere Informationen zu folgenden Themen finden Sie in API-DokumentationInitiieren des Abmeldens für bestimmte MVPD:
    • Alle erforderlichen Parameter wie serviceProvider, mvpd und redirectUrl
    • Alle erforderlichen Kopfzeilen wie Authorization, AP-Device-Identifier
    • Alle optionalen Parameter und Kopfzeilen

  2. Reguläres Profil suchen: Der Adobe Pass-Server identifiziert ein gültiges Profil anhand der empfangenen Parameter und Kopfzeilen.

  3. Reguläres Profil löschen: Der Adobe Pass-Server löscht das identifizierte reguläre Profil aus dem Adobe Pass-Backend.

  4. Nächste Aktion angeben: Die Antwort des Abmeldeendpunkts von Adobe Pass enthält die erforderlichen Daten, um die Streaming-Anwendung bezüglich der nächsten Aktion zu führen:

    • Das url-Attribut ist vorhanden, da die MVPD den Abmeldefluss unterstützt.
    • Das actionName-Attribut ist auf „logout“ festgelegt.
    • Das actionType-Attribut ist auf „interaktiv“ festgelegt.
    IMPORTANT
    Weitere Informationen zu den in einer Abmeldeantwort enthaltenen Informationen finden Sie in der APIDokumentation zum Initiieren des Abmeldens für bestimmte mvpd.
    Der Adobe Pass-Abmeldeendpunkt 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 und mvpd muss aktiv sein.
    Wenn die Validierung fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehlercodes bereitstellt.

  5. MVPD-Abmeldung initiieren: Die Streaming-Anwendung liest die url und verwendet einen Benutzeragenten, um den Abmeldefluss mit der MVPD zu initiieren. Der Fluss kann mehrere Umleitungen zu MVPD-Systemen umfassen. Das Ergebnis ist jedoch, dass MVPD seine interne Bereinigung durchführt und die endgültige Abmeldebestätigung zurück an das Adobe Pass-Backend sendet.

  6. Abmeldevorgang abgeschlossen anzeigen: Die Streaming-Anwendung kann warten, bis der Benutzeragent das bereitgestellte redirectUrl erreicht, und sie als Signal verwenden, um optional eine bestimmte Nachricht auf der Benutzeroberfläche anzuzeigen.

Starten des Abmeldens für einen bestimmten MVPD ohne Abmeldeendpunkt

Voraussetzungen

Bevor Sie mit dem Abmelden für eine bestimmte MVPD ohne Abmeldeendpunkt beginnen, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

  • Die Streaming-Anwendung muss über ein gültiges reguläres Profil verfügen, das mithilfe eines der grundlegenden Authentifizierungsflüsse erfolgreich für die MVPD erstellt wurde:

    • Authentifizierung innerhalb der primären Anwendung durchführen
    • Authentifizierung innerhalb der sekundären Anwendung mit vorab ausgewähltem mvpd durchführen
    • Authentifizierung innerhalb der sekundären Anwendung ohne vorab ausgewählte mvpd durchführen

  • Die Streaming-Anwendung muss den Abmeldefluss initiieren, wenn sie sich von der MVPD abmelden muss.

IMPORTANT
Annahmen
  • Die MVPD unterstützt den Abmeldefluss nicht und verfügt über keinen Abmeldeendpunkt.

Workflow

Führen Sie die angegebenen Schritte aus, um den grundlegenden Abmeldefluss für einen bestimmten MVPD ohne Abmeldeendpunkt in einer Primäranwendung zu implementieren, wie im folgenden Diagramm dargestellt.

Initiieren der Abmeldung für eine bestimmte mvpd ohne Abmeldeendpunkt

Initiieren der Abmeldung für eine bestimmte mvpd ohne Abmeldeendpunkt

  1. Adobe Pass-Abmeldung initiieren: Die Streaming-Anwendung sammelt alle erforderlichen Daten, um den Abmeldefluss zu initiieren, indem sie den Adobe Pass-Abmelde-Endpunkt aufruft.

    IMPORTANT
    Weitere Informationen zu folgenden Themen finden Sie in API-DokumentationInitiieren des Abmeldens für bestimmte MVPD:
    • Alle erforderlichen Parameter wie serviceProvider, mvpd und redirectUrl
    • Alle erforderlichen Kopfzeilen wie Authorization, AP-Device-Identifier
    • Alle optionalen Parameter und Kopfzeilen

  2. Reguläres Profil suchen: Der Adobe Pass-Server identifiziert ein gültiges Profil anhand der empfangenen Parameter und Kopfzeilen.

  3. Reguläres Profil löschen: Der Adobe Pass-Server löscht das identifizierte reguläre Profil.

  4. Nächste Aktion angeben: Die Antwort des Abmeldeendpunkts von Adobe Pass enthält die erforderlichen Daten, um die Streaming-Anwendung bezüglich der nächsten Aktion zu führen:

    • Das url fehlt, da die MVPD den Abmeldefluss nicht unterstützt.
    • Das actionName-Attribut wird auf „complete“ gesetzt.
    • Das actionType-Attribut ist auf „none“ festgelegt.
    IMPORTANT
    Weitere Informationen zu den in einer Abmeldeantwort enthaltenen Informationen finden Sie in der APIDokumentation zum Initiieren des Abmeldens für bestimmte mvpd.
    Der Adobe Pass-Abmeldeendpunkt 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 und mvpd muss aktiv sein.
    Wenn die Validierung fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehlercodes bereitstellt.

  5. Abmelde-Abschluss angeben: Die Streaming-Anwendung verarbeitet die Antwort und kann sie verwenden, um optional eine bestimmte Nachricht auf der Benutzeroberfläche anzuzeigen.

recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b