Skip to main content

Ally pour l'intégration D2L Brightspace

Pour intégrer Ally à votre instance D2L Brightspace, vous devez suivre les étapes suivantes :

  1. Création d’utilisateurs et de rôles. Ceci doit être effectué avant tout entretien téléphonique avec votre contact d'Anthology Ally.

  2. Configuration principale

  3. Configurer le LTI

    • Configuration client

    • Rapport d'établissement

    • Rapport sur l'accessibilité des cours

Création d'utilisateurs et de rôles

  1. Créer un nouveau rôle 

    1. Dans le menu Paramètres (icône en forme d'engrenage), accédez à Rôles et autorisations 

    2. Démarrez le processus de création d'un rôle en sélectionnant le bouton Créer/Copier 

    3. Créez un nouveau rôle vide en sélectionnant le bouton Start Fresh 

    4. Paramètres du rôle : 

      • Nom : Ally REST Rôle 

      • Description : ensemble d'autorisations permettant à Ally de communiquer en toute sécurité avec les interfaces de programmation d'application REST de Brightspace 

      • Activer Rôle en cascade 

        Laissez l'option Facilitateur principal désactivée car elle n'est peut-être plus nécessaire

      • Alias du rôle : ally 

      • Aucune modification n'est nécessaire dans Options de comportement des outils, tout peut rester désactivé 

      • Aucune modification n'est nécessaire dans Options d'affichage de la liste des classes, tout peut rester désactivé 

      • Sous Options d'accès aux cours : 

        • Activez toutes les options d'accès : 

          • Accédez à des cours inactifs 

          • Accédez aux cours précédents 

          • Accédez aux prochains cours 

        • Les sections et les groupes peuvent rester paramétrés sur Aucune des valeurs ci-dessus 

    5. Interactions entre les rôles : 

      1. Sous Inscrire > Rôle REST Ally, cochez la case à l’intersection de la ligne de l’administrateur et de la colonne Communauté. Cela permet de créer ultérieurement un utilisateur avec ce rôle. 

      2. Sous Rechercher > Rôle REST Ally, cochez la case à l’intersection de la ligne de l’administrateur et de la colonne Communauté. Cela permet de rechercher ultérieurement un utilisateur avec ce rôle. 

      3. Aucune autre modification n'est nécessaire.

  2. Configurer les autorisations du rôle 

    Une fois enregistré, le nouveau rôle Ally REST apparaîtra en bas de la liste des rôles. Ouvrez la liste déroulante et sélectionnez Modifier les autorisations. Dans cet écran, les autorisations suivantes doivent être accordées : 

    1. Filtrer par Outil de contenu et accorder les autorisations suivantes dans la colonne Offre de cours : 

      • Afficher le contenu du cours 

      • Compiler et télécharger du contenu 

      • Télécharger des sujets de contenu 

      • Afficher le contenu qui n'est pas publié 

      • Gérer le contenu 

      • Création et modification de modules et de sujets 

      • Supprimer des modules et des sujets (nécessaire pour supprimer les images susceptibles de provoquer des crises)

    2. Console de gestion des cours

      • Voir Informations sur les cours (Offre de cours). Cette autorisation est requise pour qu'Ally puisse récupérer les unités de la communauté du département.

    3. Liste de classes

      • A accès à la liste des classes

    4. Discussions 

      • Afficher les discussions (Offre de cours)

        Cela est nécessaire pour répertorier les liens vers les sujets de discussion d'un cours et sa table des matières. 

    5. Questionnaires 

      • Afficher les questionnaires (Offre de cours)

        Cela est nécessaire pour répertorier les liens vers les questionnaires dans la table des matières d'un cours. 

    6. Éditeur d'unités organisationnelles 

      • Afficher l'éditeur d'unités de communauté (Communauté)  

      • Peut ajouter et modifier des types d'unités de communauté (communauté).

        Nous avons besoin de ce rôle pour répertorier les semestres. Malheureusement, aucune autorisation « lecture seule » n'est disponible. Ally ne créera ni ne modifiera jamais d'informations de type unité communauté.

    7. Sécurité 

      • Voir Rôles et autorisations (communauté)

    8. Confidentialité des informations utilisateur

      1. Voir les noms d'utilisateur (offre de cours)

        Cette autorisation permet à Ally de voir l'identifiant de l'utilisateur, mais rien d'autre. Ces informations ne sont jamais stockées, mais pour des raisons techniques, il est nécessaire de déterminer le nombre d'étudiants inscrits à un cours.

      2. Voir Prénoms (communauté)

        Nécessaire pour récupérer le nom et l'adresse e-mail de l'utilisateur lorsqu'il demande de l'aide. Cela n'est jamais stocké du côté d'Ally et ne figure que dans l'e-mail d'aide.

      3. Voir les noms de famille (communauté)

        Nécessaire pour récupérer le nom et l'adresse e-mail de l'utilisateur lorsqu'il demande de l'aide. Cela n'est jamais stocké du côté d'Ally et ne figure que dans l'e-mail d'aide.

      4. Voir Adresses e-mail (communauté)

        Nécessaire pour récupérer le nom et l'adresse e-mail de l'utilisateur lorsqu'il demande de l'aide. Cela n'est jamais stocké du côté d'Ally et ne figure que dans l'e-mail d'aide.

    9. Utilisateurs

      1. Afficher les effectifs des utilisateurs (offre de cours)

      2. Recherchez « étudiant » (Offre de cours)

        Étudiant est le nom par défaut du rôle d'étudiant. Si votre établissement utilise un autre nom pour ce type d’utilisateur, activez la fonction Rechercher ... à la place. Cela est nécessaire pour récupérer le nombre d'étudiants dans une offre de cours. Les données envoyées sont anonymisées.

      3. Afficher l'adresse e-mail des utilisateurs (communauté)

        Il est nécessaire de récupérer l'e-mail de l'utilisateur lorsqu'il demande de l'aide. Cela n'est jamais stocké du côté d'Ally et ne figure que dans l'e-mail d'aide.

      4. Voir l'outil de gestion des utilisateurs (communauté)

        Il est nécessaire de récupérer le nom et l'adresse e-mail de l'utilisateur lorsqu'il demande de l'aide. Cela n'est jamais stocké du côté d'Ally et ne figure que dans l'e-mail d'aide.

  3. Création d'utilisateurs

    Une fois le rôle configuré, un nouvel utilisateur peut être créé avec cet ensemble limité d'autorisations. 

    1. Dans le menu Paramètres (icône en forme d'engrenage), accédez à Utilisateurs 

    2. Démarrez le processus de création de rôle en sélectionnant le bouton Nouvel utilisateur 

    3. Réglages : 

      • Prénom : Ally 

      • Nom de famille : Utilisateur 

      • Rôle : Rôle Ally REST 

      • Nom d'utilisateur : allyuser 

      • Sélectionnez Définir manuellement le mot de passe et saisissez un mot de passe sécurisé dans le champ Mot de passe. Il est essentiel que ce mot de passe soit suffisamment sécurisé, car il ne sera pas possible de le modifier ultérieurement sans tout configurer à nouveau.

      • Enregistrez l'utilisateur en sélectionnant le bouton Enregistrer 

Configuration principale

Important

Assurez-vous de configurer l’utilisateur et le rôle dans un premier temps. La configuration suivante doit être effectuée lors d’un entretien téléphonique avec un contact d'Anthology Ally. Assurez-vous donc de planifier cet appel de configuration.

  1. Dans le menu Paramètres (icône d’engrenage), accédez à Gérer l’extensibilité.

  2. Assurez-vous d'être sur l’onglet OAuth 2.0.

  3. Sélectionnez le bouton Enregistrer une application

  4. Remplissez le formulaire de la manière suivante :

    • Nom : Ally

    • URI de redirection : <URI de redirection fourni par le contact Anthology>

      par exemple https://[Ally env]/api/v1/d2l/callback?clientId=[Ally client ID]

    • Portée : content : *:read content:file:write core : *:* custom:contentaccess:read effectif :orgunit:read

    • Demande de consentement de l'utilisateur : Non

    • Activer les jetons d'actualisation : Oui

    • J'accepte le contrat de développeur non commercial : Oui

  5. Sélectionnez le bouton Enregistrer

  6. Les détails de la nouvelle application vous seront alors présentés. Copiez le code client et la clé secrète, puis partagez-les avec votre contact Anthology Ally.

  7. Après avoir reçu la confirmation d'Anthology Ally, sélectionnez Mettre à jour

  8. Connectez-vous à Brightspace en tant qu'utilisateur allié

  9. Accédez à l'URL fournie par votre contact Anthology Ally (sous Détails d'intégration du client d'administration Ally). Bien qu'il s'agisse d'une URL dont le nom d'hôte se termine par .ally.ac, vous serez automatiquement redirigé vers votre instance Brightspace. Brightspace affichera un écran vous demandant d'autoriser Ally à interagir avec l'interface de programmation d'application REST. Sélectionnez Accepter.

  10. Si tout s'est bien passé, le message de réussite suivant devrait s'afficher : L'intégration REST a été configurée avec succès !

  11. Dans le menu Paramètres (icône d’engrenage), accédez au Navigateur des variables de navigation.

  12. Localisez les configurations Ally à l'aide de l'arborescence de gauche : 3rdParty >Ally

    L'intégration d'Ally se trouve dans D2L.3rdParty.Ally.*

  13. Ajoutez les valeurs de configuration à celles qui vous ont été fournies par votre contact Blackboard

    • ClientId

    • ClientSecret : BrightSpace présente deux entrées. Utilisez le secret LTI pour les deux entrées.

    • ScriptUrl

  14. Dans le menu Paramètres (icône d’engrenage), accédez à Outils organisationnels.

  15. Trouvez la ligne correspondant à l'intégration Ally et cochez la case pour qu'elle soit activée

Configurer le LTI

Suivez cette étape pour configurer le LTI et enregistrer les outils Ally.