Guide d’intégration du programmeur programmer-integration-guide
Ce guide d’intégration est destiné aux fournisseurs de contenu (programmeurs) qui prévoient de s’intégrer à l’authentification Adobe® Pass.
Dans le paysage numérique d’aujourd’hui, les internautes peuvent accéder à Internet n’importe où et à tout moment, et demander l’accès à votre contenu protégé. Il peut s'agir d'un événement ponctuel ou d'une demande de droits de diffusion d'une série télévisée complète que vous diffusez.
Avant d’accorder l’accès à un contenu protégé, vous devez déterminer si la visionneuse y a droit. Les questions clés sont les suivantes :
- La visionneuse dispose-t-elle d’un abonnement actif à un distributeur de programmation vidéo multicanal (MVPD) ?
- Cet abonnement inclut-il votre programmation ?
Authentification Adobe Pass pour TV Everywhere adobe-pass-authentication-for-tv-everywhere
Pour les programmeurs, déterminer les droits n’est pas toujours simple. Les MVPD sont les dépositaires des données d’identification et des privilèges d’accès de leurs clients. Pour compliquer encore les choses, les téléspectateurs de Programmers peuvent s'abonner à une grande variété de MVPD, chacun fonctionnant avec des systèmes uniques. Ces complexités rendent la vérification des droits à la fois techniquement difficile et gourmande en ressources.
Droit De L’Utilisateur Déterminé Directement Par Le Programmeur
L’authentification Adobe Pass facilite en toute sécurité les transactions de droits entre les programmeurs et les MVPD, ce qui rend rapide, facile et sécurisé la fourniture de contenu protégé aux visiteurs et visiteuses éligibles.
Droits d’utilisateur arbitrés par l’authentification Adobe Pass
L’authentification Adobe Pass agit comme un proxy et facilite le flux de droits entre les programmeurs et les MVPD en offrant des interfaces sécurisées et cohérentes aux deux parties.
Pour les programmeurs, l’authentification Adobe Pass fournit des API dans le cadre d’un niveau Standard ou Premium :
-
API d’authentification Adobe Pass standard :
-
API d’authentification Premium Adobe Pass :
Cas d’utilisation use-cases
Cette section décrit plus en détail les cas d’utilisation de l’intégration du programmeur pris en charge par l’authentification Adobe Pass :
-
Application programmeur (TVE) avec un réseau à canal unique
Cela permet au programmeur de fournir aux téléspectateurs l'accès au contenu à partir d'un réseau de chaînes monomarques au sein d'une application TVE.
-
Application programmeuse (TVE) avec réseaux à canaux multiples
Cela permet au programmeur de fournir aux téléspectateurs un accès au contenu à partir de plusieurs réseaux de canaux dans une seule application TVE.
-
Application Programmeur (TVE) pour événements spéciaux
Cela permet au programmeur de fournir aux observateurs l’accès au contenu d’événements spéciaux qui peuvent ne pas être des ressources qui se trouvent dans la base de données de droits de MVPD comme les canaux normaux.
Flux de droits entitlement-flow
Le flux de droits est une série d’étapes qu’une application de programmation (TVE) doit suivre pour diffuser du contenu protégé. Le flux se compose des phases suivantes :
Lors de la visite initiale d’un utilisateur ou d’une utilisatrice dans une application de programmation (TVE), le flux des droits suit la séquence décrite. Cependant, lors de visites ultérieures, l’application peut contourner certaines étapes en fonction du statut de l’enregistrement ou de l’authentification et des politiques d’affichage applicables.
Pour une exploration détaillée du flux de droits et de ses phases, poursuivez la lecture de ce document, puis reportez-vous aux guides du guide pas à pas pour obtenir plus d’informations :
Phase d’enregistrement registration-phase
La phase d’enregistrement a pour but d’enregistrer l’application cliente par rapport à l’authentification Adobe Pass par le biais du processus Enregistrement client dynamique (DCR).
Le processus d’enregistrement client dynamique (DCR) nécessite que l’application cliente obtienne une paire d’informations d’identification client et récupère un jeton d’accès en tant qu’objectif final de la phase d’enregistrement.
API
Flux
FAQ
Phase de configuration configuration-phase
La phase de configuration a pour but de fournir à l’application cliente la liste des fichiers MVPD auxquels elle est activement intégrée, ainsi que les détails de configuration enregistrés par l’authentification Adobe Pass pour chaque MVPD.
La phase de configuration fait office d’étape préalable à la phase d’authentification lorsque l’application cliente doit demander à l’utilisateur de sélectionner son fournisseur de télévision.
API
FAQ
Phase d’authentification authentication-phase
La phase d’authentification a pour but de permettre à l’application cliente de vérifier l’identité de l’utilisateur à l’aide du MVPD et d’obtenir des informations sur les métadonnées de l’utilisateur.
La phase d’authentification agit comme une étape préalable à la phase de préautorisation ou à la phase d’autorisation lorsque l’application cliente doit lire du contenu.
Une authentification réussie génère un profil lié à l’application, à l’appareil et au fournisseur de services, contenant également les informations de métadonnées de l’utilisateur.
Étapes de haut niveau
Les étapes suivantes décrivent les étapes de haut niveau dans le cas d’une intégration SAML :
-
Chargement de l’application du programmeur (site web)
L’utilisateur accède à l’application du programmeur (site web), qui intègre l’authentification Adobe Pass API REST V2. -
Demande de contenu protégé
Lorsque l’utilisateur tente d’accéder au contenu protégé, l’application du programmeur affiche une liste de fichiers MVPD dans laquelle il peut sélectionner des fichiers. -
Initialisation de la demande d’authentification
Lorsque MVPD est sélectionné, l’utilisateur est redirigé vers un serveur d’authentification Adobe Pass. Ici, une demande d’authentification SAML chiffrée pour le MVPD sélectionné est générée, en cas d’intégration SAML. Cette demande est envoyée au MVPD au nom du programmeur. Selon le système de MVPD, le navigateur de l’utilisateur est redirigé vers la page de connexion de MVPD ou un iFrame de connexion est intégré à l’application du programmeur. -
Connexion à MVPD
Le MVPD accepte la demande et présente son interface de connexion, soit par redirection, soit par iFrame. -
Connexion utilisateur et validation
L’utilisateur se connecte avec ses informations d’identification MVPD. Le MVPD valide le statut d’abonnement de l’utilisateur et établit sa propre session HTTP. -
Réponse de MVPD à l'authentification Adobe Pass
Une fois la validation terminée, le MVPD génère une réponse SAML (chiffrée) et la renvoie vers l’authentification Adobe Pass. -
Génération de profil
L’authentification Adobe Pass vérifie la réponse SAML, génère un profil utilisateur qui est mis en cache et redirige l’utilisateur vers l’application du programmeur (site web).
API
Flux
FAQ
Authentification unique (SSO) single-sign-on
API
Flux
(Facultatif) Phase De Préautorisation preauthorization-phase
L’objectif de la phase de préautorisation est de permettre à l’application cliente de présenter un sous-ensemble de ressources de son catalogue auquel l’utilisateur ou l’utilisatrice serait autorisé à accéder.
La phase de préautorisation peut améliorer l’expérience de l’utilisateur lorsqu’il ouvre l’application cliente pour la première fois ou accède à une nouvelle section.
API
Flux
FAQ
Phase d’autorisation authorization-phase
La phase d’autorisation a pour but de permettre à l’application cliente de lire les ressources demandées par l’utilisateur ou l’utilisatrice après validation de ses droits avec MVPD.
Une autorisation réussie génère une décision, contenant également un jeton multimédia fourni à l’application du programmeur (TVE) à des fins de sécurité.
Étapes de haut niveau
Les étapes suivantes décrivent les étapes de haut niveau :
-
Gestion des identifiants de ressource
Le contenu protégé est identifié par un identifiant de ressource, qui peut être une simple chaîne ou une structure plus complexe. Cet identifiant est prédéfini et accepté par le programmeur et le MVPD. L’application du programmeur envoie l’identifiant de la ressource à l’API REST API REST V2 d’Adobe Pass Authentication. -
Vérification De L’Autorisation MVPD
Le serveur d’authentification Adobe Pass communique avec le point d’entrée d’autorisation MVPD à l’aide de protocoles normalisés. -
Réponse de MVPD à l'authentification Adobe Pass
Une fois la validation terminée, le MVPD confirme que l’utilisateur a le droit (ou non) d’accéder au contenu et renvoie une réponse à Authentification Adobe Pass. -
Génération de jetons de décision et de média
L’authentification Adobe Pass vérifie la réponse, génère une décision qui est mise en cache et renvoie la décision contenant un jeton de média à l’application du programmeur (site web). -
Vérification de l’accès au contenu
L’application du programmeur utilise le vérificateur de jeton multimédia pour confirmer que l’utilisateur ou l’utilisatrice approprié(e) accède au contenu correct. Une fois la validation effectuée, l’utilisateur se voit accorder l’accès à l’affichage du contenu protégé.
API
Flux
FAQ
Phase de déconnexion logout-phase
L’objectif de la phase de déconnexion est de permettre à l’application cliente de mettre fin au profil authentifié de l’utilisateur dans l’authentification Adobe Pass à la demande de l’utilisateur.
API
Flux
FAQ
Déconnexion unique (SLO) single-logout
Flux
Comprendre les droits understanding-entitlements
La solution Authentification Adobe Pass s’articule autour de la création de droits, c’est-à-dire d’éléments de données spécifiques générés lors de la réussite des workflows d’authentification et d’autorisation. Ces droits donnent accès à du contenu protégé, mais leur durée de vie est limitée. Une fois qu’un droit expire, il doit être renouvelé en réinitialisant les processus d’authentification ou d’autorisation.
Pour plus d’informations sur les droits, reportez-vous aux documents suivants :
-
Profils
Une fois l’authentification réussie, l’authentification Adobe Pass crée un profil authentifié (« de longue durée ») associé à l’application, à l’appareil et à l’identifiant du fournisseur de services demandeur (identifiant du demandeur).
-
Une fois l’authentification réussie (et dans certains cas après autorisation également), l’authentification Adobe Pass reçoit des métadonnées de l’utilisateur de la part de MVPD qui peuvent l’exposer à l’application demandeuse.
-
Une fois l’autorisation réussie, l’authentification Adobe Pass crée une décision d’autorisation (« de longue durée ») associée à l’application, à l’appareil, à l’identifiant du fournisseur de services (identifiant du demandeur) et à une ressource protégée spécifique (identifiant de ressource).
-
Une fois l’autorisation réussie, l’authentification Adobe Pass crée un jeton multimédia (« de courte durée ») associé à une demande de lecture réussie et prend en charge les bonnes pratiques du secteur pour atténuer la fraude (par exemple, l’extraction de flux).
Les valeurs de durée de vie (« TTL ») des profils et des décisions sont définies en fonction d'accords entre les programmeurs et les fournisseurs de télévision payante, qui conviennent d'une valeur qui sert au mieux toutes les personnes impliquées.