DocumentazioneAdobe PassAutenticazione Adobe Pass

Flusso di autenticazione di base eseguito nell'applicazione secondaria basic-authentication-flow-performed-within-secondary-application

Last update: Thu Oct 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
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
L'implementazione REST API V2 è limitata dalla documentazione del meccanismo di limitazione.

Il flusso di autenticazione all'interno del diritto di autenticazione di Adobe Pass consente all'applicazione di streaming di verificare che un utente disponga di un account MVPD valido. Questo processo richiede che l'utente disponga di un account MVPD attivo e immetta credenziali di accesso valide nella pagina di accesso MVPD.

Il flusso di autenticazione è necessario nei seguenti casi:

  • Quando l’utente apre un’applicazione per la prima volta.
  • Quando l’autenticazione precedente dell’utente è scaduta.
  • Quando l’utente si disconnette dall’account MVPD.
  • Quando l’utente desidera eseguire l’autenticazione con un MVPD diverso.

In tutti questi casi, l’applicazione che chiama uno qualsiasi degli endpoint "Profiles" riceve una risposta vuota o uno o più profili, ma per MVPD diversi.

Il flusso di autenticazione richiede che un agente utente (browser) completi una serie di chiamate dall'applicazione al backend di Adobe Pass, quindi alla pagina di accesso MVPD e infine all'applicazione. Questo flusso può includere diversi reindirizzamenti ai sistemi MVPD e la gestione di cookie o sessioni archiviate per ciascun dominio, che può essere difficile da raggiungere e proteggere senza un agente utente.

In base alle funzionalità dell’applicazione principale (applicazione di streaming) per supportare l’interazione dell’utente per selezionare un MVPD e per eseguire l’autenticazione con l’MVPD selezionato in un agente utente, gli scenari di autenticazione sono:

Eseguire l'autenticazione nell'applicazione secondaria con mvpd preselezionato perform-authentication-within-secondary-application-with-preselected-mvpd

Prerequisiti prerequisites-perform-authentication-within-secondary-application-with-preselected-mvpd

Prima di avviare il flusso di autenticazione all’interno di un’applicazione primaria e di completarlo tramite l’interazione dell’utente all’interno di un’applicazione secondaria, assicurati di soddisfare i seguenti prerequisiti:

  • L'applicazione di streaming deve selezionare un MVPD.
  • L'applicazione di streaming deve avviare una sessione di autenticazione per accedere con l'MVPD selezionato.
  • L'applicazione secondaria deve eseguire l'autenticazione con l'MVPD selezionato in un agente utente.
IMPORTANT
Presupposti
  • L’applicazione di streaming supporta l’interazione dell’utente per selezionare un MVPD.
  • L’applicazione secondaria (in genere su un dispositivo secondario) supporta l’interazione dell’utente per l’autenticazione con l’MVPD selezionato in un agente utente.

Flusso di lavoro workflow-perform-authentication-within-secondary-application-with-preselected-mvpd

Segui i passaggi forniti per implementare il flusso di autenticazione di base eseguito all’interno di un’applicazione secondaria con un MVPD preselezionato, come illustrato nel diagramma seguente.

Eseguire lautenticazione nellapplicazione secondaria con mvpd preselezionato

Eseguire l'autenticazione nell'applicazione secondaria con mvpd preselezionato

  1. Crea sessione di autenticazione: L'applicazione di streaming raccoglie tutti i dati necessari per avviare una sessione di autenticazione chiamando l'endpoint Sessions.

    note important
    IMPORTANT
    Per informazioni dettagliate su Crea sessione di autenticazione, consulta la documentazione API di:
    • Tutti i parametri required, come serviceProvider, mvpd, domainName e redirectUrl
    • Tutte le intestazioni required, come Authorization, AP-Device-Identifier
    • Tutti i parametri e le intestazioni optional
    Durante la creazione della sessione di autenticazione, l’applicazione di streaming deve fornire tutti i parametri richiesti in una singola chiamata.

  2. Indicare l'azione successiva: La risposta dell'endpoint Sessions contiene i dati necessari per guidare l'applicazione di streaming per quanto riguarda l'azione successiva.

    note important
    IMPORTANT
    Per informazioni dettagliate sulle informazioni fornite in una risposta di sessione, consulta la documentazione API Crea sessione di autenticazione.
    L’endpoint Sessions convalida i dati della richiesta per garantire che siano soddisfatte le condizioni di base:
    • I parametri e le intestazioni required devono essere validi.
    • L'integrazione tra serviceProvider e mvpd specificati deve essere attiva.
    Se la convalida non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.

  3. Procedi con i flussi di decisioni: La risposta dell'endpoint Sessions contiene i dati seguenti:

    • L'attributo actionName è impostato su "authorize".
    • L'attributo actionType è impostato su "direct".

    Se il backend di Adobe Pass identifica un profilo valido, non è necessario che l’applicazione di streaming autentichi nuovamente con l’MVPD selezionato, in quanto esiste già un profilo che può essere utilizzato per i flussi decisionali successivi.

  4. Visualizza codice di autenticazione: La risposta dell'endpoint Sessions contiene i dati seguenti:

    • code che può essere utilizzato per riprendere la sessione di autenticazione in un'applicazione secondaria.
    • L'attributo actionName è impostato per l'autenticazione.
    • L'attributo actionType è impostato su "interactive".

    Se il backend di Adobe Pass non identifica un profilo valido, l'applicazione di streaming visualizza code che può essere utilizzato per riprendere la sessione di autenticazione all'interno di un'applicazione secondaria.

  5. Convalida codice di autenticazione: L'applicazione secondaria convalida l'utente fornito code per assicurarsi che possa procedere con l'autenticazione MVPD nell'agente utente.

    note important
    IMPORTANT
    Per informazioni dettagliate su Recuperare le informazioni sulla sessione di autenticazione, consulta la documentazione API di:
    • Tutti i parametri required, come serviceProvider e code
    • Tutte le intestazioni required, come Authorization
    • Tutti i parametri e le intestazioni optional

  6. Informazioni restituite sulla sessione di autenticazione: La risposta dell'endpoint Sessions contiene i dati seguenti:

    • L'attributo existing contiene i parametri esistenti già specificati.
    • L'attributo missing contiene i parametri mancanti che devono essere forniti per completare il flusso di autenticazione.
    note important
    IMPORTANT
    Per informazioni dettagliate sulle informazioni fornite in una risposta di convalida della sessione, consultare la documentazione API Recupera informazioni sulla sessione di autenticazione.
    L’endpoint Sessions convalida i dati della richiesta per garantire che siano soddisfatte le condizioni di base:
    • I parametri e le intestazioni required devono essere validi.
    Se la convalida non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.
    note tip
    TIP
    Suggerimento: l'applicazione secondaria può informare gli utenti che code utilizzato non è valido nel caso in cui una risposta di errore indichi una sessione di autenticazione mancante e consigliare loro di riprovare a utilizzarne una nuova.

  7. Apri URL nell'agente utente: L'applicazione secondaria apre un agente utente per caricare url calcolato automaticamente, effettuando una richiesta all'endpoint Authenticate. Questo flusso può includere diversi reindirizzamenti, che portano l’utente alla pagina di accesso MVPD e forniscono credenziali valide.

    note important
    IMPORTANT
    Per informazioni dettagliate su Eseguire l'autenticazione nella documentazione API dell'agente utente:
    • Tutti i parametri required, come serviceProvider e code
    • Tutti i parametri e le intestazioni optional

  8. Autenticazione MVPD completa: Se il flusso di autenticazione ha esito positivo, l'interazione dell'agente utente salva un profilo regolare nel backend di Adobe Pass e raggiunge il redirectUrl fornito.

  9. Recupera profilo per codice specifico: L'applicazione di streaming raccoglie tutti i dati necessari per recuperare le informazioni sul profilo inviando una richiesta all'endpoint Profili.

    note important
    IMPORTANT
    Per informazioni dettagliate su Recupera profilo per codice specifico, consulta la documentazione API per:
    • Tutti i parametri required, come serviceProvider e code
    • Tutte le intestazioni required, come Authorization, AP-Device-Identifier
    • Tutti i parametri e le intestazioni optional
    note tip
    TIP
    Suggerimento: l'applicazione di streaming può implementare un meccanismo di polling utilizzando code per verificare se il profilo regolare è stato generato e salvato correttamente.

  10. Restituisci informazioni sul profilo regolare: La risposta dell'endpoint Profiles contiene informazioni sul profilo regolare associato ai parametri e alle intestazioni ricevuti.

    note important
    IMPORTANT
    Per informazioni dettagliate sulle informazioni fornite in una risposta al profilo, consulta la documentazione API Recupera profilo per codice specifico.
    L’endpoint Profili convalida i dati della richiesta per garantire che siano soddisfatte le condizioni di base:
    • I parametri e le intestazioni required devono essere validi.
    Se la convalida non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.

Eseguire l'autenticazione nell'applicazione secondaria senza mvpd preselezionato perform-authentication-within-secondary-application-without-preselected-mvpd

Prerequisiti prerequisites-perform-authentication-within-secondary-application-without-preselected-mvpd

Prima di avviare il flusso di autenticazione all’interno di un’applicazione primaria e di completarlo tramite l’interazione dell’utente all’interno di un’applicazione secondaria, assicurati di soddisfare i seguenti prerequisiti:

  • L'applicazione di streaming deve avviare una sessione di autenticazione quando deve accedere.
  • L'applicazione secondaria deve selezionare un MVPD.
  • L'applicazione secondaria deve eseguire l'autenticazione con l'MVPD selezionato in un agente utente.
IMPORTANT
Presupposti
  • L'applicazione secondaria (in genere su un dispositivo secondario) supporta l'interazione dell'utente per selezionare un MVPD.
  • L’applicazione secondaria (in genere su un dispositivo secondario) supporta l’interazione dell’utente per l’autenticazione con l’MVPD selezionato in un agente utente.

Flusso di lavoro workflow-perform-authentication-within-secondary-application-without-preselected-mvpd

Segui i passaggi forniti per implementare il flusso di autenticazione di base eseguito all’interno di un’applicazione secondaria senza un MVPD preselezionato, come illustrato nel diagramma seguente.

Eseguire lautenticazione nellapplicazione secondaria senza mvpd preselezionato

Eseguire l'autenticazione nell'applicazione secondaria senza mvpd preselezionato

  1. Crea sessione di autenticazione: L'applicazione di streaming raccoglie alcuni dei dati necessari per avviare una sessione di autenticazione chiamando l'endpoint Sessions.

    note important
    IMPORTANT
    Per informazioni dettagliate su Crea sessione di autenticazione, consulta la documentazione API di:
    • Tutti i parametri required, come serviceProvider
    • Tutte le intestazioni required, come Authorization, AP-Device-Identifier
    • Tutti i parametri e le intestazioni optional
    L’applicazione di streaming non è in grado di fornire tutti i parametri richiesti in una singola chiamata durante la creazione della sessione di autenticazione.

  2. Indicare l'azione successiva: La risposta dell'endpoint Sessions contiene i dati necessari per guidare l'applicazione di streaming per quanto riguarda l'azione successiva:

    • code che può essere utilizzato per riprendere la sessione di autenticazione in un'applicazione secondaria.
    • L'attributo actionName è impostato su "resume".
    • L'attributo actionType è impostato su "direct".
    note important
    IMPORTANT
    Per informazioni dettagliate sulle informazioni fornite in una risposta di sessione, consulta la documentazione API Crea sessione di autenticazione.
    L’endpoint Sessions convalida i dati della richiesta per garantire che siano soddisfatte le condizioni di base:
    • I parametri e le intestazioni required devono essere validi.
    Se la convalida non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.

  3. Visualizza codice di autenticazione: L'applicazione di streaming visualizza l'elemento code che può essere utilizzato per riprendere la sessione di autenticazione all'interno di un'applicazione secondaria.

  4. Specificare parametri mancanti per la sessione di autenticazione: L'applicazione secondaria raccoglie tutti i dati mancanti necessari per riprendere la sessione di autenticazione e chiama l'endpoint Sessions.

    note important
    IMPORTANT
    Per informazioni dettagliate su Riprendi sessione di autenticazione, consulta la documentazione API di:
    • Tutti i parametri required, come serviceProvider, mvpd, domainName e redirectUrl
    • Tutte le intestazioni required, come Authorization, AP-Device-Identifier
    • Tutti i parametri e le intestazioni optional

  5. Indicare l'azione successiva: La risposta dell'endpoint Sessions contiene i dati necessari per guidare l'applicazione di streaming per quanto riguarda l'azione successiva.

    note important
    IMPORTANT
    Per informazioni dettagliate sulle informazioni fornite in una risposta di sessione, consultare la documentazione API Riprendi sessione di autenticazione.
    L’endpoint Sessions convalida i dati della richiesta per garantire che siano soddisfatte le condizioni di base:
    • I parametri e le intestazioni required devono essere validi.
    • L'integrazione tra serviceProvider e mvpd specificati deve essere attiva.
    Se la convalida non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.
    note tip
    TIP
    Suggerimento: l'applicazione secondaria può informare gli utenti che code utilizzato non è valido nel caso in cui una risposta di errore indichi una sessione di autenticazione mancante e consigliare loro di riprovare a utilizzarne una nuova.

  6. Indicare il profilo esistente: La risposta dell'endpoint Sessions contiene i dati seguenti:

    • L'attributo actionName è impostato su "authorize".
    • L'attributo actionType è impostato su "direct".

    Se il backend di Adobe Pass identifica un profilo valido, non è necessario che l’applicazione di streaming autentichi nuovamente con l’MVPD selezionato, in quanto esiste già un profilo che può essere utilizzato per i flussi decisionali successivi.

  7. Apri URL nell'agente utente: La risposta dell'endpoint Sessions contiene i dati seguenti:

    • url che può essere utilizzato per avviare l'autenticazione interattiva nella pagina di accesso di MVPD.
    • L'attributo actionName è impostato per l'autenticazione.
    • L'attributo actionType è impostato su "interactive".

    Se il backend di Adobe Pass non identifica un profilo valido, l'applicazione secondaria apre un agente utente per caricare l'elemento url fornito, effettuando una richiesta all'endpoint Authenticate. Questo flusso può includere diversi reindirizzamenti, che portano l’utente alla pagina di accesso MVPD e forniscono credenziali valide.

  8. Autenticazione MVPD completa: Se il flusso di autenticazione ha esito positivo, l'interazione dell'agente utente salva un profilo regolare nel backend di Adobe Pass e raggiunge il redirectUrl fornito.

  9. Recupera profilo per codice specifico: L'applicazione di streaming raccoglie tutti i dati necessari per recuperare le informazioni sul profilo inviando una richiesta all'endpoint Profili.

    note important
    IMPORTANT
    Per informazioni dettagliate su Recupera profilo per codice specifico, consulta la documentazione API per:
    • Tutti i parametri required, come serviceProvider e code
    • Tutte le intestazioni required, come Authorization, AP-Device-Identifier
    • Tutti i parametri e le intestazioni optional
    note tip
    TIP
    Suggerimento: l'applicazione di streaming può implementare un meccanismo di polling utilizzando code per verificare se il profilo regolare è stato generato e salvato correttamente.

  10. Restituisci informazioni sul profilo regolare: La risposta dell'endpoint Profiles contiene informazioni sul profilo regolare associato ai parametri e alle intestazioni ricevuti.

    note important
    IMPORTANT
    Per informazioni dettagliate sulle informazioni fornite in una risposta al profilo, consulta la documentazione API Recupera profilo per codice specifico.
    L’endpoint Profili convalida i dati della richiesta per garantire che siano soddisfatte le condizioni di base:
    • I parametri e le intestazioni required devono essere validi.
    Se la convalida non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b