Google OAuth 2.0 est un produit gratuit à code source ouvert qui offre une solution d'identité fédérée permettant de connecter les utilisateurs à des applications de toutes sortes, tant à l'intérieur qu'à l'extérieur des établissements. Le cadre flexible du fournisseur de modules SSO de la plateforme vidéo est conçu pour prendre en charge une grande variété de solutions d'identité, ce qui permet une intégration complète de Google OAuth 2.0 dans votre infrastructure.
Ce document vise à guider les utilisateurs dans l'intégration de la plateforme vidéo, en tant qu'application, à leur système Google API OAuth 2.0. Une fois la configuration terminée, les utilisateurs pourront donner leur consentement et autoriser la plateforme vidéo à accéder aux informations de base de leur compte Google afin de les connecter à la plateforme vidéo en tant qu'utilisateurs nouveaux ou existants.
Configuration
La configuration consiste à ajouter un URI de redirection de la plateforme vidéo à votre projet dans la console Google API, puis à obtenir le fichier de métadonnées JSON, qui contient toutes les informations nécessaires pour configurer le côté plateforme vidéo. Avec le fichier JSON, la configuration de la plateforme vidéo consiste simplement à fournir quelques paramètres et à effectuer une connexion de test. Une fois que vous avez vérifié que le SSO fonctionne, la dernière étape consiste à activer l'authentification pour tous les utilisateurs de votre établissement.
Pour certaines étapes, <organization> doit être remplacé par le DNS générique de l'organisation associée à la plateforme vidéo. Par exemple, pour « https://hudson.yuja.com », <organization> serait remplacé par « hudson ».
Ajouter un URI de redirection de la plateforme vidéo à la console Google API
Pour savoir comment créer des projets dans la console Google API, consultez la page suivante : https://developers.google.com/identity/sign-in/web/devconsole-project
- Dans votre console Google API, choisissez ou créez un projet associé à la plateforme vidéo. Ajoutez la valeur suivante à l'URI de redirection autorisé : https://<organization>.yuja.com/D/OauthAuthentication
- Téléchargez le fichier de métadonnées JSON à partir de la console Google API. Il contient les paramètres nécessaires pour configurer YuJa.
Configurer l'intégration Google OAuth dans la plateforme vidéo
- Connectez-vous à votre zone YuJa en tant que gestionnaire TI et accédez à Panneau d'admin → Intégrations.
- Sous Sélectionner une API à configurer, sélectionnez SSO - Google OAuth 2.0.
- Saisissez les paramètres de configuration suivants :
Paramètre
Valeur
ID client
L'ID client obtenu à partir de la console Google API.
https://console.developers.google.com
Il se trouve aussi dans les données JSON de votre projet, comme valeur de l'attribut « client_id ».
Secret client
Le secret client obtenu à partir de la console Google API. https://console.developers.google.com
Il se trouve aussi dans les données JSON de votre projet, comme valeur de l'attribut « client_secret ».
URI d'authentification
Se trouve dans les données JSON de votre projet, comme valeur de l'attribut « auth_uri ».
URI du jeton
Se trouve dans les données JSON de votre projet, comme valeur de l'attribut « token_uri ».
- Cliquez sur Créer une configuration.
- Cliquez sur OK dans la boîte de dialogue de confirmation.
- Pour vérifier que la configuration est correcte, cliquez sur Tester la connexion OAuth. Un nouvel onglet devrait s'ouvrir et vous rediriger vers Google, qui gère l'authentification et le consentement de l'utilisateur.
- Si aucun utilisateur Google n'est actuellement connecté, saisissez des identifiants valides et cliquez sur Connexion. Sinon, choisissez un compte Google.
- Cliquez sur Autoriser pour donner à la plateforme vidéo l'autorisation d'accéder aux informations de base de l'utilisateur.
- Vous devriez être redirigé vers la plateforme vidéo, connecté en tant que nouvel utilisateur.
La connexion en tant que nouvel utilisateur peut déconnecter le compte d'origine. Si c'est le cas, déconnectez-vous du compte nouvellement créé et reconnectez-vous en tant que gestionnaire TI, puis retournez à Panneau d'admin → Intégrations → SSO – Google OAuth 2.0.
- Une fois que vous avez vérifié que le SSO OAuth fonctionne, vous pouvez choisir d'activer le nouveau schéma d'authentification pour votre organisation en cliquant sur Activer.
N'activez le nouveau schéma d'authentification qu'après avoir effectué avec succès une connexion de test et lorsque vous êtes prêt à le rendre disponible à tous les utilisateurs de votre organisation.
(Facultatif) Double intégration avec LTI
Si votre organisation a activé à la fois LTI et l'accès SSO Google OAuth, vous pouvez choisir de lier les deux intégrations. Par défaut, un utilisateur qui se connecte à la fois par LTI et par OAuth reçoit un compte de la plateforme vidéo distinct pour chaque connexion. Si votre fournisseur LTI est configuré pour authentifier les utilisateurs au moyen des identifiants de leur compte Google, il est possible de lier les deux comptes, car le fournisseur LTI transmettra à la plateforme vidéo un identifiant unique de l'utilisateur dans le système OAuth.
- Configurez votre LMS pour qu'il transmette un paramètre LTI personnalisé appelé lis_person_sourcedid, qui contient la valeur SSO de correspondance. Il peut s'agir d'un courriel, d'un identifiant d'employé ou d'un autre champ. La plateforme vidéo utilisera cette fonctionnalité pour lier les deux méthodes de connexion au même compte.
- Obtenez le nom de l'attribut dont la valeur correspond à l'identifiant unique utilisé par le fournisseur LTI. Les valeurs possibles sont déterminées par l'API Google. Comme la plateforme vidéo ne demande que les informations de profil de base d'un utilisateur donné, le seul attribut valide est « email'.
- Saisissez cette valeur dans Panneau d'admin → Intégrations → Sélectionner une API à configurer → SSO - Google OAuth 2.0 → Attribut de liaison et sélectionnez Sauver l'intégration croisée.
- Désormais, lors de la première connexion par Google OAuth, le système de la plateforme vidéo recherchera un lien avec un compte LTI à l'aide de la valeur de l'attribut de liaison. Si un lien est trouvé, le compte Google sera lié au compte existant. Sinon, un nouveau compte sera provisionné normalement. Toutes les connexions après la première continueront d'être liées au compte de la plateforme vidéo créé ou trouvé lors de la première connexion.
Utilisation
Une fois la console Google API et la plateforme vidéo correctement configurées et le SSO OAuth activé, les utilisateurs qui accèdent au domaine de la plateforme vidéo de votre organisation seront authentifiés par Google OAuth 2.0 plutôt que par la connexion standard de la plateforme vidéo. Il est facile de vérifier que tout a été fait correctement en suivant les étapes ci-dessous :
- Accédez à la zone de la plateforme vidéo de l'organisation.
- Cliquez sur Connexion. L'utilisateur devrait être redirigé vers Google, où il sélectionnera un compte à utiliser et donnera son consentement pour permettre à la plateforme vidéo d'accéder à ses informations de base.
- Une fois l'accès autorisé, l'utilisateur devrait être redirigé vers la plateforme vidéo et connecté avec succès.