Transmet temporaire promouvant promotional-temp-pass
Résumé des fonctionnalités feature-summary
La transmission temporaire promotionnelle permet aux programmeurs d’offrir un accès temporaire à leur contenu protégé aux utilisateurs qui n’ont pas d’informations d’identification de compte avec un MVPD.
La vignette promotionnelle temporaire est conçue pour être utilisée pour exécuter des campagnes promotionnelles dans lesquelles un utilisateur, après avoir fourni des informations d’identification valides (par exemple, une adresse électronique) au programmeur, pourra consommer un nombre prédéfini de titres VOD différents pendant une période prédéfinie.
La transmission temporaire promotionnelle est construite sur la fonction Temp Pass, ce qui signifie qu’elle comprend toutes les fonctionnalités de transmission temporaire.
Une fois le nombre maximal de titres VOD prédéfinis ou la période prédéfinie dépassée, cet utilisateur ne pourra plus accéder au contenu sur le même appareil ou en utilisant les mêmes informations d’identification de l’utilisateur (par exemple, adresse électronique) tant que les jetons d’autorisation ne seront pas effacés du serveur d’authentification Adobe Pass.
Comparaison des transferts temporaires et des transferts temporaires de conversion tp-ptp-comparison
Accès au contenu
- en fonction du temps
Accès au contenu
- en fonction du temps
- en fonction du nombre de ressources
Sécurité d’accès basée sur
- identifiant de l’appareil
Sécurité basée sur
- identifiant de l’appareil
- hachage des informations d’identifiant utilisateur fournies (par exemple, l’e-mail) ;
Détails des fonctionnalités feature-details
Cette fonctionnalité permet aux utilisateurs d’accéder au contenu promotionnel à partir d’un appareil spécifique (téléphone et tablette) après avoir fourni des informations uniques, telles que l’adresse électronique, dans l’application du programmeur.
Le programmeur fournira un hachage sur les informations d’identification personnelles de l’utilisateur sur les API d’authentification et d’autorisation. Ce hachage sera utilisé avec l’identifiant de l’appareil pour générer une clé unique permettant d’identifier l’utilisateur et l’appareil.
En fonction de l’identifiant de l’appareil et des informations fournies par l’utilisateur, et en suivant la logique ci-dessous, l’authentification Adobe Pass détermine si l’utilisateur est dans un nouvel essai ou dans un autre :
- nouveau hachage sur les informations fournies par l’utilisateur (par exemple, e-mail), nouvel ID d’appareil => nouvelle version d’évaluation
- hachage existant sur les informations fournies par l’utilisateur (par exemple, e-mail), nouvel ID d’appareil => version d’évaluation existante (avec le hachage existant sur les informations fournies par l’utilisateur (par exemple, e-mail) ;
- nouveau hachage sur les informations fournies par l’utilisateur (par exemple, e-mail), ID d’appareil existant => version d’évaluation existante (avec ID d’appareil existant)
- hachage existant sur les informations fournies par l’utilisateur (par exemple, e-mail), ID d’appareil existant => version d’évaluation existante ;
La fonction de transfert temporaire promotionnel peut être configurée en fonction des propriétés suivantes :
- Clé d’informations fournie par l’utilisateur (par exemple, courrier électronique)
- Nombre de ressources que l’utilisateur est autorisé à consommer
- TTL : intervalle dans lequel l’utilisateur est autorisé à consommer le nombre configuré de ressources.
Métadonnées utilisateur user-metadata
Pour faciliter la mise en oeuvre de l’application du programmeur, les informations de métadonnées utilisateur suivantes sont exposées sur la vignette de promotion, avec les clés correspondantes (pour activer les clés, contactez tve-support@adobe.com) :
- restes_resources : nombre de ressources restantes que l’utilisateur actuel est autorisé à consommer
- used_assets : liste des ressources que l’utilisateur actuel a déjà consommées
- expiration_date : date d’expiration de l’utilisateur actuel
Comment le temps de visionnage est-il calculé ? compute-viewing-time
La durée de validité d’une transmission temporaire n’est pas corrélée au temps qu’un utilisateur passe à visionner le contenu sur l’application du programmeur. Lors de la demande d’autorisation initiale de l’utilisateur par le biais d’une transmission temporaire, un délai d’expiration est calculé en ajoutant l’heure de requête actuelle initiale au délai d’activation (durée) spécifié par le programmeur.
Authentification et autorisation authn-authz
Pour les flux de transmission temporaire promotionnelle, l’authentification et l’autorisation ne communiquent pas avec un MVPD réel, donc toutes les demandes d’autorisation réussiront tant que toutes ces conditions sont remplies :
- jetons d’autorisation valides pour les ressources spécifiées
- Le nombre de used_assets est inférieur à la limite définie par le programmeur
- La valeur expiration_date est postérieure à la date actuelle.
Comportement de contrôle en amont preflight-beh
Lorsqu’une demande de contrôle en amont ou de préautorisation est effectuée pour un MVPD de transmission temporaire promotionnelle, la réponse de contrôle en amont correspondante renvoyée contiendra la liste complète des ressources de la demande de contrôle en amont comme contrôle en amont réussi.
La logique sous-jacente à cela est la suivante : les conditions d’autorisation de transmission temporaire de conversion reposent sur la limite de temps et de nombre de ressources plutôt que sur des ressources spécifiques. Plus précisément, tant que la contrainte temporelle est respectée et tant que la limite de ressources n’est pas dépassée, les ressources appelées sont autorisées.
SSO sso
La connexion unique n’est pas activée pour les instances de la transmission temporaire promotionnelle, qui est configurée avec l’option "Authentification par demandeur" activée. Cela signifie que lorsque l’utilisateur passe de l’application A à une autre application B, toutes deux intégrées avec la même passe temporaire promotionnelle, l’utilisateur ne se connecte pas automatiquement.
Déconnexion logout
Tous les jetons d’un appareil sont supprimés lors de la déconnexion. Par conséquent, le passage de la transmission temporaire de conversion à un MVPD standard sélectionné par l’utilisateur ne doit pas dépendre de cette mise en oeuvre. Il est recommandé d’utiliser la fonction setSelectedProvider(null) afin d’effacer l’état de l’application, puis de redémarrer le flux d’authentification, qui offre une meilleure expérience utilisateur.
Diagramme de flux de transmission temporaire promu promo-tempass-flowdia
Figure : Flux de passage à température promotionnel
Mise en oeuvre de la transmission temporaire de conversion impl-promo-tempass
La transmission temporaire promotionnelle requiert les fonctionnalités côté client suivantes :
- Informations d’identifiant de l’utilisateur, par exemple propagation de l’adresse électronique (envoi de l’adresse électronique de l’utilisateur sur les flux d’authentification et d’autorisation). L’e-mail est requis par l’authentification Adobe Pass pour lier les jetons d’authentification et d’autorisation (similaire au cas de
device_ID, requis pour tous les appels). - Forcer l’authentification - permettant au programmeur de forcer un flux d’authentification lorsque l’utilisateur est déjà authentifié. Cette fonctionnalité est nécessaire pour forcer l’actualisation des métadonnées utilisateur (la clé de métadonnées utilisateur used_assets contient le nombre de ressources disponibles) à chaque démarrage de l’application. Comme l’utilisateur peut se connecter à plusieurs appareils, les métadonnées utilisateur présentes sur l’appareil au démarrage de l’application ne sont pas fiables. Nous devons les mettre à jour afin de refléter l’état actuel de cet utilisateur spécifique (identifié par son adresse électronique).
L’authentification Adobe Pass ne dispose pas d’un mécanisme intégré pour arrêter la diffusion en continu libre après les X minutes. L’authentification Adobe Pass cessera d’émettre des jetons authorization et short media une fois que l’utilisateur aura consommé les ressources Y gratuites. C’est aux programmeurs de restreindre l’accès une fois que la passe temporaire de promotion arrive à expiration.
Sécurité security
Hachage des informations d’identifiant de l’utilisateur
Adobe recommande d’utiliser la famille SHA-2 ou ses fonctions SHA-256, SHA-512 spécifiques sur les données avant leur envoi à Adobe.
Par exemple, SHA-256 sur "user@domain.com" est "f7ee5ec7312165148b69fcca1d29075b14b8aef0b5048a32b18b88d09069fb7"}.
Réinitialiser ou purger la transmission temporaire de conversion reset-promo-tempass
Certaines règles de fonctionnement nécessitent une purge régulière de la transmission temporaire promotionnelle. Pour ce faire, Adobe Pass Authentication fournit aux programmeurs une API web public, décrite ci-dessous :
DELETE https://mgmt.auth.adobe.com/reset-tempass/v2/reset-
Protocole : https
-
Hôte :
- Version : mgmt.auth.adobe.com
- Préqualification : mgmt-prequal.auth.adobe.com
-
Chemin d’accès : /reset-tempass/v2/reset
-
Paramètres de requête : device_id=all&requestor_id=THE_REQUESTOR_ID&mvpd_id=THE_TEMPASS_MVPD_ID{1)
-
headers : ApiKey : 1232293681726481
-
Réponse :
- Succès : HTTP 204
- Échec : HTTP 400 pour les demandes incorrectes, HTTP 401 si ApiKey n’est pas spécifié, HTTP 403 si ApiKey n’est pas valide
Outre les conditions requises pour purger la transmission temporaire, la transmission temporaire de conversion utilise le hachage sur les informations d’identifiant utilisateur envoyées sous la forme generic_data lors de l’authentification et de l’autorisation de purge.
Le hachage sera envoyé, et non l’intégralité du fichier JSON :
$ curl -X DELETE -H "Authorization:Bearer H4j7cF3GtJX81BrsgDa10GwSizVz" "https://mgmt.auth.adobe.com/reset-tempass/v2.1/reset/generic?key=f7ee5ec7312165148b69fcca1d29075b14b8aef0b5048a332b18b88d09069fb7&requestor_id=REF&mvpd_id=FlexibleTempPass"
Clients pris en charge supported-clients
Limites limitations
Cette section décrit les limites qui s’appliquent à la mise en oeuvre actuelle de la transmission temporaire de conversion.
Sans client lim-clientless
Appareils dynamiques sans identifiant d’appareil unique
Toutes les applications d’appareils intelligents ne sont pas en mesure de fournir un identifiant d’appareil unique. En l’absence d’un tel identifiant, l’authentification Adobe Pass peut utiliser l’UUID généré par le service de code d’enregistrement Adobe comme identifiant de périphérique unique. Cela signifie que lorsque l’utilisateur se déconnecte, les jetons d’authentification et d’autorisation sont supprimés. Une fois que l’utilisateur tente de s’authentifier à nouveau, cette fois-ci avec différentes informations utilisateur (par exemple, un e-mail), il pourra autoriser à nouveau. Adobe recommande d’ajouter un flux d’interface utilisateur qui ne permettra pas à un utilisateur de "tromper" le système et d’ajouter une logique pour déterminer s’il s’agit d’un nouvel utilisateur demandant un essai ou d’un essai existant.
Réinitialisation/purge de Temp Pass
Réinitialiser le transfert de température pour les sans client n’est pas disponible dans les cas spécifiques d’Xbox360 et d’Xbox One, car ces plateformes nécessitent une analyse supplémentaire de l’identifiant de périphérique, ce qui n’est pas possible dans l’outil Réinitialiser le transfert de température .