DokumentationAdobe PassAdobe Pass-Authentifizierung

Grundlegender Authentifizierungsfluss innerhalb der primären Anwendung basic-authentication-flow-performed-within-primary-application

Last update: Mon Apr 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
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.
Related Articles
Stellen Sie sicher, dass Sie auch die häufig gestellten Fragen REST API V2 besuchen.

Mit dem Authentifizierungsfluss innerhalb der Adobe Pass-Authentifizierungsberechtigung kann die Streaming-Anwendung überprüfen, ob ein Benutzer über ein gültiges MVPD-Konto verfügt. Für diesen Vorgang muss der Benutzer über ein gültiges MVPD-Konto verfügen und gültige Anmeldeinformationen auf der MVPD-Anmeldeseite eingeben.

Der Authentifizierungsfluss ist in den folgenden Fällen erforderlich:

  • Wenn der/die Benutzende eine Anwendung zum ersten Mal öffnet.
  • Wenn die vorherige Authentifizierung des Benutzers abgelaufen ist.
  • Wenn sich der Benutzer beim MVPD-Konto abmeldet.
  • Wenn sich der/die Benutzende mit einer anderen MVPD authentifizieren möchte.

In all diesen Fällen erhält die Anwendung, die einen der Profile-Endpunkte aufruft, eine leere Antwort oder ein oder mehrere Profile, jedoch für verschiedene MVPDs.

Der Authentifizierungsfluss erfordert, dass ein Benutzeragent (Browser) eine Reihe von Aufrufen vom Programm an das Adobe Pass-Backend, dann an die MVPD-Anmeldeseite und schließlich zurück an die Anwendung ausführt. Dieser Fluss kann mehrere Umleitungen zu MVPD-Systemen und die Verwaltung von Cookies oder Sitzungen für jede Domain umfassen, was ohne Benutzeragenten schwierig zu erreichen und zu schützen ist.

Basierend auf den Funktionen der Primäranwendung (Streaming-Anwendung) zur Unterstützung der Benutzerinteraktion zur Auswahl einer MVPD und zur Authentifizierung mit der ausgewählten MVPD in einem Benutzeragenten lauten die Authentifizierungsszenarien wie folgt:

Authentifizierung innerhalb der primären Anwendung durchführen perform-authentication-within-primary-application

Voraussetzungen prerequisites-perform-authentication-within-primary-application

Bevor Sie eine Authentifizierung über Benutzerinteraktion in einer primären Anwendung durchführen, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

  • Die Streaming-Anwendung muss eine MVPD auswählen.
  • Die Streaming-Anwendung muss eine Authentifizierungssitzung starten, um sich mit der ausgewählten MVPD anzumelden.
  • Die Streaming-Anwendung muss sich mit der ausgewählten MVPD in einem Benutzeragenten authentifizieren.
IMPORTANT
Annahmen
  • Die Streaming-Anwendung unterstützt Benutzerinteraktionen bei der Auswahl einer MVPD.
  • Die Streaming-Anwendung unterstützt Benutzerinteraktionen zur Authentifizierung bei der ausgewählten MVPD in einem Benutzeragenten.

Workflow workflow-perform-authentication-completed-on-primary-application

Führen Sie die angegebenen Schritte aus, um den grundlegenden Authentifizierungsfluss zu implementieren, der in einer primären Anwendung ausgeführt wird, wie im folgenden Diagramm dargestellt.

Authentifizierung innerhalb der primären Anwendung durchführen

Authentifizierung innerhalb der primären Anwendung durchführen

  1. Authentifizierungssitzung erstellen: Die Streaming-Anwendung erfasst alle erforderlichen Daten, um eine Authentifizierungssitzung zu initiieren, indem der Sessions-Endpunkt aufgerufen wird.

    note important
    IMPORTANT
    Weitere Informationen zu folgenden Themen finden in der APIDokumentation zu „Authentifizierungssitzung erstellen“:
    • Alle erforderlichen Parameter wie serviceProvider, mvpd, domainName und redirectUrl
    • Alle erforderlichen Kopfzeilen wie Authorization, AP-Device-Identifier
    • Alle optionalen Parameter und Kopfzeilen
    Die Streaming-Anwendung muss beim Erstellen der Authentifizierungssitzung in einem einzigen Aufruf alle erforderlichen Parameter bereitstellen.

  2. Nächste Aktion angeben: Die Antwort des Sitzungs-Endpunkts enthält die erforderlichen Daten, um die Streaming-Anwendung bezüglich der nächsten Aktion zu führen.

    note important
    IMPORTANT
    Weitere Informationen zu den in einer Sitzungsantwort bereitgestellten Informationen finden Sie in der APIDokumentation zu „Authentifizierungssitzung erstellen“.
    Der Sessions-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 und mvpd muss aktiv sein.
    Wenn die Validierung fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehlercodes bereitstellt.

  3. Fahren Sie mit Entscheidungs-Flüssen fort: Die Antwort des Sitzungs-Endpunkts enthält die folgenden Daten:

    • Das actionName-Attribut ist auf „authorize“ festgelegt.
    • Das actionType-Attribut ist auf „direct“ festgelegt.

    Wenn das Adobe Pass-Backend ein gültiges Profil identifiziert, muss sich die Streaming-Anwendung nicht erneut mit dem ausgewählten MVPD authentifizieren, da bereits ein Profil vorhanden ist, das für nachfolgende Entscheidungsflüsse verwendet werden kann.

  4. URL im Benutzeragenten öffnen Die Antwort des Sitzungs-Endpunkts enthält die folgenden Daten:

    • Die url, die verwendet werden kann, um die interaktive Authentifizierung auf der Anmeldeseite von MVPD zu initiieren.
    • Das actionName-Attribut ist auf „Authenticate“ festgelegt.
    • Das actionType-Attribut ist auf „interaktiv“ festgelegt.

    Wenn das Adobe Pass-Backend kein gültiges Profil identifiziert, öffnet die Streaming-Anwendung einen Benutzeragenten, um die angegebene url zu laden, und sendet eine Anfrage an den Authentifizierungsendpunkt. Dieser Fluss kann mehrere Weiterleitungen enthalten, die den Benutzer letztendlich zur Anmeldeseite von MVPD führen und gültige Anmeldeinformationen angeben.

  5. Vollständige MVPD-Authentifizierung: Wenn der Authentifizierungsfluss erfolgreich ist, speichert die Benutzeragenten-Interaktion ein reguläres Profil im Adobe Pass-Backend und erreicht die angegebene redirectUrl.

  6. Profil für bestimmten Code abrufen: Die Streaming-Anwendung sammelt alle erforderlichen Daten, um Profilinformationen abzurufen, indem eine Anfrage an den Endpunkt „Profiles“ gesendet wird.

    note important
    IMPORTANT
    Weitere Informationen zu folgenden finden Sie in der APIDokumentation zum Abrufen von Profilen für bestimmten Code:
    • Alle erforderlichen Parameter wie serviceProvider, code
    • Alle erforderlichen Kopfzeilen wie Authorization, AP-Device-Identifier
    • Alle optionalen Parameter und Kopfzeilen
    note tip
    TIP
    Die Streaming-Anwendung muss warten, bis der Benutzeragent die angegebene redirectUrl erreicht, um zu überprüfen, ob das reguläre Profil erfolgreich generiert und gespeichert wurde.

  7. Informationen zum regulären Profil zurückgeben: Die Antwort des Endpunkts „Profile“ enthält Informationen zum regulären Profil, das mit den empfangenen Parametern und Kopfzeilen verknüpft ist.

    note important
    IMPORTANT
    Weitere Informationen zu in einer Profilantwort bereitgestellten Informationen finden Sie in der APIDokumentation zum Abrufen von Profilen für bestimmten Code.
    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.
    Wenn die Validierung fehlschlägt, wird eine Fehlerantwort generiert, die zusätzliche Informationen entsprechend der Dokumentation Erweiterte Fehlercodes bereitstellt.
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b