Dokumentation Adobe Pass Adobe Pass-Authentifizierung

(Legacy) Autorisierung einleiten initiate-authorization

Last update: Mon Nov 03 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Authentifizierung

NOTE

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

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.

NOTE

Die REST-API-Implementierung wird durch Drosselungsmechanismus)

REST-API-Endpunkte clientless-endpoints

<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 description

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:

code language-none
`X-Forwarded-For : <streaming\_device\_ip>`

wobei <streaming\_device\_ip> die öffentliche IP-Adresse des Streaming-Geräts ist.

Beispiel :

code language-none
`POST /reggie/v1/{req_id}/regcode HTTP/1.1 X-Forwarded-For:203.45.101.20`

Beispielantwort sample-response

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:

code language-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

code language-json

code language-json
`<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>`

<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