REST-API-Referenz rest-api-reference

NOTE
Der Inhalt dieser Seite dient nur Informationszwecken. Für die Verwendung dieser API ist eine aktuelle Lizenz von Adobe erforderlich. Eine unbefugte Anwendung ist nicht zulässig.

Drosselmechanismus

Die Adobe Pass Authentication REST API wird von einer Drosselmechanismus.

Antwortformate response-formats

NOTE
Die in diesen Diensten bereitgestellten APIs können Antworten in XML oder JSON zurückgeben (für APIs, die eine Antwort zurückgeben). Es gibt 3 verschiedene Möglichkeiten, das Antwortformat in der Anfrage anzugeben:
  • Setzen Sie HTTP Accept Header auf application/xml oder application/json.
  • Geben Sie in der Anfrage-Payload den Parameter an format=xml oder format=json.
  • Aufrufen des Webdienst-Endpunkts mit Erweiterung .xml oder .json. Beispiel: /regcode.xml oder /regcode.json
Sie können eine der oben genannten Methoden angeben. Das Angeben mehrerer Methoden mit widersprüchlichen Formaten kann zu Fehlern oder unerwünschten Ausgaben führen.

REST-API-Endpunkte clientless-endpoints

<reggie_fqdn>:

<sp_fqdn>:

Web Services - Zusammenfassung web_srvs_summary

In der folgenden Tabelle sind die verfügbaren Webdienste für den clientlosen Ansatz aufgeführt. Klicken Sie auf die Webdienst-Endpunkte, um weitere Informationen zu erhalten (Beispielanfrage und -antwort, Eingabeparameter, HTTP-Methoden usw.).

Sr
Web Service Endpoint
Beschreibung
.
gehostet bei
aufgerufen von
1.
<reggie_fqdn>/reggie/v1/
{requestorId}/regcode
Gibt zufällig generierten Registrierungs-Code und Anmeldeseiten-URI zurück
2
Adobe
Reg Code-Dienst
Smart Device
2.
<reggie_fqdn>/reggie/v1/
{requestorId}/regcode/
{registrationCode}
Gibt den Registrierungs-Code-Datensatz mit Registrierungs-Code-UUID, Registrierungs-Code und Hash-Geräte-ID zurück
8
Adobe
Reg Code-Dienst
Adobe Pass-Authentifizierung
3.
<sp_fqdn>/api/v1/config/
{requestorId}
Gibt eine Liste der konfigurierten MVPDs für den Anforderer zurück
5
Adobe
Adobe Pass
Authentifizierung
Dienst
Anmelden
Web
App
4.
<sp_fqdn>/api/v1/authenticate
Initiiert den AuthN-Prozess durch Information zum MVPD-Auswahlereignis. Erstellt einen Datensatz in der Authentifizierungsdatenbank, der abgestimmt wird, wenn eine erfolgreiche Antwort von MVPD empfangen wird (Schritt 13)
7
Adobe
Adobe Pass
Authentifizierung
Dienst
Anmelden
Web
App
5.
SAML Assertion Consumer
Vorhandener SAML-Workflow zwischen Adobe Pass-Authentifizierung und MVPD
13
Adobe Pass
Authentifizierung
Dienst
Adobe Pass-Authentifizierung
6.
<sp_fqdn>/api/v1/checkauthn/
{registrationCode}
Die Web-Anwendung "Anmeldung"kann prüfen, ob der versucht wurde, den Anmeldevorgang erfolgreich durchzuführen
Adobe Pass
Authentifizierung
Dienst
Anmelden
Web
App
7.
<sp_fqdn>/api/v1/tokens/authn
Ruft AuthN-Token-bezogene Metadaten ab
15
Adobe Pass
Authentifizierung
Dienst
Smart Device
8.
<reggie_fqdn>/reggie/v1/
{requestorId}/regcode/
{registrationCode}
Löscht den Reg-Codedatensatz und gibt den Reg-Code zur Wiederverwendung frei
16
Adobe
Reg Code-Dienst
Adobe Pass-Authentifizierung
9.
<sp_fqdn>/api/v1/authorize
Erhält die Antwort auf die Autorisierung.
17
Adobe Pass
Authentifizierung
Dienst
Smart Device
10.
<sp_fqdn>/api/v1/checkauthin
Gibt an, ob das Gerät über ein nicht abgelaufenes AuthN-Token verfügt.
Adobe Pass
Authentifizierung
Dienst
Smart Device
11.
<sp_fqdn>/api/v1/tokens/authn
Gibt das AuthN-Token zurück, falls gefunden.
Adobe Pass
Authentifizierung
Dienst
Smart Device
12.
<sp_fqdn>/api/v1/tokens/authz
Gibt das AuthZ-Token zurück, falls gefunden.
Adobe Pass
Authentifizierung
Dienst
Smart Device
13.
<sp_fqdn>/api/v1/tokens/media
Gibt das Short Media Token aus, falls vorhanden - identisch mit /api/v1/mediatoken
Adobe Pass
Authentifizierung
Dienst
Smart Device
14.
<sp_fqdn>/api/v1/mediatoken
Erhält Short Media Token
Adobe Pass
Authentifizierung
Dienst
Smart Device
15.
<sp_fqdn>/api/v1/preauthorize
Ruft die Liste der vorab autorisierten Ressource ab
Adobe Pass
Authentifizierung
Dienst
Smart Device
16.
<sp_fqdn>/api/v1/preauthorize/{code}
Ruft die Liste der vorab autorisierten Ressourcen ab
Adobe Pass
Authentifizierung
Dienst
Webanwendung anmelden
17.
<sp_fqdn>/api/v1/logout
AuthN- und AuthZ-Token aus dem Speicher entfernen
Adobe Pass
Authentifizierung
Dienst
Smart Device
18.
<sp_fqdn>/api/v1/tokens/usermetadata
Ruft Benutzermetadaten nach Abschluss des Authentifizierungsflusses ab
Nicht zutreffend
Nicht zutreffend
Smart Device
19.
<sp_fqdn>/api/v1/authenticate/freepreview
Erstellen eines Authentifizierungstokens für den temporären Pass oder den temporären Weiterleitungs-Pass
Nicht zutreffend
Adobe Pass
Authentifizierung
Dienst
Smart Device

REST API Security security

Alle clientlosen Adobe Pass-Authentifizierungs-APIs müssen zur sicheren Kommunikation mithilfe des HTTPS-Protokolls aufgerufen werden. Darüber hinaus sollten die meisten APIs, die aufgerufen werden, ein Zugriffstoken enthalten, das von Dynamische Kundenregistrierung.

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