DocumentazioneAdobe PassAutenticazione Adobe Pass

Flussi di accesso degradati degraded-access-flows

Last update: Wed Mar 05 2025 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.
Related Articles
Visita anche le Domande frequenti su REST API V2.

Degradazione consente di bypassare temporaneamente endpoint specifici di autenticazione e autorizzazione di MVPD. Di solito, il programmatore avvia questa azione, ma indipendentemente da chi attiva un evento di degrado, l’azione dipende da accordi precedenti conclusi con gli MVPD interessati.

Per ulteriori dettagli sulla funzione di degradazione, consulta la documentazione di degradazione.

I flussi di accesso danneggiati consentono di eseguire query per i seguenti scenari:

Eseguire l'autenticazione durante l'applicazione della degradazione perform-authentication-while-degradation-is-applied

Prerequisiti prerequisites-perform-authentication-while-degradation-is-applied

Prima di eseguire il flusso di autenticazione durante l’applicazione della degradazione, verifica che siano soddisfatti i seguenti prerequisiti:

  • L'applicazione di streaming deve avviare una sessione di autenticazione quando deve accedere con MVPD.
IMPORTANT
Presupposti
  • L’applicazione di streaming non dispone di un profilo valido per quel MVPD specifico salvato nel backend di Adobe Pass.
  • Regola di degradazione AuthNAll applicata all'integrazione tra serviceProvider e mvpd forniti.

Flusso di lavoro workflow-perform-authentication-while-degradation-is-applied

Segui i passaggi forniti per implementare il flusso di autenticazione mentre viene applicata la degradazione, come illustrato nel diagramma seguente.

Eseguire lautenticazione durante lapplicazione della degradazione

Eseguire l'autenticazione durante l'applicazione della degradazione

  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 e AP-Device-Identifier
    • Tutti i parametri e le intestazioni optional

  2. Verifica regole di degradazione: Il server Adobe Pass verifica se è stata applicata una regola di degradazione AuthNAll all'integrazione tra serviceProvider e mvpd forniti.

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

    • L'attributo actionName è impostato su "authorize".
    • 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.
    • L'integrazione tra serviceProvider e mvpd specificati deve essere attiva.
    Se la convalida di base non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.
    L’endpoint Sessions utilizza i dati della richiesta per verificare se sono soddisfatte condizioni di accesso degradate:
    • L'integrazione tra serviceProvider e mvpd specificati deve avere una regola di degradazione AuthNAll applicata.
    Se la convalida dell’accesso degradato non riesce, la risposta utilizza per impostazione predefinita il flusso di autenticazione di base.

  4. Procedi con i flussi di decisioni: L'applicazione di streaming può continuare con i flussi di decisioni successivi.

Recupera le decisioni di autorizzazione durante l'applicazione della riduzione del livello di priorità retrieve-authorization-decisions-while-degradation-is-applied

Prerequisiti prerequisites-retrieve-authorization-decisions-while-degradation-is-applied

Prima di recuperare le decisioni di autorizzazione durante l’applicazione della degradazione, assicurati di soddisfare i seguenti prerequisiti:

  • L’applicazione di streaming deve recuperare una decisione di autorizzazione prima di riprodurre una risorsa selezionata dall’utente.
IMPORTANT
Presupposti
  • L’applicazione di streaming non dispone di un profilo valido per quel MVPD specifico.
  • Regola di degradazione AuthZAll o AuthNAll applicata all'integrazione tra serviceProvider e mvpd forniti.

Flusso di lavoro workflow-retrieve-authorization-decisions-while-degradation-is-applied

Segui i passaggi forniti per implementare il flusso di autorizzazione durante l’applicazione della degradazione, come illustrato nel diagramma seguente.

Recuperare le decisioni di autorizzazione durante lapplicazione della riduzione di livello

Recuperare le decisioni di autorizzazione durante l'applicazione della riduzione di livello

  1. Recupera decisione di autorizzazione: L'applicazione di streaming raccoglie tutti i dati necessari per ottenere una decisione di autorizzazione per una risorsa specifica chiamando l'endpoint Decisions Authorize.

    note important
    IMPORTANT
    Per informazioni dettagliate su: Recuperare le decisioni di autorizzazione utilizzando la documentazione API mvpd specifica:
    • Tutti i parametri required, come serviceProvider, mvpd e resources
    • Tutte le intestazioni required, come Authorization e AP-Device-Identifier
    • Tutti i parametri e le intestazioni optional

  2. Verifica regole di degradazione: Il server Adobe Pass verifica se è stata applicata una regola di degradazione AuthZAll o AuthNAll all'integrazione tra serviceProvider e mvpd forniti.

  3. Restituisci decisione Permit con token multimediale: La risposta dell'endpoint Decisions Authorize contiene una decisione Permit e un token multimediale.

    note important
    IMPORTANT
    Per informazioni dettagliate sulle informazioni fornite in una risposta alla decisione, consulta la documentazione API MVPD specifica per il recupero delle decisioni di autorizzazione.
    L’endpoint Decisions Authorize 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 di base non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.
    L’endpoint Decisions Authorize utilizza i dati della richiesta per verificare se sono soddisfatte condizioni di accesso degradate:
    • L'integrazione tra serviceProvider e mvpd specificati deve avere una regola di degradazione AuthZAll o AuthNAll applicata.
    Se la convalida dell’accesso degradato non riesce, la risposta assume come valore predefinito il flusso di autorizzazione di base.

  4. Avvia flusso con token multimediale: L'applicazione di streaming utilizza il token multimediale per riprodurre il contenuto.

Recupera le decisioni di pre-autorizzazione durante l’applicazione della degradazione retrieve-preauthorization-decisions-while-degradation-is-applied

Prerequisiti prerequisites-retrieve-preauthorization-decisions-while-degradation-is-applied

Prima di recuperare le decisioni di preautorizzazione durante l’applicazione della degradazione, verifica che siano soddisfatti i seguenti prerequisiti:

  • L’applicazione di streaming desidera recuperare le decisioni di preautorizzazione per visualizzare un elenco di risorse e i relativi stati associati.
IMPORTANT
Presupposti
  • L’applicazione di streaming non dispone di un profilo valido per quel MVPD specifico.
  • Regola di degradazione AuthZAll o AuthNAll applicata all'integrazione tra serviceProvider e mvpd forniti.

Flusso di lavoro workflow-retrieve-preauthorization-decisions-while-degradation-is-applied

Segui i passaggi forniti per implementare il flusso di preautorizzazione mentre viene applicata la degradazione, come mostrato nel diagramma seguente.

Recupera le decisioni di preautorizzazione durante lapplicazione della degradazione

Recupera le decisioni di preautorizzazione durante l'applicazione della degradazione

  1. Recupera decisioni di preautorizzazione: L'applicazione di streaming raccoglie tutti i dati necessari per ottenere le decisioni di preautorizzazione per un elenco di risorse chiamando l'endpoint di preautorizzazione delle decisioni.

    note important
    IMPORTANT
    Consulta la Documentazione API mvpd specifica per il recupero delle decisioni di preautorizzazione, per informazioni dettagliate su:
    • Tutti i parametri required, come serviceProvider, mvpd e resources
    • Tutte le intestazioni required, come Authorization e AP-Device-Identifier
    • Tutti i parametri e le intestazioni optional

  2. Verifica regole di degradazione: Il server Adobe Pass verifica se è stata applicata una regola di degradazione AuthZAll o AuthNAll all'integrazione tra serviceProvider e mvpd forniti.

  3. Restituire decisioni di preautorizzazione: La risposta dell'endpoint di preautorizzazione delle decisioni contiene una decisione Permit per ogni risorsa.

    note important
    IMPORTANT
    Per informazioni dettagliate sulle informazioni fornite in una risposta alla decisione, consulta la Documentazione API mvpd specifica per il recupero delle decisioni di preautorizzazione.
    L’endpoint di preautorizzazione delle decisioni 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 di base non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.
    L’endpoint di preautorizzazione delle decisioni utilizza i dati della richiesta per verificare se sono soddisfatte condizioni di accesso degradate:
    • L'integrazione tra serviceProvider e mvpd specificati deve avere una regola di degradazione AuthZAll o AuthNAll applicata.
    Se la convalida degli accessi danneggiati non riesce, la risposta assume come valore predefinito il flusso di preautorizzazione di base.

  4. Gestione delle decisioni di preautorizzazione: L'applicazione di streaming elabora la risposta e può utilizzarla per visualizzare facoltativamente lo stato appropriato per ogni risorsa nell'interfaccia utente.

Recupera il profilo durante l'applicazione della degradazione retrieve-profile-while-degradation-is-applied

IMPORTANT
La query dell’endpoint Profiles è facoltativa durante l’applicazione della degradazione.
La risposta dell’endpoint Sessions indica all’applicazione di procedere con i flussi di decisioni mentre viene applicata la degradazione. Per ulteriori dettagli, consulta la sezione Eseguire l'autenticazione durante l'applicazione della degradazione.

Prerequisiti prerequisites-retrieve-profile-while-degradation-is-applied

Prima di recuperare il profilo per un MVPD specifico durante l’applicazione della degradazione, verifica che siano soddisfatti i seguenti prerequisiti:

  • L'applicazione di streaming, che ha un identificatore mvpd selezionato o memorizzato nella cache, desidera recuperare il profilo per un MVPD specifico.
IMPORTANT
Presupposti
  • L’applicazione di streaming non dispone di un profilo valido per quel MVPD specifico.
  • Regola di degradazione AuthNAll applicata all'integrazione tra serviceProvider e mvpd forniti.

Flusso di lavoro workflow-retrieve-profile-while-degradation-is-applied

Segui i passaggi forniti per implementare il flusso di recupero del profilo per un MVPD specifico mentre viene applicata la degradazione, come illustrato nel diagramma seguente.

Recupera il profilo durante lapplicazione della degradazione

Recupera il profilo durante l'applicazione della degradazione

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

    note important
    IMPORTANT
    Per informazioni dettagliate su Recupera profilo per documentazione API mvpd specifica, consulta:
    • Tutti i parametri required, come serviceProvider e mvpd
    • Tutte le intestazioni required, come Authorization e AP-Device-Identifier
    • Tutti i parametri e le intestazioni optional

  2. Verifica regole di degradazione: Il server Adobe Pass verifica se è stata applicata una regola di degradazione AuthNAll all'integrazione tra serviceProvider e mvpd forniti.

  3. Restituire informazioni sul profilo danneggiato: La risposta dell'endpoint Profiles contiene informazioni sul profilo danneggiato, incluso l'attributo type impostato su "danneggiato".

    note important
    IMPORTANT
    Per informazioni dettagliate sulle informazioni fornite in una risposta al profilo, consulta la documentazione API Recupera profilo per mvpd 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.
    • L'integrazione tra serviceProvider e mvpd specificati deve essere attiva.
    Se la convalida di base non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.
    L’endpoint Profili utilizza i dati della richiesta per verificare se sono soddisfatte condizioni di accesso degradate:
    • L'integrazione tra serviceProvider e mvpd specificati deve avere una regola di degradazione AuthNAll applicata.
    Se la convalida degli accessi danneggiati non riesce, la risposta utilizza come valore predefinito il flusso di recupero dei profili di base.

  4. Procedi con i flussi di decisioni: Se la risposta dell'endpoint Profili contiene un profilo, l'applicazione di streaming utilizza le informazioni del profilo degradate per continuare con i flussi di decisioni successivi.

  5. Indicare un nuovo flusso di autenticazione di base: Se la risposta dell'endpoint Profiles non contiene un profilo, l'applicazione di streaming indica all'utente di avviare un nuovo flusso di autenticazione di base.

NOTE
I passaggi per il flusso di recupero del profilo per un codice di autenticazione specifico sono gli stessi di cui sopra, tranne per il fatto che l'endpoint utilizzato è quello descritto nella documentazione di Recupera profilo per codice specifico.
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b