DokumentationAdobe PassAdobe Pass-Authentifizierung

(Legacy) Autorisierung einleiten

Letzte Aktualisierung: 5. Mai 2025
  • Themen:
  • Authentifizierung
HINWEIS
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.
WICHTIG
Achten Sie darauf, über die neuesten Ankündigungen zu Produkten der Adobe Pass-Authentifizierung und Stilllegungszeitpläne auf der Seite Produktankündigungen auf dem Laufenden zu bleiben.
HINWEIS
Die REST-API-Implementierung wird durch Drosselungsmechanismus)

REST-API-Endpunkte

<REGGIE_FQDN>:

  • Produktion - api.auth.adobe.com
  • Staging - api.auth-staging.adobe.com

<SP_FQDN>:

  • Produktion - api.auth.adobe.com
  • Staging - api.auth-staging.adobe.com

Beschreibung

Erhält die Autorisierungsantwort.

Endpunkt
Called
by
Eingabe
Parameter
HTTP
Methode
Antwort
HTTP
Antwort
<SP_FQDN>/api/v1/authorize
Streaming-App

oder

Programmierer-Service
1. Antragsteller (obligatorisch)
2. deviceId (obligatorisch)
3. Ressource (obligatorisch)
4. device_info/X-device-info (obligatorisch)
5. deviceType
6. deviceUser (veraltet)
7. appId (veraltet)
8. Zusätzliche Parameter (optional)
GET
XML oder JSON mit Autorisierungsdetails oder Fehlerdetails, wenn nicht erfolgreich. Siehe Beispiele unten.
200 - Erfolg
403 - Kein Erfolg
Eingabeparameter
Beschreibung
Antragsteller
Die RequestorId des Programmierers, für den dieser Vorgang gültig ist.
deviceId
Die Geräte-ID-Bytes.
Ressource
Eine Zeichenfolge, die eine resourceId (oder ein MRSS-Fragment) enthält, den von einem Benutzer angeforderten Inhalt identifiziert und von MVPD-Autorisierungsendpunkten erkannt wird.
device_info/

X-device-info
Informationen zu Streaming-Geräten.

Hinweis: Dies kann als URL-Parameter an device_info übergeben werden, sollte jedoch aufgrund der potenziellen Größe dieses Parameters und der Längenbeschränkungen für eine GET-URL als X-Device-Info im HTTP-Header übergeben werden.

Vollständige Details finden Sie unter Übergeben von Geräte- und Verbindungsinformationen.
deviceType
Der Gerätetyp (z. B. Roku, PC).

Wenn dieser Parameter richtig festgelegt ist, bietet ESM Metriken an, die nach Gerätetyp aufgeschlüsselt)Verwendung von Clientless sind, sodass verschiedene Arten der Analyse für z. B. Roku, AppleTV, Xbox usw. durchgeführt werden können.

Siehe Vorteile des Client-losen Gerätetyp-Parameters in Kennzahlen

Hinweis: Der Parameter wird durch „device_info“ ersetzt.
deviceUser
Die Geräte-Benutzerkennung.
appId
Die Anwendungs-ID/-name.

Hinweis: device_info ersetzt diesen Parameter.
Zusätzliche Parameter
Der Aufruf kann auch optionale Parameter enthalten, die andere Funktionen ermöglichen, z. B.:

* generic_data - Aktiviert die Verwendung von Werbe-TempPass

Beispiel: generic_data=("email":"email@domain.com")
CAUTION
IP-Adresse des Streaming-Geräts

Bei Client-zu-Server-Implementierungen wird die IP-Adresse des Streaming-Geräts mit diesem Aufruf implizit gesendet. Bei Server-zu-Server-Implementierungen, bei denen der regcode-Aufruf vom Programmierdienst und nicht vom Streaming-Gerät erfolgt, ist der folgende Header erforderlich, um die IP-Adresse des Streaming-Geräts zu übergeben:
X-Forwarded-For : <streaming\_device\_ip>
wobei <streaming\_device\_ip> die öffentliche IP-Adresse des Streaming-Geräts ist.


Beispiel :
POST /reggie/v1/{req_id}/regcode HTTP/1.1
X-Forwarded-For:203.45.101.20

Beispielantwort

  • 1. Fall: Erfolg

    • XML:

    „XML
    <?xml version=„1.0“ encoding=„UTF-8“ standalone=„yes“?>
    <authorization>
    <expires>1348148289000</expires>
    <mvpd>sampleMvpdId</mvpd>
    <Requestor>sampleRequestorId</Requestor>
    <resource>sampleResourceId</resource>
    </authorization>
    "

  • JSON:

    {
      "mvpd": "sampleMvpdId",
      "resource": "sampleResourceId",
      "requestor": "sampleRequestorId",
      "expires": "1348148289000"
    }
    
IMPORTANT
Wenn die Antwort von einer Proxy-MVPD stammt, kann sie ein zusätzliches Element namens proxyMvpd enthalten.
  • Fall 2: Genehmigung verweigert

    <error>
      <status>403</status>
      <message>User not authorized</message>
      <details>Your subscription package does not include the "ASFAFD" channel.
      Please go to http://www.ca.ble/upgrade in order to upgrade your subscription.</details>
    </error>
    
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b