DocumentazioneAdobe PassAutenticazione Adobe Pass

Flusso di autenticazione di base eseguito nell'applicazione principale basic-authentication-flow-performed-within-primary-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 principale perform-authentication-within-primary-application

Prerequisiti prerequisites-perform-authentication-within-primary-application

Prima di eseguire l’autenticazione tramite l’interazione dell’utente all’interno di un’applicazione primaria, verifica che siano soddisfatti 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 di streaming 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 di streaming supporta l’interazione dell’utente per l’autenticazione con l’MVPD selezionato in un agente utente.

Flusso di lavoro workflow-perform-authentication-completed-on-primary-application

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

Esegui autenticazione nellapplicazione primaria

Esegui autenticazione nell'applicazione primaria

  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. 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 di streaming 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.

  5. 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.

  6. 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, 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ò attendere che l'agente utente raggiunga il redirectUrl fornito per verificare se il profilo regolare è stato generato e salvato correttamente.

  7. 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