Decisioni decisions
Le decisioni vengono generate dall'autenticazione Adobe Pass REST API V2 in base alle richieste di autorizzazione MVPD o di preautorizzazione dell'utente, determinando se l'accesso a contenuto protetto è concesso o negato.
Esistono due tipi di decisioni che vengono fornite, a seconda dell’API richiamata:
- Decisioni di pre-autorizzazione che sono decisioni informative.
- Decisioni di autorizzazione che sono decisioni autorevoli.
Decisioni di pre-autorizzazione preauthorization-decisions
La decisione di preautorizzazione è una decisione informativa che consente all'applicazione client di essere informata se MVPD può consentire o negare l'accesso dell'utente a una risorsa protetta.
Lo scopo della pre-autorizzazione (autorizzazione di verifica preliminare) è quello di consentire all’applicazione di visualizzare informazioni accurate sul contenuto che l’utente può visualizzare. Ciò si ottiene ottimizzando l’interfaccia utente con indicatori, come icone bloccate o sbloccate, per riflettere lo stato di accesso.
L’utilizzo dell’API di preautorizzazione non è obbligatorio; l’applicazione client può saltarlo se desidera presentare un catalogo di risorse senza alcun filtro.
Se l’applicazione client intende utilizzare questa funzione, è importante notare che le decisioni di preautorizzazione possono essere ottenute solo per un numero limitato di risorse per richiesta API, in genere fino a 5.
Gli MVPD possono supportare la preautorizzazione tramite vari meccanismi, ciascuno con implicazioni distinte per le prestazioni e il numero massimo di risorse che possono essere gestite in una singola richiesta API.
Per ulteriori dettagli sui meccanismi esistenti che supportano la preautorizzazione, consulta la documentazione Autorizzazione verifica preliminare MVPD.
Decisioni di autorizzazione authorization-decisions
La decisione di autorizzazione è una decisione autorevole che consente all'applicazione client di essere conforme alla decisione di MVPD di consentire o negare l'accesso dell'utente a una risorsa protetta.
Lo scopo dell’autorizzazione è consentire all’applicazione di riprodurre le risorse richieste dall’utente, dopo la convalida dei diritti con MVPD e la ricezione di un token multimediale dall’autenticazione di Adobe Pass.
L’utilizzo dell’API di autorizzazione è obbligatorio; l’applicazione client non può saltare questa fase se desidera riprodurre le risorse richieste dall’utente, in quanto richiede la verifica con il MVPD che l’utente abbia diritto prima di rilasciare il flusso.
È importante notare che le decisioni di autorizzazione possono essere ottenute solo per un numero limitato di risorse per richiesta API, in genere 1.
Gestione TTL (Time-to-Live) delle autorizzazioni authorization-ttl-management
Il valore TTL (Authorization Time-to-Live) definisce per quanto tempo una risorsa rimane autorizzata prima di dover essere nuovamente autorizzata. Questo periodo di tempo è limitato e deve essere concordato con i rappresentanti di MVPD. I valori TTL possono variare in base a:
- Categoria piattaforma (ad esempio desktop, dispositivi mobili, dispositivi collegati alla TV)
- Piattaforma specifica (ad esempio iOS, Android, tvOS, Roku, FireTV)
Il TTL di autorizzazione (authZ) può essere visualizzato e modificato tramite Adobe Pass TVE Dashboard da uno degli amministratori dell'organizzazione o da un rappresentante di Adobe Pass Authentication che agisce per tuo conto.
Per ulteriori dettagli, consulta la Guida utente per l'integrazione del dashboard di TVE.
Risorse protette protected-resources
Le risorse protette si riferiscono a contenuti semplificabili, identificati da valori univoci definiti tramite accordi tra MVPD e programmatori partecipanti.
Le risorse protette seguono una struttura gerarchica ad albero, in cui ogni livello fornisce maggiore granularità per l’autorizzazione dei contenuti:
- Rete
- Canale
- Spettacolo
- Episodio
- Risorsa
- Episodio
- Spettacolo
- Canale
CDATA sezioni in caso di pre-autorizzazione, in quanto vengono utilizzate principalmente per risorse a livello di risorsa definite da un MRSS.Identificatore risorsa resource-identifier
L’identificatore univoco della risorsa può avere due formati:
- Un formato di stringa semplice, ad esempio un identificatore univoco per un canale (brand).
- Un formato RSS per contenuti multimediali (MRSS) contenente informazioni aggiuntive come il titolo, le valutazioni e i metadati per il controllo genitori.
Nel caso di un identificatore di risorsa semplice, ad esempio "REF30" (che si presume rappresenti un canale), può essere convertito in un identificatore di risorsa RSS come segue:
<rss version="2.0">
<channel>
<title>REF30</title>
</channel>
</rss>
Nel caso di un identificatore di risorsa più complesso, l'identificatore di risorsa RSS può includere informazioni di valutazione aggiuntive come indicato di seguito:
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/">
<channel>
<title>REF30</title>
<media:rating scheme="urn:mpaa">pg</media:rating>
</channel>
</rss>
Gli identificatori univoci sono principalmente opachi all’autenticazione di Adobe Pass, tuttavia i trasformatori possono essere applicati in base alle funzionalità e ai requisiti di MVPD. Se MVPD non è in grado di riconoscere o analizzare un identificatore di risorsa, restituisce un errore ad Adobe Pass Authentication, che successivamente invia l'errore all'applicazione client utilizzando un Codice di errore avanzato.
API REST V2 rest-api-v2
Le decisioni di preautorizzazione possono essere recuperate utilizzando la seguente API:
Le decisioni di autorizzazione possono essere recuperate utilizzando la seguente API:
Consulta le sezioni Response e Samples delle API di cui sopra per comprendere la struttura delle decisioni di preautorizzazione e autorizzazione.
Per ulteriori dettagli su come e quando integrare le API di cui sopra, consulta i seguenti documenti: