Référence de l’API client native Amazon FireOS amazon-fireos-native-client-api-reference
Introduction intro
Ce document présente les méthodes et les rappels exposés par le SDK Amazon FireOS pour l’authentification Adobe Pass, pris en charge avec l’authentification Adobe Pass. Les méthodes et fonctions de rappel décrites ici sont définies dans les fichiers d’en-tête AccessEnabler.h et EntitlementDelegate.h .
Reportez-vous à https://tve.zendesk.com/hc/en-us/articles/115005561623-fire-TV-Native-AccessEnabler-Library pour connaître le dernier SDK Amazon FireOS AccessEnabler.
- Les API publiques sont disponibles et entièrement testées sur tous les types de clients pris en charge. Pour toute fonction publique, nous nous assurons que chaque type de client possède une version correspondante de la ou des méthodes associées.
- Les API publiques doivent être aussi stables que possible, pour prendre en charge la compatibilité descendante et garantir que les intégrations de partenaires ne se rompent pas. Cependant, pour les API non publiques, nous nous réservons le droit de modifier leur signature à tout moment. Si vous rencontrez un flux particulier qui ne peut pas être pris en charge par une combinaison des appels publics actuels de l’API d’authentification Adobe Pass, la meilleure approche consiste à nous le faire savoir. En tenant compte de vos besoins, nous pouvons modifier les API publiques et fournir une solution stable à l’avenir.
API SDK Amazon FireOS api
- getInstance
- setOptions
- setRequestor
- setRequestorComplete
- checkAuthentication
- getAuthentication
- displayProviderDialog
- setSelectedProvider
- navigateToUrl
- getAuthenticationToken
- setAuthenticationStatus
- checkPreauthorizedResources
- preauthorizedResources
- checkAuthorization
- getAuthorization
- setToken
- tokenRequestFailed
- déconnexion
- getSelectedProvider
- selectedProvider
- getMetadata
- setMetadataStatus
- getVersion
Factory.getInstance getInstance
Description : instancie l’objet Access Enabler. Il doit y avoir une instance Access Enabler unique par instance d’application.
public static AccessEnabler getInstance(Context appContext, String softwareStatement, String redirectUrl)<br> throws AccessEnablerException
public static AccessEnabler getInstance(Context appContext, String env_url, String softwareStatement, String redirectUrl) throws AccessEnablerException
Disponibilité : v3.0+
Paramètres :
- appContext : contexte de l’application Amazon Fire OS.
- softwareStatement
- redirectUrl : dans le cas de FireOS, la valeur du paramètre sera ignorée et définie sur default : adobepass://android.app
- env_url : pour le test à l’aide de l’environnement d’évaluation Adobe, env_url peut être défini sur "sp.auth-staging.adobe.com"
Obsolète :
public static AccessEnabler getInstance(Context appContext)
throws AccessEnablerException
setRequestor setRequestor
Description : Établit l’identité du programmeur. Un identifiant unique est attribué à chaque programmeur lors de l’enregistrement auprès de l’Adobe pour le système d’authentification Adobe Pass. Ce paramètre ne doit être exécuté qu’une seule fois pendant le cycle de vie de l’application.
La réponse du serveur contient une liste de MVPD ainsi que certaines informations de configuration qui sont jointes à l’identité du programmeur. La réponse du serveur est utilisée en interne par le code Access Enabler. Seul l’état de l’opération (c.-à-d. SUCCESS/FAIL) est présenté à votre application via le rappel setRequestorComplete() .
Si le paramètre urls n’est pas utilisé, l’appel réseau obtenu cible l’URL du fournisseur de services par défaut : l’environnement de production/version d’Adobe.
Si une valeur est fournie pour le paramètre urls , l’appel réseau obtenu cible toutes les URL fournies dans le paramètre urls . Toutes les requêtes de configuration sont déclenchées simultanément dans des threads distincts. Le premier participant a la priorité lors de la compilation de la liste des MVPD. Pour chaque MVPD de la liste, Access Enabler mémorise l'URL du prestataire associé. Toutes les demandes de droits suivantes sont dirigées vers l’URL associée au fournisseur de services qui a été associé au MVPD cible pendant la phase de configuration.
public void setRequestor(String requestorId)
Disponibilité : v3.0+
public void setRequestor(String requestorId, ArrayList<String> urls)
Disponibilité : v3.0+
Paramètres :
- requestorID : identifiant unique associé au programmeur. Transmettez l’identifiant unique attribué par Adobe à votre site lorsque vous vous êtes enregistré pour la première fois auprès du service d’authentification Adobe Pass.
- urls : paramètre facultatif ; par défaut, le fournisseur de services Adobe est utilisé (http://sp.auth.adobe.com/). Ce tableau vous permet de spécifier des points de terminaison pour les services d’authentification et d’autorisation fournis par Adobe (différentes instances peuvent être utilisées à des fins de débogage). Vous pouvez l’utiliser pour spécifier plusieurs instances du fournisseur de services d’authentification Adobe Pass. Dans ce cas, la liste MVPD est composée des points de terminaison de tous les fournisseurs de services. Chaque MVPD est associé au fournisseur de services le plus rapide, c’est-à-dire le fournisseur qui a répondu en premier et qui prend en charge ce MVPD.
Rappels déclenchés : setRequestorComplete()
Obsolète :
public void setRequestor(String requestorId, String signedRequestorId)
public void setRequestor(String requestorId, String signedRequestorId, ArrayList<String> urls)
setRequestorComplete setRequestorComplete
Description : Rappel déclenché par l’activateur d’accès qui informe votre application que la phase de configuration est terminée. Il s’agit d’un signal indiquant que l’application peut commencer à émettre des demandes de droits. Aucune demande de droit ne peut être émise par l’application tant que la phase de configuration n’est pas terminée.
public void setRequestorComplete(int status)
Disponibilité : v1.0+
Paramètres :
-
status : peut prendre l’une des valeurs suivantes :
AccessEnabler.ACCESS_ENABLER_STATUS_SUCCESS
- configuration
phase terminéeAccessEnabler.ACCESS_ENABLER_STATUS_ERROR
- configuration
la phase a échoué
Déclenché par : setRequestor()
setOptions fire_setOption
Description : configure les options du SDK global. Il accepte un argument Map<String, String> en tant qu’argument. Les valeurs de la carte seront transmises au serveur avec chaque appel réseau effectué par le SDK.
Les valeurs seront transmises au serveur indépendamment du flux actuel (authentification/autorisation). Si vous souhaitez modifier les valeurs, vous pouvez appeler cette méthode à tout moment.
public void setOptions(HashMap<String,String> options)
Disponibilité : v3.0+
Paramètres :
-
options : Carte<Chaîne, Chaîne> contenant des options de SDK global. Actuellement, les options suivantes sont disponibles :
- applicationProfile - Il peut être utilisé pour créer des configurations de serveur en fonction de cette valeur.
- ap_vi - Service d’ID Experience Cloud. Cette valeur peut être utilisée ultérieurement pour les rapports d’analyse avancés.
- device_info - Informations sur l’appareil comme décrit dans Transfert du livre de cuisine d’informations sur l’appareil
checkAuthentication checkAuthN
Description : Vérifie l’état d’authentification. Pour ce faire, il recherche un jeton d’authentification valide dans l’espace de stockage du jeton local. L’appel de cette méthode n’effectue aucun appel réseau. Il est utilisé par l’application pour interroger l’état d’authentification de l’utilisateur et mettre à jour l’interface utilisateur en conséquence (c’est-à-dire mettre à jour l’interface utilisateur de connexion/déconnexion). L’état d’authentification est communiqué à l’application via le rappel setAuthenticationStatus() .
Si un MVPD prend en charge la fonction "Authentification par demandeur", plusieurs jetons d’authentification peuvent être stockés sur un appareil.
public void checkAuthentication()
Disponibilité : v1.0+
Paramètres : Aucun
Rappels déclenchés : setAuthenticationStatus()
getAuthentication getAuthN
Description : Démarre le processus d’authentification complet. Il commence par vérifier l’état d’authentification. Si elle n’est pas déjà authentifiée, la machine à états du flux d’authentification est démarrée :
- Si la dernière tentative d’authentification a réussi, la phase de sélection du MVPD est ignorée et un contrôle WebView présente à l’utilisateur la page de connexion du MVPD.
- Si la dernière tentative d’authentification a échoué ou si l’utilisateur s’est explicitement déconnecté, le rappel displayProviderDialog() est déclenché. Votre application utilise ce rappel pour afficher l’interface utilisateur de sélection MVPD. Votre application doit également reprendre le flux d’authentification en informant la bibliothèque Access Enabler de la sélection du MVPD de l’utilisateur via la méthode setSelectedProvider() .
Si un MVPD prend en charge la fonction "Authentification par demandeur", plusieurs jetons d’authentification peuvent être stockés sur un appareil (un par programmeur).
Enfin, l’état d’authentification est communiqué à l’application via le rappel setAuthenticationStatus() .
public void getAuthentication()
Disponibilité : v1.0+
public void getAuthentication(boolean forceAuthN, Map<String, Object> genericData)
Disponibilité : v1.0+
Paramètres :
- forceAuthn : indicateur spécifiant si le flux d’authentification doit être démarré, que l’utilisateur soit déjà authentifié ou non.
- data : carte composée de paires clé-valeur à envoyer au service de passe de télévision payante. Adobe peut utiliser ces données pour activer les fonctionnalités futures sans modifier le SDK.
Rappels déclenchés : setAuthenticationStatus(), displayProviderDialog(), sendTrackingData()
displayProviderDialog displayProviderDialog
Description Rappel déclenché par l’activateur d’accès pour informer l’application que les éléments d’IU appropriés doivent être instanciés pour permettre à l’utilisateur de sélectionner le MVPD de votre choix. Le rappel fournit une liste d’objets MVPD avec des informations supplémentaires qui peuvent aider à créer correctement le panneau d’interface utilisateur de sélection (telles que l’URL pointant vers le logo du MVPD, le nom d’affichage convivial, etc.).
Une fois que l’utilisateur a sélectionné le MVPD souhaité, l’application de couche supérieure est requise pour reprendre le flux d’authentification en appelant setSelectedProvider() et en lui transmettant l’identifiant du MVPD correspondant à la sélection de l’utilisateur.
public void displayProviderDialog(ArrayList<Mvpd> mvpds)
Disponibilité : v1.0+
Paramètres :
- mvpds : liste des objets MVPD contenant des informations relatives au MVPD que l’application peut utiliser pour créer les éléments d’IU de sélection du MVPD.
Déclenché par : getAuthentication(), getAuthorization()
setSelectedProvider setSelectedProvider
Description : Cette méthode est appelée par votre application pour informer l’Access Enabler de la sélection MVPD de l’utilisateur. Lors de la transmission de null en tant que paramètre, l’activateur d’accès réinitialise le MVPD actuel sur une valeur nulle.
public void setSelectedProvider(String mvpdId)
Disponibilité : v 1.0+
Paramètres : Aucun
Rappels déclenchés : setAuthenticationStatus(), sendTrackingData()
navigateToUrl navigagteToUrl
Description : Rappel déclenché par l’activateur d’accès sur le SDK Android. Elle doit être ignorée sur le SDK Amazon FireOS.
public void navigateToUrl(String url)
Disponibilité : v1.0+
Paramètres :
- url : URL pointant vers la page de connexion du MVPD
Déclenché par : getAuthentication(), setSelectedProvider()
getAuthenticationToken getAuthNToken
Description : exécute le flux d’authentification en demandant le jeton d’authentification auprès du serveur principal.
public void getAuthenticationToken(String cookies)
Disponibilité : v1.0+
Paramètres :
- cookies : cookies définis sur le domaine cible (voir l’application de démonstration dans le SDK pour une implémentation de référence).
Rappels déclenchés : setAuthenticationStatus(), sendTrackingData()
setAuthenticationStatus setAuthNStatus
Description : Rappel déclenché par l’activateur d’accès qui informe l’application de l’état de l’authentification. Il existe de nombreux endroits où le flux d’authentification peut échouer, soit en raison de l’interaction de l’utilisateur, soit en raison d’autres scénarios imprévus (c’est-à-dire des problèmes de connectivité réseau, etc.). Ce rappel informe l’application de l’état de réussite/échec de l’authentification, tout en fournissant des informations supplémentaires sur la raison de l’échec, le cas échéant.
Ce rappel signale également la fin du flux de déconnexion.
public void setAuthenticationStatus(int status, String errorCode)
Disponibilité : v1.0+
Paramètres :
-
status : peut prendre l’une des valeurs suivantes :
AccessEnabler.ACCESS_ENABLER_STATUS_SUCCESS
- le flux d’authentification a été terminé avec succèsAccessEnabler.ACCESS_ENABLER_STATUS_ERROR
- Échec du flux d’authentificationAccessEnabler.ACCESS_ENABLER_STATUS_LOGOUT
- déconnexion
-
code : raison de l’état présenté. Si status est
AccessEnabler.ACCESS_ENABLER_STATUS_SUCCESS
, alors code est une chaîne vide (c’est-à-dire définie par la constanteAccessEnabler.USER_AUTHENTICATED
). S’il n’est pas authentifié, ce paramètre peut prendre l’une des valeurs suivantes :AccessEnabler.USER_NOT_AUTHENTICATED_ERROR
- L’utilisateur n’est pas authentifié. En réponse à l’appel de la méthode checkAuthentication() lorsqu’il n’existe pas de jeton d’authentification valide dans le cache de jeton local.AccessEnabler.PROVIDER_NOT_SELECTED_ERROR
- AccessEnabler a réinitialisé l’ordinateur-état d’authentification après que l’application de couche supérieure a passé null àsetSelectedProvider()
pour interrompre le flux d’authentification. L’utilisateur a probablement annulé le flux d’authentification (c’est-à-dire qu’il a appuyé sur le bouton "Retour").AccessEnabler.GENERIC_AUTHENTICATION_ERROR
- Le flux d’authentification a échoué pour des raisons telles que l’indisponibilité du réseau ou l’utilisateur a explicitement annulé le flux d’authentification.AccessEnabler.LOGOUT
- L’utilisateur n’est pas authentifié en raison d’une action de déconnexion.
Déclenché par : checkAuthentication(), getAuthentication(), checkAuthorization()
checkPreauthorizedResources checkPreauth
Description : Cette méthode est utilisée par l’application pour déterminer si l’utilisateur est déjà autorisé à afficher des ressources protégées spécifiques. L’objectif principal de cette méthode est de récupérer des informations à utiliser dans la décoration de l’interface utilisateur (par exemple, en indiquant l’état d’accès avec les icônes de verrouillage et de déverrouillage).
public void checkPreauthorizedResources(ArrayList<String> resources)
Disponibilité : v1.0+
<Parameters: Le paramètre resources
est un tableau de ressources pour lequel l’autorisation doit être vérifiée. Chaque élément de la liste doit être une chaîne représentant l’ID de ressource. L’ID de ressource est soumis aux mêmes limites que l’ID de ressource dans l’appel getAuthorization()
, c’est-à-dire qu’il doit s’agir d’une valeur convenue établie entre le programmeur et le MVPD ou un fragment RSS multimédia.
Rappel déclenché : preauthorizedResources()
preauthorizedResources preauthResources
Description : Rappel déclenché par checkPreauthorizedResources(). Fournit une liste des ressources que l’utilisateur est déjà autorisé à afficher.
public void checkPreauthorizedResources(ArrayList<String> resources)
Disponibilité : v 1.0+
Paramètres : Le paramètre resources
est un tableau de ressources pour lequel l’utilisateur est déjà autorisé à afficher.
Déclenché par : checkPreauthorizedResources()
checkAuthorization checkAuthZ
Description : Cette méthode est utilisée par l’application pour vérifier l’état de l’autorisation. Il commence par vérifier l’état d’authentification. Si elle n’est pas authentifiée, le rappel setTokenRequestFailed() est déclenché et la méthode quitte. Si l’utilisateur est authentifié, il déclenche également le flux d’autorisation. Voir les détails sur la méthode getAuthorization() .
public void checkAuthorization(String resourceId)
Disponibilité : v1.0+
public void checkAuthorization(String resourceId, Map<String, Object> genericData)
Disponibilité : v1.0+
Paramètres :
- resourceId : identifiant de la ressource pour laquelle l’utilisateur demande l’autorisation.
- data : carte composée de paires clé-valeur à envoyer au service de passe de télévision payante. Adobe peut utiliser ces données pour activer les fonctionnalités futures sans modifier le SDK.
Rappels déclenchés : tokenRequestFailed(), setToken(), sendTrackingData(), setAuthenticationStatus()
getAuthorization getAuthZ
Description : Cette méthode est utilisée par l’application pour lancer le flux d’autorisation. Si l’utilisateur n’est pas déjà authentifié, il lance également le flux d’authentification. Si l’utilisateur est authentifié, Access Enabler émet des requêtes pour le jeton d’autorisation (si aucun jeton d’autorisation valide n’est présent dans le cache de jeton local) et pour le jeton multimédia de courte durée. Une fois le jeton multimédia court obtenu, le flux d’autorisation est considéré comme terminé. Le rappel setToken() est déclenché et le jeton multimédia court est diffusé en tant que paramètre à l’application. Si, pour une raison quelconque, l’autorisation échoue, le rappel tokenRequestFailed() est déclenché et le code d’erreur et les détails sont fournis.
public void getAuthorization(String resourceId)
Disponibilité : v1.0+
public void getAuthorization(String resourceId, Map<String, Object> genericData)
Disponibilité : v1.0+
Paramètres :
- resourceId : identifiant de la ressource pour laquelle l’utilisateur demande l’autorisation.
- data : carte composée de paires clé-valeur à envoyer au service de passe de télévision payante. Adobe peut utiliser ces données pour activer les fonctionnalités futures sans modifier le SDK.
Rappels déclenchés : tokenRequestFailed(), setToken(), sendTrackingData()
![](http://learn.adobe.com/wiki/images/icons/emoticons/warning.gif)
Cette méthode peut également déclencher les rappels suivants (si le flux d’authentification est également lancé) : setAuthenticationStatus(), displayProviderDialog()
REMARQUE : Dans la mesure du possible, utilisez checkAuthorization() au lieu de getAuthorization(). La méthode getAuthorization() démarre un flux d’authentification complet (si l’utilisateur n’est pas authentifié), ce qui peut entraîner une mise en oeuvre compliquée du côté du programmeur.
setToken setToken
Description : Rappel déclenché par l’activateur d’accès qui informe votre application que le flux d’autorisation a été terminé avec succès. Le jeton multimédia de courte durée est également fourni en tant que paramètre.
public void setToken(String token, String resourceId)
Disponibilité : v 1.0+
Paramètres :
- token : jeton multimédia de courte durée
- resourceId : ressource pour laquelle l’autorisation a été obtenue
Déclenché par : checkAuthorization(), getAuthorization()
tokenRequestFailed tokenRequestFailed
Description : Rappel déclenché par l’activateur d’accès qui informe l’application de couche supérieure que le flux d’autorisation a échoué.
public void tokenRequestFailed(String resourceId, <br> String errorCode, String errorDescription)
Disponibilité : v1.0+
Paramètres :
- resourceId : ressource pour laquelle l’autorisation a été obtenue
- errorCode : code d’erreur associé au scénario d’échec. Valeurs possibles :
AccessEnabler.USER_NOT_AUTHORIZED_ERROR
- L’utilisateur n’a pas pu autoriser pour la ressource donnée
- errorDescription : détails supplémentaires sur le scénario d’échec. Si cette chaîne descriptive n’est disponible pour aucune raison, l’authentification Adobe Pass envoie une chaîne vide >(""). Cette chaîne peut être utilisée par un MVPD pour transmettre des messages d’erreur personnalisés ou des messages liés aux ventes. Par exemple, si l’autorisation d’une ressource est refusée à un abonné, le MVPD peut envoyer un message tel que : "Vous n’avez actuellement pas accès à ce canal dans votre package. Si vous souhaitez mettre à niveau votre package, cliquez ici." Le message est transmis par l’authentification Adobe Pass via ce rappel au programmeur, qui a la possibilité de l’afficher ou de l’ignorer. L’authentification Adobe Pass peut également utiliser ce paramètre pour fournir une notification de la condition qui a pu entraîner une erreur. Par exemple, "Une erreur de réseau s’est produite lors de la communication avec le service d’autorisation du fournisseur".
Déclenché par : checkAuthorization(), getAuthorization()
déconnexion logout
Description : Utilisez cette méthode pour lancer le flux de déconnexion. La déconnexion est le résultat d’une série d’opérations de redirection HTTP en raison du fait que l’utilisateur doit être déconnecté des serveurs d’authentification Adobe Pass et des serveurs du MVPD.
public void logout()
Disponibilité : v1.0+
Paramètres : Aucun
Rappels déclenchés : Aucun
getSelectedProvider getSelectedProvider
Description : Utilisez cette méthode pour déterminer le fournisseur actuellement sélectionné.
public void getSelectedProvider()
Disponibilité : v1.0+
Paramètres : Aucun
Rappels déclenchés : selectedProvider()
selectedProvider selectedProvider
Description : Rappel déclenché par l’activateur d’accès qui fournit des informations sur le MVPD actuellement sélectionné à l’application.
public void selectedProvider(Mvpd mvpd)
Disponibilité : v1.0+
Paramètres :
- mvpd : objet contenant des informations sur le MVPD actuellement sélectionné
Déclenché par : getSelectedProvider()
getMetadata getMetadata
Description : Utilisez cette méthode pour récupérer des informations exposées en tant que métadonnées par la bibliothèque Access Enabler. L’application peut accéder à ces informations en fournissant un objet composite MetadataKey.
public void getMetadata(MetadataKey metadataKey)
Disponibilité : v1.0+
Deux types de métadonnées sont disponibles pour les programmeurs :
- Métadonnées statiques (jeton d’authentification TTL, jeton d’autorisation TTL et ID de périphérique)
- Métadonnées utilisateur (informations spécifiques à l’utilisateur, telles que l’ID utilisateur et le code postal ; transmises d’un MVPD à l’appareil d’un utilisateur lors des flux d’authentification et/ou d’autorisation)
Paramètres :
-
metadataKey : structure de données qui encapsule une variable key et args, avec la signification suivante :
-
Si la clé est
METADATA_KEY_TTL_AUTHN
, la requête est effectuée pour obtenir le délai d’expiration du jeton d’authentification. -
Si la clé est
METADATA_KEY_TTL_AUTHZ
et que args contient un objet SerializableNameValuePair avec le nom =METADATA_ARG_RESOURCE_ID
et la valeur =[resource_id]
, la requête est effectuée pour obtenir le délai d’expiration du jeton d’autorisation associé à la ressource spécifiée. -
Si la clé est
METADATA_KEY_DEVICE_ID
, la requête est effectuée pour obtenir l’identifiant de l’appareil actuel. Notez que cette fonctionnalité est désactivée par défaut et que les programmeurs doivent contacter Adobe pour plus d’informations sur l’activation et les frais. -
Si key est
METADATA_KEY_USER_META
et args contient un objet SerializableNameValuePair dont le nom est =METADATA_KEY_USER_META
et la valeur =[metadata_name]
, la requête est alors effectuée pour les métadonnées utilisateur. La liste actuelle des types de métadonnées utilisateur disponibles :zip
- Code postalhouseholdID
- Identifiant du foyer. Si un MVPD ne prend pas en charge les sous-comptes, cela sera identique àuserID
.maxRating
- Note parentale maximale pour l’utilisateuruserID
- Identifiant de l’utilisateur. Si un MVPD prend en charge des sous-comptes et que l’utilisateur n’est pas le compte principal,channelID
- Liste des canaux que l’utilisateur est autorisé à afficher
-
Les métadonnées utilisateur réelles disponibles pour un programmeur dépendent de ce qu’un MVPD rend disponible. Cette liste sera complétée à mesure que de nouvelles métadonnées seront disponibles et ajoutées au système d’authentification Adobe Pass.
Rappels déclenchés : setMetadataStatus()
Plus d’informations : Métadonnées utilisateur
setMetadataStatus setMetadaStatus
Description : Rappel déclenché par l’activateur d’accès qui diffuse les métadonnées demandées par le biais d’un appel getMetadata() .
public void setMetadataStatus(MetadataKey key, MetadataStatus result)
Disponibilité : v1.0+
Paramètres :
-
key : objet MetadataKey contenant la clé pour laquelle la valeur de métadonnées est demandée et les paramètres associés (voir application de démonstration pour une mise en oeuvre de référence).
-
result : objet composite contenant les métadonnées demandées. L’objet comporte les champs suivants :
-
simpleResult : chaîne représentant la valeur de métadonnées lorsque la demande a été faite pour Authentication TTL, Authorization TTL ou Device ID. Cette valeur est nulle si la requête a été effectuée pour les métadonnées utilisateur.
-
userMetadataResult : objet contenant la représentation Java d’une charge utile de métadonnées utilisateur JSON. Par exemple :
code language-json { "street": "Main Avenue", "buildings": ["150", "320"] }
est traduit en Java en tant que :
code language-java Map("street" -> "Main Avenue", "buildings" -> List("150", "320")))
La structure réelle des objets de métadonnées utilisateur est similaire à ce qui suit :
code language-json { updated: 1334243471, encrypted: ["encryptedProp"], data: { zip: ["12345", "34567"], maxRating: { "MPAA": "PG-13", "VCHIP": "TV-Y", "URL": "http://exam.pl/e/manage/ratings" }, householdID: "3456", userID: "BgSdasfsdk23/dsaf3+saASesadgfsShggssd=", channelID: ["channel-1", "channel-2"] } }
-
Cette valeur est nulle lorsque la demande a été effectuée pour des métadonnées simples (Authentification TTL, Autorisation TTL ou ID d’appareil).
- encrypted : valeur booléenne qui spécifie si les métadonnées récupérées sont chiffrées ou non. Ce paramètre n’est significatif que pour les requêtes de métadonnées utilisateur. Il n’a aucune signification pour les métadonnées statiques (par exemple, Authentification TTL) qui sont toujours reçues sans chiffrement. Si ce paramètre est défini sur True, c’est au programmeur d’obtenir la valeur des métadonnées utilisateur non chiffrées en effectuant un décryptage RSA à l’aide de la clé privée de mise en whiteliste (la même clé privée utilisée pour la signature de l’ID du demandeur dans l’appel
setRequestor
).
Déclenché par : getMetadata()
Plus d’informations : Métadonnées utilisateur
getVersion getVersion
Description : Utilisez cette méthode pour récupérer la version actuelle d’AccessEnabler.
public static String getVersion()
Suivi des événements tracking
L’activation d’accès déclenche un rappel supplémentaire qui n’est pas nécessairement lié aux flux de droits. La mise en oeuvre de la fonction de rappel de suivi des événements nommée sendTrackingData() est facultative, mais elle permet à l’application de suivre des événements spécifiques et de compiler des statistiques telles que le nombre de tentatives d’authentification/d’autorisation réussies/échouées. Voici la spécification du rappel sendTrackingData() :
sendTrackingData sendTrackingData
Description : Rappel déclenché par l’activateur d’accès signalant à l’application l’occurrence de divers événements tels que l’achèvement/l’échec des flux d’authentification/d’autorisation. Le type d’appareil, le type de client Access Enabler et le système d’exploitation sont également signalés par sendTrackingData().
-
Valeurs possibles pour le type d’appareil :
computer
tablet
mobile
gameconsole
unknown
-
Valeurs possibles pour le type de client Access Enabler :
flash
html5
ios
tvos
android
firetv
public void sendTrackingData(Event event, ArrayList<String> data)
Disponibilité : v1.0+
Paramètres :
-
event : l’événement suivi. Il existe trois types d’événements de suivi possibles :
- authorizationDetection : chaque fois qu’une requête de jeton d’autorisation est renvoyée (le type d’événement est
EVENT_AUTHZ_DETECTION
) - authenticationDetection : chaque fois qu’une vérification de l’authentification se produit (le type d’événement est
EVENT_AUTHN_DETECTION
) - mvpdSelection: lorsque l’utilisateur sélectionne un MVPD dans le formulaire de sélection MVPD (le type d’événement est
EVENT_MVPD_SELECTION
)
- authorizationDetection : chaque fois qu’une requête de jeton d’autorisation est renvoyée (le type d’événement est
-
data : données supplémentaires associées à l’événement signalé. Ces données sont présentées sous la forme d'une liste de valeurs.
Vous trouverez ci-dessous des instructions pour interpréter les valeurs du tableau data :
-
Pour le type d’événement
EVENT_AUTHN_DETECTION
:- 0 - Indique si la requête de jeton a réussi (true/false) et si la valeur ci-dessus est vraie :
- 1 - Chaîne d’identifiant MVPD
- 2 - GUID (hachage md5)
- 3 - Jeton déjà en cache (true/false)
- 4 - Type de périphérique
- 5 - Type de client Access Enabler
- 6 - Type de système d’exploitation
-
Pour le type d’événement
EVENT_AUTHZ_DETECTION
- 0 - Indique si la requête de jeton a réussi (true/false) et si elle a réussi :
- 1 - ID MVPD
- 2 - GUID (hachage md5)
- 3 - Jeton déjà en cache (true/false)
- 4 - Erreur
- 5 - Détails
- 6 - Type de périphérique
- 7 - Type de client Access Enabler
- 8 - Type de système d’exploitation
-
Pour le type d’événement
EVENT_MVPD_SELECTION
- 0 - ID du MVPD actuellement sélectionné
- 1 - Type de périphérique
- 2 - Type de client Access Enabler
- 3 - Type de système d’exploitation
Déclenché par : checkAuthentication(), getAuthentication(), checkAuthorization(), getAuthorization(), setSelectedProvider()