Riferimento API dell'SDK JavaScript javascript-sdk-api-reference
Riferimento API api-reference
Queste funzioni avviano richieste di interazione con un MVPD. Tutte le chiamate sono asincrone; devi implementare callback per gestire le risposte:
setRequestor (inRequestorID, endpoint, opzioni) setrequestor(inRequestorID,endpoints,options)
Descrizione: Identifica il sito da cui provengono le richieste. Devi effettuare questa chiamata prima di qualsiasi altra chiamata API in una sessione di comunicazione.
Parametri:
-
inRequestorID - L'identificatore univoco assegnato dall'Adobe al sito di origine durante la registrazione.
-
endpoint - Questo parametro è facoltativo. Può corrispondere a uno dei seguenti valori:
- Array che consente di specificare gli endpoint per i servizi di autenticazione e autorizzazione forniti da Adobe (a scopo di debug possono essere utilizzate istanze diverse). Nel caso in cui vengano forniti più URL, l’elenco MVPD è composto dagli endpoint di tutti i fornitori di servizi. Ogni MVPD è associato al provider di servizi più veloce, ovvero il provider che ha risposto per primo e che supporta tale MVPD. Per impostazione predefinita (se non viene specificato alcun valore), viene utilizzato il provider di servizi Adobe (http://sp.auth.adobe.com/).
Esempio:
setRequestor("IFC", ["http://sp.auth-dev.adobe.com/adobe-services"])
-
opzioni : oggetto JSON contenente il valore ID applicazione, le impostazioni senza aggiornamento del valore ID visitatore (accesso in background logout) e le impostazioni MVPD (iFrame). Tutti i valori sono facoltativi.
- Se specificato, l’ID visitatore Experience Cloud viene riportato su tutte le chiamate di rete eseguite dalla libreria. Il valore può essere successivamente utilizzato per i rapporti di analisi avanzati.
- Se è specificato l’identificatore univoco dell’applicazione -
applicationId: il valore viene aggiunto a tutte le chiamate successive effettuate dall’applicazione come parte dell’intestazione HTTP X-Device-Info. Questo valore può essere recuperato in un secondo momento da ESM segnala utilizzando la query corretta.
Nota: Tutte le chiavi JSON fanno distinzione tra maiuscole e minuscole.
Esempio:
setRequestor("IFC", {
"visitorID": "THE_ECID_VALUE",
"applicationId": "APP_ID_VALUE"
})
- Il programmatore può ignorare le impostazioni MVPD configurate nell’autenticazione di Adobe Pass, specificando se è necessario un iFrame per l’accesso (iFrameRequired key) e le dimensioni iFrame (iFrameWidth e iFrameHeight tasti ). L’oggetto JSON presenta il seguente modello:
{
"visitorID": <string>,
"backgroundLogin": <boolean>,
"backgroundLogout": <boolean>,
"mvpdConfig":{
"MVPD_ID_1":{
"iFrameRequired": <boolean>,
"iFrameWidth": <integer>,
"iFrameHeight": <integer>
},
...
"MVPD_ID_N":{
"iFrameRequired": <boolean>,
"iFrameWidth": <integer>,
"iFrameHeight": <integer>
}
}
}
Tutte le chiavi di primo livello nel modello precedente sono facoltative e hanno valori predefiniti (backgroundLogin, backgroundLogout sono false per impostazione predefinita e mvpdConfig è null, ovvero nessuna impostazione MVPD viene ignorata).
- Nota: specificando valori o tipi non validi per i parametri di cui sopra, si verifica un comportamento non definito.
Di seguito è riportata una configurazione di esempio per lo scenario seguente: attivazione dell’accesso senza aggiornamento e della disconnessione, modifica di MVPD1 con accesso con reindirizzamento a pagina intera (non iFrame) e accesso di MVPD2 con iFrame con larghezza=500 e altezza=300:
{
"backgroundLogin": true,
"backgroundLogout": true,
"mvpdConfig":{
"MVPD1":{
"iFrameRequired": false
},
"MVPD2":{
"iFrameRequired": true,
"iFrameWidth": 500,
"iFrameHeight": 300
}
}
}
Callback attivati: setConfig()
getAuthorization(inResourceID, redirect_url) getauthorization(inresourceid,redirect_url)
Descrizione: Richiede l'autorizzazione per la risorsa specificata. Ogni volta che un cliente tenta di accedere a una risorsa autorizzabile, chiama questa funzione per ottenere un token di autorizzazione di breve durata da Access Enabler. Gli ID risorsa sono concordati con l'MVPD che fornisce l'autorizzazione.
Utilizza il token di autenticazione nella cache per il cliente corrente. Se non viene trovato alcun token di questo tipo, avvia prima il processo di autenticazione, quindi continua con l’autorizzazione.
Parametri:
inResourceID: ID della risorsa per la quale l’utente richiede l’autorizzazione.redirect_url- Facoltativamente, fornire un URL di reindirizzamento, in modo che il processo di autorizzazione dell'MVPD restituisca l'utente a quella pagina invece che alla pagina da cui è stata avviata l'autorizzazione.
Callback attivati: setToken() al completamento, tokenRequestFailed in caso di errore
getAuthentication(redirect_url) getauthentication(redirect_url
Descrizione: Richiede l'autenticazione per il cliente corrente. Generalmente chiamato in risposta a un clic su un pulsante di accesso. Verifica la presenza di un token di autenticazione memorizzato nella cache per il cliente corrente. Se tale token non viene trovato, avvia il processo di autenticazione. Viene visualizzata la finestra di dialogo di selezione del provider predefinita o personalizzata, quindi viene utilizzato il provider selezionato per reindirizzare all'interfaccia di accesso di MVPD.
In caso di esito positivo, crea e memorizza un token di autenticazione per l’utente. Se l’autenticazione non riesce, il provider restituisce un messaggio di errore appropriato al tuo setAuthenticationStatus() callback.
Parametri:
- redirect_url: facoltativamente, fornisci un URL di reindirizzamento, in modo che il processo di autenticazione di MVPD restituisca l’utente a quella pagina invece che alla pagina da cui è stata avviata l’autenticazione.
Callback attivati: setAuthenticationStatus(), displayProviderDialog(), sendTrackingData()
checkAuthN checkauthn
Descrizione: Controlla lo stato di autenticazione corrente per il cliente corrente. Non associato ad alcuna interfaccia utente.
Callback attivati: setAuthenticationStatus()
checkAuthorization(inResourceID) checkauthorization(inresourceid)
Descrizione: Questo metodo viene utilizzato dall’applicazione per controllare lo stato di autorizzazione per il cliente corrente e la risorsa specificata. Viene innanzitutto verificato lo stato di autenticazione. Se non viene autenticato, il callback tokenRequestFailed() viene attivato e il metodo viene chiuso. Se l’utente è autenticato, attiva anche il flusso di autorizzazione. Vedi i dettagli su [getAuthorization()] (metodo #getAuthZ.
Parametri:
inResourceID: ID della risorsa per la quale l’utente richiede l’autorizzazione.
Callback attivati:
setToken(), tokenRequestFailed(), sendTrackingData(), setAuthenticationStatus()
checkPreauthorizedResources(resources) checkPreauthorizedResources(resources)
Descrizione: Richiede lo stato di autorizzazione "verifica preliminare" per un elenco di risorse.
Parametri:
- risorse: il parametro resources è un array di risorse per cui deve essere controllata l’autorizzazione. Ogni elemento dell’elenco deve essere una stringa che rappresenta l’ID della risorsa. L’ID risorsa è soggetto alle stesse limitazioni dell’ID risorsa in
getAuthorization()è un valore concordato tra il programmatore e l’MVPD, o un frammento RSS del contenuto multimediale.
checkPreauthorizedResources(resources-cache=true) checkPreauthorizedResources(resources-cache=true)
Questa variante API è disponibile a partire dalla versione 4.0 dell’SDK JS
Parametri:
-
risorse: il parametro resources è un array di risorse per cui deve essere controllata l’autorizzazione. Ogni elemento dell’elenco deve essere una stringa che rappresenta l’ID della risorsa. L’ID risorsa è soggetto alle stesse limitazioni dell’ID risorsa in
getAuthorization()è un valore concordato tra il programmatore e l’MVPD, o un frammento RSS del contenuto multimediale. -
cache: indica se utilizzare la cache interna durante la verifica della presenza di risorse preautorizzate. Questo è un parametro opzionale, impostazione predefinita true. Se true, il comportamento è identico a quello dell’API precedente, il che significa che le chiamate successive a questa funzione utilizzeranno una cache interna per risolvere le risorse preautorizzate. Passaggio false per questo parametro disabilita la cache interna, determinando una chiamata al server ogni volta che checkPreauthorizedResources Chiamata dell’API.
Callback attivati: preauthorizedResources()
getMetadata(Key) getMetadata
Descrizione: Recupera le informazioni esposte come metadati dalla libreria di Access Enabler.
Esistono due tipi di metadati:
- Statico (TTL del token di autenticazione, TTL del token di autorizzazione e ID dispositivo)
- Metadati utente (Questo include le informazioni specifiche dell’utente che vengono passate dal MVPD al dispositivo dell’utente durante i flussi di autenticazione e/o autorizzazione)
Ulteriori informazioni: Metadati utente
Parametri:
-
chiave: ID che specifica i metadati richiesti:
-
Se la chiave è
"TTL_AUTHN",viene quindi eseguita la query per ottenere la data di scadenza del token di autenticazione. -
Se la chiave è
"TTL_AUTHZ"e parametri è una matrice contenente l’id risorsa come stringa; la query viene quindi eseguita per ottenere la scadenza del token di autorizzazione associato alla risorsa specificata. -
Se la chiave è
"DEVICEID"quindi viene eseguita la query per ottenere l’id dispositivo corrente. Tieni presente che questa funzione è disabilitata per impostazione predefinita e i programmatori devono contattare l’Adobe per informazioni sull’abilitazione e sulle tariffe. -
Se key è incluso nel seguente elenco di tipi di metadati utente, un oggetto JSON contenente i metadati utente corrispondenti viene inviato a
setMetadataStatus()funzione di callback: -
"zip"- CAP -
"encryptedZip"- CAP crittografato -
"householdID"- Identificatore della famiglia. Nel caso in cui un MVPD non supporti account secondari, questo sarà identico a userID. -
"maxRating"- Classificazione genitoriale massima per l'utente -
"userID": identificatore utente. Nel caso in cui un MVPD supporti account secondari e l'utente non sia l'account principale, userID sarà diverso da familyID. -
"channelID"- L’elenco dei canali che l’utente può visualizzare -
"is_hoh"- Flag che identifica se un utente è a capo della famiglia -
"encryptedZip"- Codice postale crittografato -
"typeID"- Flag che identifica se l’account utente è primario/secondario -
"primaryOID"- Identificatore della famiglia -
"postalCode"- Simile al CAP -
"acctID"- ID account -
"acctParentID"- ID account principale
Nota: i metadati utente effettivi disponibili per un programmatore dipendono da cosa rende disponibile un MVPD. Consulta Metadati utente per l’elenco corrente dei metadati utente disponibili.
-
Ad esempio:
// Assume that a reference to the AccessEnabler has been previously
// obtained and stored in the "ae" variable
ae.setRequestor("SITE");
ae.checkAuthentication();
function setAuthenticationStatus(status, reason) {
if (status == 1) {
//user is authenticated, request metadata
ae.getMetadata("zip");
ae.getMetadata("maxRating");
} else {
...
}
}
Callback attivati: setMetadataStatus()
setSelectedProvider(providerid) setSelectedProvider
Descrizione: Chiama questa funzione quando l’utente ha selezionato un MVPD dall’interfaccia utente di selezione del provider per inviare la selezione del provider all’Access Enabler oppure chiama questa funzione con un parametro null nel caso in cui l’utente abbia rifiutato l’interfaccia utente di selezione del provider senza selezionare un provider.
Callback attivati: setAuthenticationStatus(), sendTrackingData()
getSelectedProvider() getSelectedProvider
Descrizione: Recupera i risultati della selezione del cliente nella finestra di dialogo di selezione del provider. Può essere utilizzato in qualsiasi momento dopo il controllo di autenticazione iniziale.
Questa funzione è asincrona e restituisce il suo risultato al tuo selectedProvider() callback.
- MVPD MVPD attualmente selezionato o null se non è stato selezionato alcun MVPD.
- AE_State Risultato dell'autenticazione per il cliente corrente: "Nuovo utente", "Utente non autenticato" o "Utente autenticato"
Callback attivati: selectedProvider()
logout logout
Descrizione: Consente di disconnettersi dal cliente corrente, cancellando tutte le informazioni di autenticazione e autorizzazione per tale utente. Elimina tutti i token authN e authZ dal sistema del cliente.
Callback attivati: setAuthenticationStatus()
Definizione callback calllback-definitions
Devi implementare questi callback per gestire le risposte alle chiamate di richiesta asincrone:
entitlementLoaded() entitlementLoaded
Descrizione: Attivazione quando Access Enabler completa l'inizializzazione ed è pronto a ricevere richieste. Implementa questo callback per sapere quando avviare la comunicazione con l’API di Access Enabler.
setConfig(configXML) setconfig(configXML)
Descrizione: Implementa questo callback per ricevere le informazioni di configurazione e l’elenco MVPD.
Parametri:
- configXML: oggetto xml contenente la configurazione per il REQUESTOR corrente incluso l’elenco MVPD.
Attivato da: setRequestor()
displayProviderDialog(providers) displayproviderdialog(providers)
Descrizione: Implementa questo callback per richiamare l’interfaccia utente personalizzata di selezione del provider. La finestra di dialogo deve utilizzare il nome visualizzato (e il logo opzionale) per fornire le scelte del cliente. Quando il cliente ha fatto una scelta e ha chiuso la finestra di dialogo, invia l’ID associato del provider scelto nella chiamata a setSelectedProvider().
Parametri:
- provider - Array di oggetti che rappresentano gli MVPD richiesti:
var mvpd = {
ID: "someprov",
displayName: "Some Provider",
logoURL: "http://www.someprov.com/images/logo.jpg"
}
Attivato da: getAuthentication(), getAuthorization()
createIFrame(inWidth, inHeight) createIFrame(inWidth,inHeight)
Descrizione: Implementa questo callback se l’utente ha selezionato un MVPD che richiede un iFrame in cui visualizzare la sua interfaccia utente della pagina di accesso per l’autenticazione.
Attivato da: setSelectedProvider()
setAuthenticationStatus(isAuthenticated, errorCode) set-authn-status-isauthn-error
Descrizione: Implementa questo callback per ricevere lo stato di autenticazione (1=autenticato o 0=non autenticato) e un messaggio di errore descrittivo in caso di errore durante il tentativo di determinare lo stato di autenticazione (stringa vuota al completamento del controllo).
Parametri:
- isAuthenticated - Fornisce lo stato di autenticazione: 1 (autenticato) o 0 (non autenticato).
- errorCode - Eventuali errori che si verificavano durante la determinazione dello stato di autenticazione. Stringa vuota se non presente.
Attivato da: checkAuthentication(), getAuthentication(), checkAuthorization()
sendTrackingData(trackingEventType, trackingData) sendTrackingData(trackingEventType,trackingData)
Descrizione: Implementa questo callback per ricevere i dati di tracciamento quando si verificano eventi specifici. Puoi utilizzarlo, ad esempio, per tenere traccia del numero di utenti che hanno effettuato l’accesso con le stesse credenziali. Il tracciamento non è attualmente configurabile. Con Adobe Pass Authentication 1.6, sendTrackingData() segnala inoltre informazioni sul dispositivo, sul client Access Enabler e sul tipo di sistema operativo. Il sendTrackingData() il callback rimane compatibile con le versioni precedenti.
-
Valori possibili per il tipo di dispositivo:
- computer
- tablet
- mobile
- gameconsole
- sconosciuto
-
Valori possibili per il tipo di client Access Enabler:
- html5
- ios
- androide
Passa il tipo di evento e una matrice di informazioni associate. I tipi di evento sono:
I dati sono specifici per ogni tipo di evento:
Attivato da: checkAuthentication(), getAuthentication(), checkAuthorization(), getAuthorization()
setToken(inRequestedResourceID, inToken) setToken(inRequestedResourceID,inToken)
Descrizione: Implementa questo callback per ricevere il token multimediale di breve durata (inToken) e l’ID della risorsa (inRequestedResourceID) per la quale è stata effettuata e completata una richiesta di autorizzazione o di autorizzazione all’assegno.
Attivato da: checkAuthorization(), getAuthorization()
tokenRequestFailed(inRequestedResourceID, inRequestErrorCode, inRequestDetailedErrorMessage) token-request-failed-error-msg
Descrizione: Implementa questo callback per essere segnalato quando una richiesta di autorizzazione o di controllo-autorizzazione non è riuscita. Facoltativamente può essere utilizzato da un MVPD per fornire un messaggio personalizzato che deve essere visualizzato dal programmatore.
Parametri:
- inRequestedResourceID - Stringa che fornisce l'ID risorsa utilizzato nella richiesta di autorizzazione.
- inRequestErrorCode - Stringa che visualizza il codice di errore di autenticazione di Adobe Pass, che indica il motivo dell’errore; i valori possibili sono "Errore utente non autenticato" e "Errore utente non autorizzato"; per ulteriori dettagli, vedi "Codici di errore di callback", di seguito.
- inRequestDetailedErrorMessage - Stringa descrittiva aggiuntiva adatta alla visualizzazione. Se questa stringa descrittiva non è disponibile per alcun motivo, Adobe Pass Authentication invia una stringa vuota (""). Può essere utilizzato da un MVPD per trasmettere messaggi di errore personalizzati o messaggi relativi alle vendite. Ad esempio, se a un abbonato viene negata l’autorizzazione per una risorsa, l’MVPD potrebbe rispondere con un
*inRequestDetailedErrorMessage*ad esempio: "Al momento non hai accesso a questo canale nel pacchetto. Se desideri aggiornare il pacchetto, fai clic su *qui*." Il messaggio viene passato dall’autenticazione di Adobe Pass tramite questo callback al sito del programmatore. Il programmatore ha quindi la possibilità di visualizzarlo o ignorarlo. L’autenticazione di Adobe Pass può anche utilizzare*inRequestDetailedErrorMessage*per notificare al programmatore la condizione che potrebbe aver generato un errore. Ad esempio: "Errore di rete durante la comunicazione con il servizio di autorizzazione del provider".
Attivato da: checkAuthorization(), getAuthorization()
preauthorizedResources(authorizedResources) preauthorizedResources(authorizedResources)
Descrizione: Callback attivato dall'Access Enabler che distribuisce l'elenco delle risorse autorizzate restituito dopo una chiamata a checkPreauthorizedResources().
Parametri:
- authorizedResources: elenco delle risorse autorizzate.
Attivato da: checkPreauthorizedResources()
setMetadataStatus(chiave, crittografato, dati) setMetadataStatus(key,encrypted,data)
Descrizione: Callback attivato dall'Access Enabler che distribuisce i metadati richiesti tramite un getMetadata() chiamare.
Ulteriori informazioni: Metadati utente
Parametri:
- key (String): chiave dei metadati per i quali è stata effettuata la richiesta.
- crittografato (booleano): flag che indica se il "valore" è crittografato o meno. Se questo è "true", "value" sarà in realtà una rappresentazione JSON Web Encrypted del valore effettivo.
- dati (oggetto JSON): oggetto JSON con la rappresentazione dei metadati.Per richieste semplici ('
TTL_AUTHN', 'TTL_AUTHZ', 'DEVICEID'), result è un valore String (che rappresenta il TTL di autenticazione, il TTL di autorizzazione o l'ID dispositivo). Nel caso di una richiesta di metadati utente, il risultato può essere un oggetto primitivo o JSON che rappresenta il payload di metadati. La struttura effettiva degli oggetti metadati utente JSON è simile alla seguente:
{
updated: 1334243471,
encrypted: ["encryptedProp"],
data: {
zip: ["12345", "34567"],
maxrating: {
"MPAA": "PG-13",
"VCHIP": "TV-Y",
"URL": "http://exam.pl/e/manage/ratings"
},
householdid: "3456",
uid: "BgSdasfsdk23/dsaf3+saASesadgfsShggssd=",
channelID: ["channel-1", "channel-2"]
}
Ad esempio:
// Implement the setMetadataStatus() callback
function setMetadataStatus(key, encrypted, data) {
if (encrypted) {
//the metadata value is encrypted
//needs to be decrypted by the programmer
data = decrypt(data);
}
alert(key + "=" + data);
}
Attivato da: getMetadata()
Torna all'inizio
selectedProvider(result) selectedProvider(result)
Descrizione: Implementa questo callback per ricevere l’MVPD attualmente selezionato e il risultato dell’autenticazione dell’utente corrente racchiuso in result parametro. Il result Il parametro è un oggetto con le seguenti proprietà:
- MVPD MVPD attualmente selezionato o null se non è stato selezionato alcun MVPD.
- AE_State Risultato dell'autenticazione per l'utente corrente, uno tra "Nuovo utente", "Utente non autenticato" o "Utente autenticato"
Attivato da: getSelectedProvider()