Blackboard (désormais Anthology) utilise le même modèle API + LTI que Canvas, avec une différence essentielle : Raison est enregistré une seule fois, globalement, sur l'Anthology Developer Portal, et non par établissement. L'Application ID est le même pour toutes les instances Blackboard. Les administrateurs ne génèrent jamais leurs propres identifiants. Ils saisissent l'Application ID fixe de Raison dans leur instance Blackboard, et Blackboard génère en retour un Deployment ID.
La configuration est minimale des deux côtés : l'URL Blackboard pour l'API, et le Deployment ID pour LTI. Aucune URL, aucun jeton ni aucune clé à rechercher.
Documentation officielle d'Anthology :
Ce que fait l'intégration
Import des cours et du contenu via l'API REST. Raison lit la structure et le contenu de vos cours Blackboard (modules, fichiers, pages) et les rend disponibles comme sources pour les assistants.
Identification et placement des apprenants via LTI. Lorsqu'un apprenant ou un enseignant ouvre Raison depuis un cours Blackboard, Blackboard l'authentifie via LTI 1.3 et transmet son identité et le contexte du cours à Raison.
Enregistrer l'outil LTI dans Blackboard
Dans Blackboard, allez dans Admin → Integrations → LTI Tool Providers → Register LTI 1.3/Advantage Tool.
Saisissez l'Application ID de Raison et sélectionnez Submit.
Application ID LTI de Raison (production) : 3c3399d2-714c-4d42-9dbd-fb79baf6a160
Blackboard affiche la configuration préremplie de l'outil (nom, placements, politiques de l'établissement), récupérée depuis l'Anthology Developer Portal. Vérifiez-la et sélectionnez à nouveau Submit pour confirmer.
Une fois la confirmation effectuée, un Deployment ID est généré. Il est propre à votre instance Blackboard.
Aucune URL n'est à configurer manuellement. Comme Raison est enregistré de façon centralisée sur l'Anthology Developer Portal, tous les endpoints LTI (redirect URIs, JWKS URL, OIDC login URL, placements) sont préconfigurés. Blackboard les récupère lorsque vous saisissez l'Application ID.
Enregistrer l'intégration API REST dans Blackboard
Dans Blackboard, allez dans Admin → Integrations → REST API Integrations → Create Integration.
Champ | Valeur à saisir |
Application ID |
|
Learn User | Un utilisateur Blackboard disposant de droits suffisants pour lire le contenu des cours (un compte de service dédié ou un utilisateur administrateur) |
End User Access | Yes |
Authorized To Act As User | No (Service Default) |
Sélectionnez Submit.
Le Learn User que vous attribuez ici détermine les cours et les données auxquels Raison peut accéder via l'API. Utilisez un compte de service dédié plutôt qu'un compte administrateur personnel.
Saisir le Deployment ID dans Raison
Dans Raison, allez dans Organisation → Intégrations → Blackboard → Gérer → LTI.
Champ | Valeur à saisir | Fixe ou spécifique ? |
Deployment ID | Le Deployment ID généré par Blackboard | Propre à votre instance Blackboard |
Sélectionnez Enregistrer les paramètres LTI.
Les endpoints globaux de Blackboard sont gérés en interne : il n'y a donc aucun champ Issuer URL, Authorization URL, Token URL ou JWKS URL à remplir ici.
Saisir l'URL Blackboard dans Raison
Dans Raison, allez dans Organisation → Intégrations → Blackboard → Gérer → API.
Champ | Valeur à saisir | Fixe ou spécifique ? |
URL Blackboard | L'URL de base de votre instance Blackboard (par ex. | Propre à votre établissement |
Sélectionnez Enregistrer les modifications.
Raison s'authentifie auprès de l'API REST de Blackboard à l'aide de l'Application ID et du secret enregistrés sur l'Anthology Developer Portal. Aucun jeton personnel n'est à générer.
Ajouter des utilisateurs Blackboard comme membres Raison
Les enseignants et administrateurs qui doivent créer ou gérer des assistants dans Raison doivent être ajoutés comme membres de votre organisation Raison. Cette étape associe leur identité Blackboard à leur compte Raison.
Dans Raison, allez dans Organisation → Membres et sélectionnez Ajouter un membre → Inviter un utilisateur Blackboard.
Raison propose deux façons de trouver un utilisateur :
Par nom d'utilisateur (recommandé). Saisissez le nom d'utilisateur Blackboard de la personne. Cela confirme immédiatement que le compte existe dans votre instance Blackboard. Utilisez cette méthode dès que vous connaissez le nom d'utilisateur.
Par e-mail. Si vous ne connaissez pas le nom d'utilisateur, recherchez par adresse e-mail. Raison retrouve le nom d'utilisateur Blackboard correspondant. Cela fonctionne, mais prend plus de temps, car la recherche doit croiser les informations du compte dans Blackboard.
Une fois l'utilisateur trouvé, confirmez l'invitation. L'utilisateur apparaît dans la liste Membres et peut commencer à créer des assistants liés à ses cours Blackboard.
Les deux méthodes fonctionnent. Le nom d'utilisateur est simplement plus rapide. Si les enseignants peuvent communiquer leur nom d'utilisateur Blackboard dès le départ, l'intégration des utilisateurs est plus rapide.
Ce qui est fixe et ce qui est spécifique
Élément | Fixe ou spécifique ? |
Application ID (LTI + REST) | Toujours le même. Fourni par Raison, enregistré une seule fois sur l'Anthology Developer Portal. |
Deployment ID | Propre à votre instance Blackboard. Généré par Blackboard après la saisie de l'Application ID. |
URL Blackboard | Propre à votre établissement |
Tous les endpoints LTI | Toujours les mêmes. Préconfigurés de façon centralisée, aucune saisie manuelle. |
Jeton API REST | Non requis. L'authentification utilise la paire Application ID / secret. |
Articles liés
Besoin d'aide ? Écrivez à [email protected].