Générer un jeton d'accès Ally

Ally doit pouvoir synchroniser des données telles que des cours et des fichiers à partir de l'API REST Canvas pour générer des rapports et fournir le feed-back du professeur. Pour garantir la sécurité de cette opération, un jeton d'accès doit être généré.

Seuls les administrateurs du système de gestion de l'apprentissage Instructure Canvas peuvent générer un jeton d'accès.


Étape 1 : Créer un nouveau rôle de compte

Les nouveaux rôles de compte vous permettent de définir les permissions du service Ally. Vous pouvez voir les permissions accordées au service Ally dans l'interface d'administration de Canvas. À un niveau élevé, ces permissions permettent à Ally de télécharger des informations sur les périodes de cours, les cours et les fichiers afin de générer des feed-backs sur l'accessibilité et des versions alternatives. Elles permettent également à Ally de supprimer et de remplacer les contenus de fichiers importants pour aider les professeurs à corriger le contenu de leurs cours.

  1. Connectez-vous à votre installation Canvas en tant qu'administrateur.
  2. Cliquez sur l'icône Admin dans le menu de gauche, puis sélectionnez votre compte dans la fenêtre qui s'affiche.
  3. Sélectionnez Permissions, puis Account Roles (Rôles de compte).
  4. Sélectionnez Add Role (Ajouter un rôle).
  5. Enregistré un rôle nommé Ally. Une fois ce rôle enregistré, une nouvelle colonne nommée Ally s'affiche dans le tableau.
  6. Dans la colonne Ally, activez ces permissions.
    • Courses - view list (Cours - voir la liste)
    • Users - act as (Utilisateurs - agir en tant que)
    • Announcements - view (Annonces - consulter)
    • Assignments and Quizzes - add / edit / delete (Devoirs et quiz - ajouter/modifier/supprimer)
    • Course Content - add / edit / delete (Contenu de cours - ajouter/modifier/supprimer)
    • Course Content - view (Contenu de cours - consulter)
    • Course files- add / edit / delete (Fichiers de cours - ajouter/modifier/supprimer)
    • Discussions - moderate (Discussions - modérer)
    • Discussions - view (Discussions - consulter)
    • pages - add / edit / delete (Pages - ajouter/modifier/supprimer)

Étape 2 : Créer un nouvel utilisateur

Il est conseillé de créer un nouvel utilisateur pour chaque intégration dans Canvas. Si les utilisateurs de votre établissement sont créés directement dans Canvas, suivez ces instructions. En revanche, si les utilisateurs sont gérés dans un système externe tel que SIS ou LDAP, suivez les instructions concernant la création d'utilisateurs pour une utilisation dans Canvas pour votre établissement, puis attribuez au nouvel utilisateur le rôle Ally.

Si les utilisateurs sont créés directement dans Canvas pour votre établissement, suivez les étapes suivantes.

  1. Accédez à la page Users (Utilisateurs) dans la gestion du compte.
  2. Sélectionnez New User (Nouvel utilisateur) et ajoutez un nouvel utilisateur nommé Ally.
  3. Assurez-vous que la case Email the user about this account creation (Prévenir l'utilisateur par e-mail lors de la création de ce compte) est cochée.
  4. Cliquez sur le lien reçu dans votre messagerie pour confirmer votre compte.

Étape 3 : Attribuer au nouvel utilisateur le rôle Ally

  1. Accédez à la page Settings (Paramètres) dans la gestion du compte.
  2. Sélectionnez Admins (Administrateurs).
  3. Cliquez sur le bouton + Account Admins (+ Administrateurs de compte) pour ajouter l'utilisateur.
  4. Dans le formulaire qui s'affiche, vérifiez que le rôle Ally est sélectionné dans le menu.
  5. Si les utilisateurs sont créés directement dans Canvas pour votre établissement, vous êtes invité à saisir l'adresse e-mail de l'utilisateur créé dans la section précédente. Si l'utilisateur a été créé dans un système externe tel que SIS ou LDAP, saisissez l'identifiant de l'utilisateur dans le champ approprié.
  6. Sélectionnez Continue... (Continuer...).
  7. Si l'utilisateur est trouvé, sélectionnez OK Looks Good (OK, correct).
  8. Vérifiez que l'utilisateur Ally a été ajouté à la liste.

Étape 4 : Générer un jeton d'accès

Dans cette dernière étape, vous allez générer un jeton d'accès qui permettra au service Ally d'interagir de manière sécurisée avec l'API REST.

  1. Connectez-vous en tant qu'utilisateur Ally.

    Vous ne pouvez pas vous connecter en vous faisant passer pour l'utilisateur Ally, car Canvas interdit aux administrateurs de configurer un jeton d'accès pour le compte d'un autre utilisateur.

  2. Accédez aux paramètres utilisateur en sélectionnant Account (Compte) dans le menu de gauche, puis en cliquant sur Settings (Paramètres) dans la fenêtre qui s'ouvre.
  3. Sélectionnez New Access Token (Nouveau jeton d'accès).
  4. Saisissez Ally.ac integration comme motif pour le jeton. Vous pouvez laisser le champ d'horodatage vide.
  5. Sélectionnez Generate Token (Générer le jeton).
  6. Une nouvelle fenêtre contenant le jeton d'accès s'ouvre. Copiez le jeton maintenant. Une fois cette page fermée, vous ne pourrez plus y accéder.