DocumentazioneAdobe PassAutenticazione Adobe Pass

Manuale Apple SSO (REST API V2) apple-sso-cookbook-rest-api-v2

Last update: Wed Nov 13 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.

L’API REST per l’autenticazione di Adobe Pass V2 supporta l’SSO (Single Sign-On) per i partner per gli utenti finali delle applicazioni client in esecuzione su iOS, iPadOS o tvOS.

Questo documento funge da estensione della Panoramica API REST V2 esistente che fornisce una visualizzazione di alto livello e il documento che descrive come implementare Single Sign-On utilizzando i flussi dei partner.

Single Sign-On di Apple tramite i flussi dei partner cookbook

Prerequisiti prerequisites

Prima di procedere con il Single Sign-On Apple utilizzando i flussi di partner, verifica che siano soddisfatti i seguenti prerequisiti:

  • L'applicazione di streaming deve raccogliere tutti i dati necessari richiesti dalle intestazioni X-Device-Info e/o User-Agent in modo che il backend di autenticazione di Adobe Pass possa identificare la piattaforma del dispositivo e le relative funzionalità. Per ulteriori dettagli sull'intestazione X-Device-Info, consulta la documentazione X-Device-Info.

  • L’applicazione di streaming deve richiedere l’accesso alle informazioni di abbonamento dell’utente salvate a livello di dispositivo, per le quali l’utente deve concedere l’autorizzazione all’applicazione per procedere, in modo analogo a fornire l’accesso alla fotocamera o al microfono del dispositivo. Questa autorizzazione deve essere richiesta per applicazione utilizzando il framework dell'account dell'utente con sottoscrizione video di Apple e il dispositivo salverà la selezione dell'utente.

    È consigliabile incentivare gli utenti che rifiutano di concedere l'autorizzazione per l'accesso alle informazioni sull'abbonamento illustrando i vantaggi dell'esperienza utente Single Sign-On di Apple, ma è bene tenere presente che l'utente può modificare la propria decisione accedendo alle impostazioni dell'applicazione (autorizzazione di accesso del provider TV) o a Settings -> TV Provider su iOS e iPadOS o a Settings -> Accounts -> TV Provider su tvOS.

    L'applicazione di streaming può richiedere l'autorizzazione dell'utente quando l'applicazione entra in primo piano, perché l'applicazione può controllare l'autorizzazione per accedere alle informazioni di abbonamento dell'utente in qualsiasi momento prima di richiedere l'autenticazione dell'utente.

IMPORTANT
Presupposti
  • L'applicazione di streaming ha completato i prerequisiti per l'onboarding applicabili a un programmatore e necessari per abilitare l'esperienza utente Single Sign-On di Apple.

Flusso di lavoro workflow

Segui i passaggi forniti per implementare il Single Sign-On Apple utilizzando i flussi dei partner, come illustrato nel diagramma seguente.

Single Sign-On Apple tramite flussi di partner

Single Sign-On Apple tramite flussi di partner

A. Fase di registrazione

  1. Recupera credenziali client: L'applicazione di streaming raccoglie tutti i dati necessari per recuperare le credenziali client chiamando l'endpoint Registro client.

    note important
    IMPORTANT
    Per informazioni dettagliate su Recuperare le credenziali del client, consulta la documentazione API di:
    • Tutti i parametri required, come software_statement
    • Tutte le intestazioni required, come Content-Type, X-Device-Info
    • Tutti i parametri e le intestazioni optional

  2. Restituisci credenziali client: La risposta dell'endpoint Registro client contiene informazioni sulle credenziali client associate ai parametri e alle intestazioni ricevuti.

    note important
    IMPORTANT
    Per informazioni dettagliate sulle informazioni fornite in una risposta alle credenziali del client, consultare la documentazione API Recupera credenziali client.
    Il registro client 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 API Retrieve client credentials.
    note tip
    TIP
    Suggerimento: le credenziali del client devono essere memorizzate nella cache e possono essere utilizzate a tempo indefinito.

  3. Recupera token di accesso: L'applicazione di streaming raccoglie tutti i dati necessari per recuperare il token di accesso chiamando l'endpoint del token client.

    note important
    IMPORTANT
    Per informazioni dettagliate su Recupera token di accesso, consulta la documentazione API di:
    • Tutti i parametri required, come client_id, client_secret e grant_type
    • Tutte le intestazioni required, come Content-Type, X-Device-Info
    • Tutti i parametri e le intestazioni optional

  4. Token di accesso restituito: La risposta dell'endpoint del token client contiene informazioni sul token di accesso associato ai parametri e alle intestazioni ricevuti.

    note important
    IMPORTANT
    Per informazioni dettagliate sulle informazioni fornite in una risposta del token di accesso, consulta la documentazione API Recupera token di accesso.
    Il token client 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 API Recupera token di accesso.
    note tip
    TIP
    Suggerimento: il token di accesso deve essere memorizzato in cache e utilizzato solo entro la durata specificata (ad esempio, time-to-live di 24 ore). Dopo la scadenza, l’applicazione di streaming deve richiedere un nuovo token di accesso.
B. Verifica fase di autenticazione

  1. Recupera stato framework partner: L'applicazione di streaming chiama il Framework account sottoscrittore video sviluppato da Apple per ottenere le autorizzazioni utente e le informazioni sul provider.

    note important
    IMPORTANT
    Per informazioni dettagliate su Video Subscriber Account Framework, consulta:
    • L'applicazione di streaming deve verificare la presenza di autorizzazioni per accedere alle informazioni di sottoscrizione dell'utente e procedere solo se l'utente lo ha consentito.
    • L'applicazione di streaming deve fornire un delegato per VSAccountManager.
    • L'applicazione di streaming deve inviare una richiesta per le informazioni sull'account del sottoscrittore.
    • L'applicazione di streaming deve attendere ed elaborare le informazioni di metadati.
    L'applicazione di streaming deve verificare di specificare un valore booleano uguale a false per la proprietà isInterruptionAllowed nell'oggetto VSAccountMetadataRequest, per indicare che l'utente non può essere interrotto in questa fase.

  2. Restituisci informazioni sullo stato del framework partner: L'applicazione di streaming convalida i dati di risposta per verificare che siano soddisfatte le condizioni di base:

    • Lo stato di accesso dell’autorizzazione utente è concesso.
    • Identificatore di mapping del provider utente presente e valido.
    • La data di scadenza del profilo del provider utente (se disponibile) è valida.

  3. Recupera profili: L'applicazione di streaming raccoglie tutti i dati necessari per recuperare tutte le informazioni sui profili inviando una richiesta all'endpoint Profili.

    note important
    IMPORTANT
    Per informazioni dettagliate su Recuperare i profili, consulta la documentazione API di:
    • Tutti i parametri required, come serviceProvider
    • Tutte le intestazioni required, come Authorization, AP-Device-Identifier e AP-Partner-Framework-Status
    • Tutti i parametri e le intestazioni optional
    L’applicazione di streaming deve garantire di includere un valore valido per lo stato del framework del partner in modo che la risposta recuperata possa includere un profilo di tipo "appleSSO".
    Per ulteriori dettagli sull'intestazione AP-Partner-Framework-Status, consulta la documentazione AP-Partner-Framework-Status.

  4. Informazioni restituite sui profili trovati: La risposta dell'endpoint Profiles contiene informazioni sui profili trovati associati ai parametri e alle intestazioni ricevuti.

  5. Scegli un profilo e procedi con i flussi di decisioni: Se la risposta dell'endpoint Profili contiene profili, l'applicazione di streaming utilizza la propria logica interna (eventualmente interagendo con l'utente finale) per scegliere uno dei profili disponibili per continuare con i flussi di decisioni successivi.

  6. Procedi con il flusso di autenticazione partner: Se la risposta dell'endpoint Profiles non contiene un profilo, l'applicazione di streaming continua con il flusso di autenticazione partner.

C. Fase di autenticazione partner

  1. Recupera configurazione: L'applicazione di streaming raccoglie tutti i dati necessari per recuperare l'elenco degli MVPD con un'integrazione attiva inviando una richiesta all'endpoint di configurazione.

    note important
    IMPORTANT
    Per informazioni dettagliate su Recuperare la configurazione per un provider di servizi specifico, fare riferimento alla documentazione API di Recuperare la configurazione per:
    • Tutti i parametri required, come serviceProvider
    • Tutte le intestazioni required, come Authorization, AP-Device-Identifier e X-Device-Info
    • Tutti i parametri e le intestazioni optional

  2. Configurazione restituita: La risposta dell'endpoint Configuration contiene informazioni sugli MVPD con un'integrazione attiva con il provider di servizi.

    note important
    IMPORTANT
    Per informazioni dettagliate sulle informazioni fornite in una risposta alla configurazione, fare riferimento alla documentazione API Recupera configurazione per un provider di servizi specifico.
    L’endpoint Configuration 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 ai codici di errore avanzati
    note important
    IMPORTANT
    L’applicazione di streaming deve garantire che, nel procedere, elabori i seguenti dettagli forniti per ogni MVPD:
    • enablePlatformServices: indica se MVPD supporta attualmente il Single Sign-On di Apple.
    • displayInPlatformPicker: indica se MVPD può essere visualizzato nel selettore Apple.
    • boardingStatus: indica se MVPD è integrato nel Single Sign-On di Apple.

  3. Recupera stato framework partner: L'applicazione di streaming chiama il Framework account sottoscrittore video sviluppato da Apple per ottenere le autorizzazioni utente e le informazioni sul provider.

    note important
    IMPORTANT
    Per informazioni dettagliate su Video Subscriber Account Framework, consulta:
    • L'applicazione di streaming deve verificare la presenza di autorizzazioni per accedere alle informazioni di sottoscrizione dell'utente e procedere solo se l'utente lo ha consentito.
    • L'applicazione di streaming deve fornire un delegato per VSAccountManager.
    • L'applicazione di streaming deve inviare una richiesta per le informazioni sull'account del sottoscrittore.
    • L'applicazione di streaming deve attendere ed elaborare le informazioni di metadati.
    L'applicazione di streaming deve verificare di specificare un valore booleano uguale a true per la proprietà isInterruptionAllowed nell'oggetto VSAccountMetadataRequest, per indicare che l'utente può essere interrotto per selezionare il provider TV in questa fase.

  4. Restituisci informazioni sullo stato del framework partner: L'applicazione di streaming convalida i dati di risposta per verificare che siano soddisfatte le condizioni di base:

    • Lo stato di accesso dell’autorizzazione utente è concesso.
    • Identificatore di mapping del provider utente presente e valido.
    • La data di scadenza del profilo del provider utente (se disponibile) è valida.

  5. Recupera richiesta di autenticazione partner: L'applicazione di streaming raccoglie tutti i dati necessari per avviare una sessione di autenticazione chiamando l'endpoint Sessions Partner.

    note important
    IMPORTANT
    Per informazioni dettagliate su Recuperare la richiesta di autenticazione partner, consulta la documentazione API di:
    • Tutti i parametri required, come serviceProvider e partner
    • Tutte le intestazioni required come Authorization, AP-Device-Identifier, Content-Type, X-Device-Info e AP-Partner-Framework-Status
    • Tutte le intestazioni e i parametri optional
    L’applicazione di streaming deve garantire di includere un valore valido per lo stato del framework del partner in modo che la risposta recuperata possa includere una richiesta di autenticazione del partner (richiesta SAML).
    Per ulteriori dettagli sull'intestazione AP-Partner-Framework-Status, consulta la documentazione AP-Partner-Framework-Status.

  6. Indicare l'azione successiva: La risposta dell'endpoint Sessions Partner 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 della sessione, consultare la documentazione API Recupera richiesta di autenticazione partner.
    L’endpoint Sessions Partner 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 Partner convalida i dati della richiesta per garantire che vengano soddisfatte le condizioni di single sign-on del partner:
    • La configurazione Single Sign-On del partner nel server Adobe Pass deve essere valida e abilitata.
    • Il payload dello stato del framework partner ricevuto tramite l'intestazione AP-Partner-Framework-Status deve essere valido.
    Se la convalida Single Sign-On del partner non riesce, la risposta viene impostata come flusso di autenticazione di base per impostazione predefinita.

  7. Procedi con i flussi di decisioni: La risposta dell'endpoint del partner sessioni 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.

  8. Procedi con il flusso di autenticazione di base: La risposta dell'endpoint Sessions Partner contiene i dati seguenti:

    • L'attributo actionName è impostato su "authenticate" o "resume".
    • L'attributo actionType è impostato su "interactive" o "direct".

    Se il backend di Adobe Pass non identifica un profilo valido e la convalida single sign-on del partner non riesce, il server Adobe Pass torna al flusso di autenticazione di base.

    Per ulteriori dettagli sul flusso di autenticazione di base, consulta i seguenti documenti:

  9. Procedere con il recupero del profilo utilizzando il flusso di risposta di autenticazione partner: La risposta dell'endpoint del partner sessioni contiene i dati seguenti:

    • L'attributo actionName è impostato su "partner_profile".
    • L'attributo actionType è impostato su "direct".
    • L'attributo authenticationRequest - type include il protocollo di sicurezza utilizzato dal framework partner per l'accesso MVPD (attualmente impostato solo su SAML).
    • L'attributo authenticationRequest - request include la richiesta SAML passata al framework partner.
    • L'attributo authenticationRequest - attributesNames include gli attributi SAML passati al framework partner.

    Se il backend di Adobe Pass non identifica un profilo valido e il partner passa la convalida single sign-on, l’applicazione di streaming riceve una risposta con azioni e dati da passare al framework partner per avviare il flusso di autenticazione con MVPD.

  10. Completare l'autenticazione MVPD con il framework partner: Inoltrare la richiesta di autenticazione partner (richiesta SAML) ottenuta nel passaggio precedente al Framework account sottoscrittore video. Se il flusso di autenticazione ha esito positivo, l'interazione Framework account sottoscrittore video con MVPD genera una risposta di autenticazione partner (risposta SAML) restituita insieme alle informazioni sullo stato del framework partner.

    note important
    IMPORTANT
    Per informazioni dettagliate su Video Subscriber Account Framework, consulta:
    • L'applicazione di streaming deve verificare la presenza di autorizzazioni per accedere alle informazioni di sottoscrizione dell'utente e procedere solo se l'utente lo ha consentito.
    • L'applicazione di streaming deve fornire un delegato per VSAccountManager.
    • L'applicazione di streaming deve inviare una richiesta per le informazioni sull'account del sottoscrittore e deve includere la richiesta di autenticazione partner (richiesta SAML) ottenuta nel passaggio precedente.
    • L'applicazione di streaming deve attendere ed elaborare le informazioni di metadati.
    L'applicazione di streaming deve verificare di specificare un valore booleano uguale a true per la proprietà isInterruptionAllowed nell'oggetto VSAccountMetadataRequest, per indicare che l'utente può essere interrotto per l'autenticazione con il provider TV selezionato in questa fase.

  11. Risposta di autenticazione partner di ritorno: L'applicazione di streaming convalida i dati di risposta per verificare che siano soddisfatte le condizioni di base:

    • Lo stato di accesso dell’autorizzazione utente è concesso.
    • Identificatore di mapping del provider utente presente e valido.
    • La data di scadenza del profilo del provider utente (se disponibile) è valida.
    • La risposta di autenticazione del partner (risposta SAML) è presente e valida.

  12. Recupera profilo utilizzando la risposta di autenticazione partner: L'applicazione di streaming raccoglie tutti i dati necessari per creare e recuperare un profilo chiamando l'endpoint partner Profili.

    note important
    IMPORTANT
    Per informazioni dettagliate su Recuperare il profilo utilizzando la risposta di autenticazione partner, consultare la documentazione API:
    • Tutti i parametri required, come serviceProvider, partner e SAMLResponse
    • Tutte le intestazioni required, come Authorization, AP-Device-Identifier, Content-Type, X-Device-Info e AP-Partner-Framework-Status
    • Tutte le intestazioni e i parametri optional
    L’applicazione di streaming deve garantire di includere valori validi per lo stato del framework del partner e la risposta di autenticazione del partner (risposta SAML) in modo che la risposta recuperata possa includere un profilo di tipo "appleSSO".
    Per ulteriori dettagli sull'intestazione AP-Partner-Framework-Status, consulta la documentazione AP-Partner-Framework-Status.

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

    note important
    IMPORTANT
    Per informazioni dettagliate sulle informazioni fornite in una risposta del profilo, consulta la documentazione API Recupera profilo tramite risposta di autenticazione partner.
    L’endpoint Partner 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 non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.
    L’endpoint Partner Profili convalida i dati della richiesta per garantire che siano soddisfatte le condizioni di single sign-on del partner:
    • La configurazione Single Sign-On del partner nel server Adobe Pass deve essere valida e abilitata.
    • Il payload dello stato del framework partner ricevuto tramite l'intestazione AP-Partner-Framework-Status deve essere valido.
    Se la convalida Single Sign-On del partner non riesce, la risposta viene impostata come predefinita sul flusso di recupero dei profili di base.

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

D. Fase decisionale

  1. Recupera stato framework partner: L'applicazione di streaming chiama il Framework account sottoscrittore video sviluppato da Apple per ottenere le autorizzazioni utente e le informazioni sul provider.

    note important
    IMPORTANT
    Per informazioni dettagliate su Video Subscriber Account Framework, consulta:
    • L'applicazione di streaming deve verificare la presenza di autorizzazioni per accedere alle informazioni di sottoscrizione dell'utente e procedere solo se l'utente lo ha consentito.
    • L'applicazione di streaming deve fornire un delegato per VSAccountManager.
    • L'applicazione di streaming deve inviare una richiesta per le informazioni sull'account del sottoscrittore.
    • L'applicazione di streaming deve attendere ed elaborare le informazioni di metadati.
    L'applicazione di streaming deve verificare di specificare un valore booleano uguale a false per la proprietà isInterruptionAllowed nell'oggetto VSAccountMetadataRequest, per indicare che l'utente non può essere interrotto in questa fase.
    note tip
    TIP
    Suggerimento: l’applicazione di streaming può utilizzare un valore memorizzato nella cache per le informazioni sullo stato del framework del partner, che consigliamo di aggiornare quando l’applicazione passa dallo stato in background a quello in primo piano.

  2. Restituisci informazioni sullo stato del framework partner: L'applicazione di streaming convalida i dati di risposta per verificare che siano soddisfatte le condizioni di base:

    • Lo stato di accesso dell’autorizzazione utente è concesso.
    • Identificatore di mapping del provider utente presente e valido.
    • La data di scadenza del profilo del provider utente (se disponibile) è valida.

  3. 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
    L’applicazione di streaming deve garantire di includere un valore valido per lo stato del framework del partner prima di effettuare un’ulteriore richiesta, quando il profilo scelto è di tipo "appleSSO".
    Per ulteriori dettagli sull'intestazione AP-Partner-Framework-Status, consulta la documentazione AP-Partner-Framework-Status.

  4. Decisioni di pre-autorizzazione restituite: La risposta dell'endpoint di preautorizzazione delle decisioni contiene una decisione Permit o Deny per ogni risorsa:

    • Una decisione Permit indica che la risorsa è riproducibile. La risposta non include un token multimediale, poiché il flusso di preautorizzazione non deve essere utilizzato per riprodurre le risorse.
    • Una decisione Deny indica che la risorsa non è riproducibile. La risposta include un payload di errore conforme alla documentazione di Codici di errore avanzati.
    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 non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.

  5. Recupera stato framework partner: L'applicazione di streaming chiama il Framework account sottoscrittore video sviluppato da Apple per ottenere le autorizzazioni utente e le informazioni sul provider.

    note important
    IMPORTANT
    Per informazioni dettagliate su Video Subscriber Account Framework, consulta:
    • L'applicazione di streaming deve verificare la presenza di autorizzazioni per accedere alle informazioni di sottoscrizione dell'utente e procedere solo se l'utente lo ha consentito.
    • L'applicazione di streaming deve fornire un delegato per VSAccountManager.
    • L'applicazione di streaming deve inviare una richiesta per le informazioni sull'account del sottoscrittore.
    • L'applicazione di streaming deve attendere ed elaborare le informazioni di metadati.
    L'applicazione di streaming deve verificare di specificare un valore booleano uguale a false per la proprietà isInterruptionAllowed nell'oggetto VSAccountMetadataRequest, per indicare che l'utente non può essere interrotto in questa fase.
    note tip
    TIP
    Suggerimento: l’applicazione di streaming può utilizzare un valore memorizzato nella cache per le informazioni sullo stato del framework del partner, che consigliamo di aggiornare quando l’applicazione passa dallo stato in background a quello in primo piano.

  6. Restituisci informazioni sullo stato del framework partner: L'applicazione di streaming convalida i dati di risposta per verificare che siano soddisfatte le condizioni di base:

    • Lo stato di accesso dell’autorizzazione utente è concesso.
    • Identificatore di mapping del provider utente presente e valido.
    • La data di scadenza del profilo del provider utente (se disponibile) è valida.

  7. 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
    L’applicazione di streaming deve garantire di includere un valore valido per lo stato del framework del partner prima di effettuare un’ulteriore richiesta, quando il profilo scelto è di tipo "appleSSO".
    Per ulteriori dettagli sull'intestazione AP-Partner-Framework-Status, consulta la documentazione AP-Partner-Framework-Status.

  8. Decisione di autorizzazione di ritorno: La risposta dell'endpoint Authorize Decisions contiene una decisione Permit o Deny per la risorsa specifica:

    • Una decisione Permit indica che la risorsa è riproducibile. La risposta include un token multimediale.
    • Una decisione Deny indica che la risorsa non è riproducibile. La risposta include un payload di errore conforme alla documentazione di Codici di errore avanzati.
    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 non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.
D. Fase di disconnessione

  1. Avvia disconnessione di Adobe Pass: L'applicazione di streaming raccoglie tutti i dati necessari per avviare il flusso di disconnessione chiamando l'endpoint di disconnessione di Adobe Pass.

    note important
    IMPORTANT
    Per informazioni dettagliate su: Avvia disconnessione per la documentazione API specifica di mvpd:
    • Tutti i parametri required, come serviceProvider, mvpd e redirectUrl
    • Tutte le intestazioni required, come Authorization, AP-Device-Identifier
    • Tutti i parametri e le intestazioni optional

  2. Indicare l'azione successiva: La risposta dell'endpoint di disconnessione di Adobe Pass 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 disconnessione, consultare la Iniziare la disconnessione per la documentazione API mvpd specifica.
    L’endpoint di disconnessione di Adobe Pass 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 important
    IMPORTANT
    L’applicazione di streaming deve garantire che indichi all’utente di continuare a disconnettersi ulteriormente dal livello partner.
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b