DocumentazioneAdobe PassAutenticazione Adobe Pass

Autenticazione basata su Home per TV Everywhere

Last update: Tue Sep 24 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
Il contenuto di questa pagina viene fornito solo a scopo informativo. L’utilizzo di questa API richiede una licenza corrente di Adobe. Non è consentito alcun uso non autorizzato.

Cos’è l’autenticazione basata su home? whatis-home-based-authn

L'HBA (Home Based Authentication) è una funzionalità di TV Everywhere che consente agli abbonati alla TV a pagamento di visualizzare i contenuti TV online senza immettere le credenziali MVPD quando sono a casa, migliorando in modo significativo l'esperienza utente del flusso di autenticazione.

Home Based Authentication definition del Comitato Tecnologico di Autenticazione Aperta (OATC): "L'autenticazione automatica in casa è il processo mediante il quale un MVPD/OVD utilizza le caratteristiche della rete domestica (o identificatori automaticamente accessibili tra i dispositivi sulla rete domestica) per autenticare quale account abbonato è associato a quella rete domestica, in modo che gli utenti non debbano immettere manualmente le credenziali quando stabiliscono una sessione TVE per accedere al contenuto protetto da TVE."

Per ulteriori informazioni sull'HBA e sugli standard di settore, leggere la documentazione Casi d'uso e requisiti OATC e le Linee guida per l'esperienza utente OATC per l'HBA.

NOTE
Alcuni flussi di HBA fanno parte del pacchetto Premium Workflow. Se sei interessato a utilizzare questa funzionalità, contatta il rappresentante commerciale Adobe Pass.

Perché l'HBA è importante per voi why-hba

L'HBA è importante perché rimuove praticamente la barriera di accesso per i visualizzatori che sono a casa e che dispongono già di un abbonamento via cavo. Inoltre, l'autenticazione basata su Home può aumentare in modo significativo il coinvolgimento degli utenti e offrire una migliore esperienza di utilizzo per i contenuti TV Everywhere.

Attualmente, quasi la metà dei tentativi di accesso non ha esito positivo.

Una volta che l'HBA è stato attivato da uno dei primi 5 MVPD, il tasso di conversione dell'autenticazione è aumentato del 40% (passando dal 45% al 63%)

Di seguito è riportato il tasso di conversione di accesso per un canale integrato con MVPD diversi: quelli che hanno abilitato l'HBA per tale canale e quelli che non ne dispongono. Il tasso di conversione per le schede con HBA è significativamente più elevato rispetto a quelle senza HBA.

Sei mesi dopo aver abilitato l'HBA per la maggior parte dei canali integrati con questo MVPD, abbiamo notato un aumento dell'82% degli utenti univoci (il numero di utenti che accedono ai canali TV Everywhere tramite questo MVPD è quasi raddoppiato).

2w3Al contrario, come si può vedere nel grafico seguente, altri MVPD che non avevano abilitato HBA hanno registrato un aumento del 26% degli utenti univoci negli ultimi 6 mesi.

Dai dati raccolti 6 mesi prima e 6 mesi dopo l'abilitazione dell'HBA, è emerso un notevole aumento del coinvolgimento dei visualizzatori per i canali abilitati all'HBA. In pratica, gli utenti di MVPD che dispongono di HBA abilitati tendono a guardare in media il 30% di contenuti in più rispetto agli utenti di MVPD che non dispongono di HBA abilitati.

Supporto HBA di autenticazione Adobe Pass auth-hba-support

In questa sezione viene descritto il supporto HBA fornito da Adobe Pass Authentication, il comportamento delle piattaforme di autenticazione Adobe Pass nei flussi HBA e vengono inoltre fornite informazioni tecniche utili per l'implementazione di HBA.

Funzionalità di autenticazione Adobe Pass con supporto HBA

  • Possibilità di impostare TTL di autenticazione diversi per le autenticazioni HBA e non HBA (richiede anche il supporto MVPD)
  • Possibilità di selezionare automaticamente un MVPD (ignora selettore MVPD) se l'autenticazione è scaduta. Questo è utile soprattutto quando i TTL degli HBA sono di piccole dimensioni.
  • Possibilità di esporre ai programmatori se l'autenticazione era HBA o meno (richiede anche il supporto MVPD)

Esperienza utente HBA sulle piattaforme di autenticazione Adobe Pass hba-user-exp

Le tabelle seguenti forniscono informazioni sull'esperienza utente per le piattaforme supportate quando l'HBA è abilitato e quando l'HBA non è abilitato:

Flusso utente: tipo di piattaforma
swf, iOS, Android
Con HBA abilitato
Quando gli utenti sono a casa, vengono automaticamente autenticati. Dopo la scadenza del token di autenticazione HBA, gli utenti vengono automaticamente riautenticati.
Senza HBA
Gli utenti vengono invitati a selezionare il proprio MVPD e a immettere le proprie credenziali, anche se si trovano a casa.Dopo la scadenza del token di autenticazione, gli utenti devono immettere di nuovo le proprie credenziali.
Flusso utente: tipo di piattaforma
js, Windows (nativo)
Con HBA abilitato
Quando gli utenti sono a casa, vengono automaticamente autenticati. Dopo la scadenza del token di autenticazione HBA, gli utenti devono riselezionare il proprio MVPD dal selettore e verranno automaticamente autenticati.
Senza HBA
Gli utenti sono invitati a selezionare il proprio MVPD e a immettere le proprie credenziali, anche se si trovano a casa. Dopo la scadenza del token di autenticazione, gli utenti devono immettere nuovamente le credenziali.
Flusso utente: tipo di piattaforma
API REST senza client (autenticazione a seconda schermata)
Con HBA abilitato
Quando gli utenti sono a casa e utilizzano un’app API REST senza client, vengono automaticamente autenticati sul secondo dispositivo a schermo dopo aver inserito il codice di registrazione e aver selezionato il proprio MVPD. Dopo la scadenza del token di autenticazione HBA, gli utenti vengono automaticamente autenticati di nuovo (nella seconda periferica a schermo).
Senza HBA
Gli utenti sono invitati a selezionare il proprio MVPD e a immettere le proprie credenziali, anche se si trovano a casa. Dopo la scadenza del token di autenticazione, gli utenti devono immettere nuovamente le credenziali.

Dettagli tecnici dell'implementazione dell'HBA tech-details-hba

Protocollo OAuth 2.0 oauth-2-protocol

Nel flusso HBA per MVPD integrati con il protocollo di autenticazione OAuth 2.0, MVPD emette un token di aggiornamento e un Adobe emette un token di autenticazione HBA:

  • Il token di aggiornamento ha un TTL determinato dai requisiti aziendali di MVPD.
  • Il valore TTL del token di autenticazione HBA deve essere minore o uguale a del valore TTL del token di aggiornamento.

Descrizione del flusso di autenticazione HBA per il protocollo OAuth 2.0

Azioni utente
Azioni di sistema
L’utente passa al sito del programmatore. Quando si tenta di riprodurre un video, viene visualizzato il selettore MVPD. L’utente seleziona il proprio MVPD e fa clic sull’accesso.
Viene eseguito un controllo dei precedenti personali. L'MVPD applica il proprio insieme di regole per il rilevamento utente (ad esempio, mappare l'indirizzo IP dell'utente con l'indirizzo MAC dei modem forniti dal distributore o dei set-top box connessi a banda larga).
Viene visualizzata una schermata, che persiste per circa 3 secondi. È possibile visualizzare una pagina interstiziale per informare l'utente che l'accesso viene eseguito automaticamente utilizzando il proprio account MVPD.
  1. AccessEnabler, installato sul lato del programmatore, invia una richiesta di autenticazione (come richiesta HTTP) all’endpoint di autenticazione di Adobe Pass.
  2. L’endpoint di autenticazione Adobe Pass reindirizza la richiesta all’endpoint di autenticazione MVPD.
    Nota: la richiesta contiene il parametro hba_flag (tentativo HBA = true) che indica che MVPD deve tentare l'autenticazione HBA.
  3. L’endpoint di autenticazione MVPD invia un codice di autorizzazione all’endpoint di autenticazione Adobe Pass.
  4. L’autenticazione di Adobe Pass utilizza il codice di autorizzazione per richiedere un token di aggiornamento e un token di accesso dall’endpoint del token MVPD.
  5. MVPD invia una decisione di autenticazione e il parametro hba_status (true/false) in id_token.
  6. Viene inviata una chiamata all'endpoint del profilo utente MVPD per esporre la chiave hba_status nei metadati utente.
  7. MVPD imposta il TTL del token di aggiornamento su un valore concordato con MVPD e Adobe imposta il TTL del token di autenticazione su un valore minore o uguale al valore del token di aggiornamento.
L’utente è autenticato e ora può sfogliare contenuti TV Everywhere autorizzati.
Il token di autenticazione viene passato all’utente che ora può esplorare correttamente il sito del programmatore.

Protocollo SAML saml-protocol

Descrizione del flusso di autenticazione HBA per il protocollo di autenticazione SAML

Azioni utente
Azioni di sistema
L’utente passa al sito del programmatore. Quando si tenta di riprodurre un video, viene visualizzato il selettore MVPD. L’utente seleziona il proprio MVPD e fa clic sull’accesso.
Viene eseguito un controllo dei precedenti personali. L'MVPD applica il proprio insieme di regole per il rilevamento utente (ad esempio, mappare l'indirizzo IP dell'utente con l'indirizzo MAC dei modem forniti dal distributore o dei set-top box connessi a banda larga).
Viene visualizzata una schermata, che persiste per circa 3 secondi. È possibile visualizzare una pagina interstiziale per informare l'utente che l'accesso viene eseguito automaticamente utilizzando il proprio account MVPD.
  1. AccessEnabler, installato sul lato del programmatore, invia una richiesta di autenticazione (come richiesta HTTP) all’endpoint di autenticazione di Adobe Pass.
  2. L’endpoint di autenticazione Adobe Pass reindirizza la richiesta all’endpoint di autenticazione MVPD.
  3. MVPD deve inviare una decisione di autenticazione sotto forma di risposta SAML che deve contenere il flag HBA: hba_status (true/false).
  4. Viene inviata una chiamata all'endpoint del profilo utente MVPD per esporre la chiave hba_status nei metadati utente.
L’utente è autenticato e ora può sfogliare contenuti TV Everywhere autorizzati.
Il token di autenticazione viene passato all’utente che ora può esplorare correttamente il sito del programmatore.

Come attivare l'HBA how-to-activate-hba

  • Protocollo OAuth:
  • Protocollo SAML: autenticazione basata su Home attivata sul lato MVPD. Non è richiesta alcuna azione da parte del programmatore o dell’Adobe.
    Per ulteriori informazioni sugli MVPD che supportano l'autenticazione basata su Home, vedere Stato HBA per MVPD.

Domande frequenti faqs

Domanda: Perché separare l'autenticazione basata su home dai protocolli SAML e OAuth2?

Risposta: Il flusso HBA è diverso per i due protocolli. Dal punto di vista del programmatore, non è necessario intervenire per garantire che l'HBA sia abilitato per gli MVPD SAML, mentre per gli MVPD OAuth2 l'HBA può essere attivato o disattivato nella dashboard di Adobe Pass TVE.

Domanda: Gli utenti devono immettere un nome utente e una password la prima volta che eseguono l'autenticazione quando l'HBA è abilitato?

Risposta: No, il nome utente e la password non sono richiesti.

Domanda: Come si applica il controllo genitori?

Risposta 1: L'Adobe può disabilitare l'HBA per le integrazioni con canali che richiedono l'approvazione del controllo genitori.

Risposta 2: L'Adobe utilizza OATC in un documento UX che consiglia di configurare l'esperienza HBA con Controllo genitori.

Domanda: I provider che supportano l'HBA dispongono di finestre TTL più brevi per l'HBA rispetto all'autenticazione regolare?

Risposta: L'impostazione TTL è configurabile. È consigliabile impostare un valore TTL più breve per i token di autenticazione HBA per evitare errori di gestione.

Informazioni utili useful-info

recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b