LTI 1.3 place Raison dans les cours Canvas et indique à Raison quel utilisateur, quel cours et quel rôle lance l'outil. Raison publie l'ensemble de sa configuration LTI sous forme de fichier JSON : aucun endpoint, placement ou option LTI Advantage n'est à saisir à la main.
Configurez d'abord la connexion API. Consultez Configuration de Canvas : connexion API (OAuth).
Documentation officielle Canvas : Configuring LTI Advantage tools.
Créer une clé développeur LTI
Dans Canvas, allez dans Admin → Your Canvas account → Developer Keys, puis + Developer Key → + LTI Key.
Champ | Valeur recommandée |
Key Name |
|
Owner Email |
Le nom de la clé n'est visible que par les administrateurs Canvas. Le titre que voient les apprenants dans le menu du cours provient de la configuration et peut être modifié ultérieurement sur la clé développeur.
Charger la configuration LTI de Raison
Réglez Method sur Enter URL et collez cette adresse dans le champ JSON URL :
https://services.raison.is/integration/lti/config/canvas.json
La même URL est disponible dans Raison sous Organisation → Intégrations → Canvas → Configurer → LTI, dans le champ Canvas configuration URL.
Enregistrez la clé, puis passez-la sur On dans la colonne State de la liste Developer Keys.
Copier le Client ID LTI dans Raison
Copiez le Client ID depuis la colonne Details et collez-le dans le champ Client ID sous Organisation → Intégrations → Canvas → Configurer → LTI.
Installer l'application Raison dans Canvas
Allez dans Admin → Your Canvas account → Settings → Apps.
Sélectionnez + App.
Choisissez By Client ID comme type de configuration.
Collez le Client ID LTI.
Sélectionnez Submit, puis Install.
Une installation au niveau du compte rend généralement Raison disponible dans tous les cours de ce compte, selon votre configuration Canvas. Vous pouvez aussi l'installer cours par cours depuis Course → Settings → Apps.
Récupérer le Deployment ID
Trouvez Raison dans la liste des applications installées, ouvrez l'icône d'engrenage, sélectionnez Deployment ID et copiez la valeur dans le champ Deployment ID de Raison.
Terminer les paramètres LTI dans Raison
Saisissez d'abord l'adresse de votre Canvas dans le champ Canvas URL. Raison remplit automatiquement les URL d'autorisation, de jeton et JWKS. L'émetteur (issuer) vaut par défaut https://canvas.instructure.com. Vérifiez chaque valeur avant d'enregistrer.
Champ | Valeur à saisir | Fixe ou spécifique ? |
Client ID | Le Client ID de la clé développeur LTI | Spécifique à votre instance Canvas |
Deployment ID | Le Deployment ID généré lors de l'installation de l'application | Spécifique à chaque déploiement |
Issuer URL |
| Toujours identique pour Canvas hébergé par Instructure |
Authorization URL |
| Spécifique à votre instance Canvas |
Token URL |
| Spécifique à votre instance Canvas |
JWKS URL |
| Spécifique à votre instance Canvas |
Remplacez [votre-domaine-canvas] par votre domaine Canvas réel. Pour une instance située à https://canvas.example.edu, l'URL d'autorisation est https://canvas.example.edu/api/lti/authorize_redirect.
À propos de l'Issuer URL : toutes les instances Canvas hébergées par Instructure utilisent https://canvas.instructure.com, quel que soit le domaine de votre établissement. Certains environnements auto-hébergés ou configurés de façon particulière peuvent différer. En cas d'échec d'un lancement, vérifiez auprès de votre administrateur Canvas.
Sélectionnez Enregistrer les paramètres LTI.
Tester la connexion LTI
Ouvrez un cours Canvas et sélectionnez Raison AI Assistant dans la navigation du cours (titre par défaut de l'outil ; les administrateurs Canvas peuvent le renommer sur la clé développeur LTI). Soit l'assistant s'ouvre, soit un message indique qu'aucun assistant n'est associé à ce cours. Dans les deux cas, le lancement fonctionne.
Ce que Canvas transmet à Raison au lancement
À chaque lancement LTI, Canvas transmet :
L'identité de l'apprenant (nom, e-mail, identifiant utilisateur)
Le contexte du cours (identifiant du cours, nom du cours)
Le rôle de l'utilisateur (enseignant, étudiant, administrateur)
Raison peut ainsi placer automatiquement l'apprenant dans le bon cours et appliquer les bonnes autorisations, sans connexion supplémentaire.
Liste de vérification LTI
La clé développeur LTI est activée dans Canvas
L'URL de configuration JSON de Raison a été acceptée
L'application est installée dans le compte Canvas
Le Client ID et le Deployment ID sont enregistrés dans Raison
Les URL de l'émetteur, d'autorisation, de jeton et JWKS sont correctes
Raison s'ouvre depuis un cours Canvas
Articles liés
Besoin d'aide ? Écrivez à [email protected].