Riferimento API REST (legacy) rest-api-reference

NOTE
Il contenuto di questa pagina viene fornito solo a scopo informativo. L’utilizzo di questa API richiede una licenza corrente da Adobe. Non è consentito alcun uso non autorizzato.
IMPORTANT
Assicurati di essere sempre informato sugli ultimi annunci di prodotto per l'autenticazione di Adobe Pass e sulle timeline di disattivazione aggregate nella pagina Annunci di prodotto.

Meccanismo di limitazione

L'API REST per l'autenticazione di Adobe Pass è gestita da un meccanismo di limitazione.

Formati di risposta response-formats

NOTE
Le API fornite in questi servizi possono restituire risposte in XML o JSON (per le API che restituiscono una risposta). Esistono 3 modi diversi per specificare il formato della risposta nella richiesta:
  • Impostare HTTP Accept Header su application/xml o application/json.
  • Nel payload della richiesta, specifica il parametro format=xml o format=json.
  • Chiamare l'endpoint del servizio Web con estensione .xml o .json. Ad esempio, /regcode.xml o /regcode.json
È possibile specificare uno qualsiasi dei metodi descritti sopra. La specifica di più metodi con formati in conflitto può causare errori o output indesiderato.

Endpoint REST API clientless-endpoints

<FQDN_REGGIE>:

<SP_FQDN>:

Riepilogo servizi Web web_srvs_summary

La tabella seguente elenca i servizi web disponibili per l’approccio senza client. Fai clic sugli endpoint dei servizi web per ulteriori informazioni (richiesta e risposta di esempio, parametri di input, metodi HTTP, ecc.)

Sr
Endpoint servizio Web
Descrizione
.
Ospitato da
Chiamato da
1.
<REGGIE_FQDN>/reggie/v1/
{requestorId}/regcode
Restituisce l'URI del codice di registrazione e della pagina di accesso generato in modo casuale
2
Servizio codice reg
Adobe
Smart Device
2.
<REGGIE_FQDN>/reggie/v1/
{requestorId}/regcode/
{registrationCode}
Restituisce il record del codice di registrazione contenente il codice di registrazione UUID, il codice di registrazione e l'ID dispositivo con hash
8
Servizio codice reg
Adobe
Autenticazione Adobe Pass
3.
<SP_FQDN>/api/v1/config/
{requestorId}
Restituisce l’elenco degli MVPD configurati per il richiedente
5
Adobe
Adobe Pass
autenticazione
Servizio
Accedi a
Web
App
4.
<SP_FQDN>/api/v1/authenticate
Avvia il processo AuthN informando l'evento di selezione MVPD. Crea un record nel database di autenticazione, che viene riconciliato quando viene ricevuta una risposta corretta da MVPD (passaggio 13)
7
Adobe
Adobe Pass
autenticazione
Servizio
Accedi a
Web
App
5.
Consumer asserzione SAML
Flusso di lavoro SAML esistente tra autenticazione Adobe Pass e MVPD
13
Servizio di autenticazione
di Adobe Pass
Autenticazione Adobe Pass
6.
<SP_FQDN>/api/v1/checkauthn/
{registrationCode}
L’app web di accesso può verificare se il tentativo di flusso di accesso è riuscito
Autenticazione di Adobe Pass

Servizio
Login
Web
App
7.
<SP_FQDN>/api/v1/tokens/authn
Ottiene i metadati relativi al token di autenticazione
15
Servizio di autenticazione
di Adobe Pass
Smart Device
8.
<REGGIE_FQDN>/reggie/v1/
{requestorId}/regcode/
{registrationCode}
Elimina il record del codice reg e rilascia il codice reg per il riutilizzo
16
Servizio codice reg
Adobe
Autenticazione Adobe Pass
9.
<SP_FQDN>/api/v1/authorize
Ottiene la risposta di autorizzazione.
17
Servizio di autenticazione
di Adobe Pass
Smart Device
10.
<SP_FQDN>/api/v1/checkauthn
Indica se il dispositivo ha un token AuthN non scaduto.
Servizio di autenticazione
di Adobe Pass
Smart Device
11
<SP_FQDN>/api/v1/tokens/authn
Se trovato, restituisce il token AuthN.
Servizio di autenticazione
di Adobe Pass
Smart Device
12
<SP_FQDN>/api/v1/tokens/authz
Se trovato, restituisce il token AuthZ.
Servizio di autenticazione
di Adobe Pass
Smart Device
13
<SP_FQDN>/api/v1/tokens/media
Se trovato, restituisce il token multimediale breve: come /api/v1/mediatoken
Servizio di autenticazione
di Adobe Pass
Smart Device
14
<SP_FQDN>/api/v1/mediatoken
Ottiene un token multimediale breve
Servizio di autenticazione
di Adobe Pass
Smart Device
15
<SP_FQDN>/api/v1/preauthorize
Recupera l’elenco delle risorse preautorizzate
Servizio di autenticazione
di Adobe Pass
Smart Device
16
<SP_FQDN>/api/v1/preauthorize/{code}
Recupera l’elenco delle risorse preautorizzate
Servizio di autenticazione
di Adobe Pass
Accedi all’app web
17
<SP_FQDN>/api/v1/logout
Rimuovere i token AuthN e AuthZ dall'archiviazione
Autenticazione di Adobe Pass

Servizio
Smart Device
18
<SP_FQDN>/api/v1/tokens/usermetadata
Ottiene i metadati utente al termine del flusso di autenticazione
N/D
N/D
Smart Device
19.
<SP_FQDN>/api/v1/authenticate/freepreview
Creare un token di autenticazione per Passaggio temporaneo o Passaggio temporaneo promozionale
N/D
Servizio di autenticazione
di Adobe Pass
Smart Device

Sicurezza REST API security

Tutte le API REST di autenticazione di Adobe Pass devono essere chiamate utilizzando il protocollo HTTPS per una comunicazione sicura. Inoltre, la maggior parte delle API chiamate deve contenere un token di accesso ottenuto come descritto nella documentazione API Recupera token di accesso.

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