Riferimento API REST (legacy) rest-api-reference
Meccanismo di limitazione
L’API REST per l’autenticazione di Adobe Pass è gestita da un meccanismo di limitazione.
Formati di risposta response-formats
- Impostare HTTP Accept Header su
application/xmloapplication/json. - Nel payload della richiesta, specifica il parametro
format=xmloformat=json. - Chiamare l'endpoint del servizio Web con estensione
.xmlo.json. Ad esempio,/regcode.xmlo/regcode.json
Endpoint REST API clientless-endpoints
<FQDN_REGGIE>:
- Produzione - api.auth.adobe.com
- Staging - api.auth-staging.adobe.com
<SP_FQDN>:
- Produzione - api.auth.adobe.com
- Staging - api.auth-staging.adobe.com
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.