Intégration LTI 1.3 avec Canvas - Guide d'installation

Configurer Wooclap comme outil LTI 1.3

⚠️ Vous devez être connecté à votre LMS Canvas avec un compte administrateur ou disposant de droits d'administration

Utilisation de la Dynamic Registration

⚠️ Avant de démarrer le processus de Dynamic Registration, assurez-vous que votre contact Wooclap vous a fourni un ID de configuration, car il sera nécessaire pour l'enregistrement

Enregistrer la configuration LTI 1.3 sur Canvas

1. Accédez à l'élément de menu Admin > Votre organisation

2. Dans le menu Admin, accédez à l'élément Clés de développeur, puis cliquez sur + Clé de développeur > LTI Registration

3. Le formulaire de Dynamic Registration LTI 1.3 suivant s'affiche.

4. Renseignez les informations requises dans le formulaire :

ID de configuration – L'ID de configuration fourni par votre contact Wooclap pour la Dynamic Registration.
Nom de l'organisation – Le nom de votre organisation.
Langue – La langue par défaut utilisée par les utilisateurs de votre organisation.
Pays – Le pays par défaut associé aux utilisateurs de votre organisation.
E-mail de l'administrateur – L'adresse e-mail d'un administrateur de votre organisation, afin que notre équipe puisse vous contacter en cas de problème

⚠️ Si l'ID de configuration ne vous a pas encore été communiqué, contactez votre représentant Wooclap pour l'obtenir

5. Une fenêtre de confirmation s'affiche une fois le formulaire soumis. Vérifiez les données, puis cliquez sur le bouton Activer et fermer.

6. L'intégration LTI 1.3 de Wooclap est désormais disponible pour être installée en tant qu'application dans Canvas.

Installer Wooclap en tant qu'application

1. Accédez à l'élément de menu Admin > Votre organisation

2. Accédez ensuite à Paramètres > Apps puis cliquez sur le bouton Afficher la configuration de l'application

3. Cliquez sur le bouton + App

4. Dans la liste Type de configuration, sélectionnez l'option Par ID client

⚠️ Vous pouvez récupérer cet ID client sur votre page Clés de développeur

5. Confirmez l'installation en cliquant sur le bouton Installer

6. L'application Wooclap LTI 1.3 est désormais disponible dans la liste

7. Pour finaliser l'installation de l'application et lui permettre d'accéder à Wooclap, vous devez communiquer l'ID de déploiement à votre contact Wooclap.

⚠️ Sans cet ID de déploiement, Wooclap ne peut pas finaliser l'intégration avec votre LMS Canvas.

Utilisation de l'enregistrement manuel

Accédez au menu Admin de votre instance Canvas

2. Sélectionnez ensuite le compte principal Site admin

3. Puis cliquez sur l'élément de menu Clés de développeur

4. Sur la page Clés de développeur, vous devez créer une nouvelle clé en cliquant sur le bouton + Clés de développeur > LTI Key

Configurez votre instance

1. Renseignez les données requises pour l'outil Wooclap

Nom de la clé	Un nom unique permettant d'identifier votre intégration de l'outil Wooclap dans Canvas
E-mail du propriétaire	L'adresse e-mail de l'administrateur ou de la personne responsable de l'intégration de votre côté
URI de redirection	`https://app.wooclap.com/api/lti13/launch`
Méthode	`Manual Entry`
Titre	Le nom que vous souhaitez donner à votre intégration (visible dans votre LMS)
Description	La description que vous souhaitez donner à votre intégration
URI du lien cible	`https://app.wooclap.com`
URL d'initiation OpenID Connect	`https://app.wooclap.com/api/lti13/oidc`
Méthode JWK	`Public JWK URL`
URL JWK publique	`https://app.wooclap.com/api/jwks`

2. Activez les Services LTI Advantage requis pour permettre la synchronisation de Wooclap avec votre LMS

3. Sélectionnez les Emplacements requis pour rendre cette intégration visible et utilisable dans votre outil

URL de l'icône :

https://s3-eu-west-1.amazonaws.com/tpd/logos/64133aca8b5fd75faaf53dcc/0x0.png

💡 Astuce : Vous pouvez ajuster la taille par défaut du Deep Linking Quicklink :

Largeur : 1200
Hauteur : 800

⚠️ N'oubliez pas d'activer l'option LtiDeepLinkingRequest pour bénéficier de la meilleure expérience possible

4. Afin de rediriger les étudiants vers le devoir Canvas lorsqu'ils scannent le QR code d'un événement Wooclap, vous devez ajouter les paramètres suivants sous « Paramètres supplémentaires » > « Champs personnalisés »

base_url=$Canvas.api.baseUrl 
course_id=$Canvas.course.id 
assignment_id=$Canvas.assignment.id

Voici à quoi devraient ressembler les paramètres supplémentaires

5. Assurez-vous que le Niveau de confidentialité est défini sur Public dans les Paramètres supplémentaires. Cette option est nécessaire pour que Wooclap puisse recevoir l'e-mail, le prénom et le nom de l'utilisateur lors de l'accès à l'activité.

7. Enregistrez votre configuration

8. De retour sur l'interface Clés de développeur, activez votre configuration LTI 1.3

Rendez votre instance Wooclap LTI 1.3 disponible dans votre LMS

1. Accédez à votre menu Admin et sélectionnez l'organisation dans laquelle vous souhaitez installer l'outil Wooclap LTI 1.3

2. Accédez à l'élément de menu Settings puis Apps

3. Ajoutez une nouvelle application

4. Sélectionnez By Client ID pour le Type de configuration et indiquez l'ID client de votre configuration Wooclap LTI 1.3

5. Vous pouvez récupérer cet ID client sur votre page Clés de développeur

6. Installez l'application

7. Votre application est maintenant installée et sera disponible dans votre LMS

Communiquez les détails de votre intégration à Wooclap

⚠️Une fois le LTI 1.3 Wooclap installé sur votre LMS, vous devez communiquer vos informations de configuration à l'équipe Wooclap pour finaliser l'intégration. Cela permettra à Wooclap d'autoriser les requêtes entrantes provenant de votre LMS

1. Communiquez les informations suivantes à votre contact Wooclap

ID de plateforme	Votre ID de plateforme / URL de base du LMS (ex. : `https://canvas.instructure.com`)
ID client	L'ID client de votre intégration (ex. : `10000000000001`)
ID de déploiement	L'ID de déploiement de votre installation (ex. : `1:8865aa05b4b79b64a91a86042e43af5ea8ae79eb`)
URL de l'ensemble de clés publiques	Votre URL de l'ensemble de clés publiques (ex. : `https://your-platform-url/api/lti/security/jwks`)
URL du jeton d'accès	Votre URL de jeton d'accès (ex. : `https://your-platform-url/login/oauth2/token`)
URL de la demande d'authentification	Votre URL de demande d'authentification (ex. : `https://your-platform-url/api/lti/authorize_redirect`)
URL du LMS	L'URL du LMS permet à Wooclap de rediriger les participants vers leur cours d'origine dans le LMS une fois la session terminée. Dans la plupart des cas, cette redirection est gérée automatiquement. Cependant, certaines plateformes LMS telles que Canvas fournissent des URL difficiles à utiliser directement, ce qui rend la redirection automatique peu fiable. Dans ces cas, l'URL du LMS est explicitement demandée afin de garantir que les participants sont correctement redirigés vers leur cours.

⚠️ Une fois l'e-mail contenant tous les détails de configuration LTI 1.3 envoyé à votre contact Wooclap, veuillez attendre notre confirmation indiquant que nous avons enregistré votre intégration de notre côté.