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 di registrazione
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 di registrazione
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 | | Servizio di autenticazione
di Adobe Pass
| Accedi a
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 di registrazione
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 | | Servizio di autenticazione
di Adobe Pass
| 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
pass-help-authentication