Configurer le connecteur Moodle

TABLE DES MATIÈRES
Introduction
Fonctionnement général du connecteur
   Inscription des utilisateurs
   Création administrative d'un cours
   Mise à jour des données
Créer et paramétrer le connecteur Lära sur Moodle
   Installer et configurer « User Key Authentication »
   Installer et configurer « Lara_enrolment »
   Activer les « Services web »
      Activer les services web
      Activer les protocoles
      Créer un utilisateur spécifique
      Vérifier la capacité utilisateur
      Sélectionner un service
      Ajouter des fonctions
      Sélectionner un utilisateur spécifique
      Créer un jeton pour un utilisateur
      Activer la documentation développeur
      Tester le service
   Configurer les courriels sortants
Créer et paramétrer le connecteur Moodle sur Lära
   Créer le connecteur Moodle sur Lära
Créer un élément Moodle dans une session
Logiques de gestion des participants

• Recherche du compte utilisateur Moodle associé au compte utilisateur Lära. Cela est basé sur le champ de synchronisation choisi lors de la création du connecteur Moodle (courriel, login, etc.);
• Création du compte si aucun compte n'est trouvé, mise à jour du compte si un compte correspondant est trouvé.

Lors de la désinscription du participant de la session sur Lära, le participant est aussi désinscrit du cours sur Moodle.

ATTENTION : les utilisateurs sur Lära ne doivent pas être en mesure de modifier leur champ de liaison (nom d'utilisateur, courriel ou numéro d'identification) sélectionné lors de la configuration de User Key Authentication. Si un utilisateur ou un administrateur change ce champ, un nouveau compte sera créé sur Moodle lors d'un nouvel accès du participant inscrit au cours Moodle par Lära.

Les systèmes ne sont pas forcément maintenus en parfaite synchronie en tout temps. Il est donc possible que certaines données ne soit pas à jour lors de consultation administrative à haut niveau. Quatre principaux cas mènent à la synchronisation des données entre les deux systèmes :

• Lors de l’accès d’un participant à la ressource : ses données utilisateurs sont mises à jour et son taux de complétion est mise à jour;
• Lors de l’inscription ou de la désinscription du participant dans Lära : l’information est mise à jour sur Moodle;
• Lors de l’accès d’un formateur à la session sur Lära : l’ensemble des données utilisateurs sur Moodle sont mises à jour;
• Lors de la suppression du connecteur dans Lära : les utilisateurs sont automatiquement désinscrits sur Moodle.

Rendez-vous dans la sections « Administration du site » sur Moodle, puis sous « Plugins », et cliquez sur « Installer des plugins ». Installez le fichier auth_userkey_moodle.zip que vous avez téléchargé, puis cliquez sur « Installer le plugin à l'aide du fichier ZIP ».

• Mapping field * : sélectionnez le champ de liaison des utilisateurs avec Lära.
  * Ce champ est le plus important. Les autres champs ci-dessous peuvent demeurer par défaut.
• User key life time : durée de la clé cryptographiques. La valeur par défaut est suggérée (« 60 »);
• IP Restriction : permet de restreindre l'accès au Moodle pour certaines adresses IP uniquement. Dans un milieu sécurisé, ce paramètre pourrait être utilisé. La valeur par défaut est suggérée («Non »).
• Whitelist IP ranges : en relation avec le champ précédent, permet de restreindre une plage d'adresses IP. La valeur par défaut est suggérée (vide);
• Logout redirect URL : veuillez laisser ce champ vide;
• URL of SSO host : veuillez laisser ce champ vide;
• Create user : veuillez laisser ce champ à « non »;
• Update user : veuillez laisser ce champ à « non »;

Pour la section du bas « Verouiller les champs utilisateur », veuillez laisser toutes les valeurs à « Déverrouillé ».

Rendez-vous dans la sections « Administration du site » sur Moodle, puis sous « Plugins », et cliquez sur « Installer des plugins ». Installez le fichier Lara_enrolment.zip que nous vous avons fourni, puis cliquez sur « Installer le plugin à l'aide du fichier ZIP ».

Une fois le plugin installé, rendez-vous dans la sections « Administration du site » sur Moodle, puis sous « Plugins », et cliquez sur « Vue d'ensemble des plugins ». Cliquez sur « Plugins additionnels », puis sur les « Paramètres » du plugin « enrol_lara » :

• Ajouter une instance aux nouveaux cours : Conservez le paramètre coché, ou « Oui ». Permet la méthode d'inscription par Lära pour tous les nouveaux cours; 
• Activer l'inscription Lära : lorsqu'un utilisateur est inscrit à une session Lära qui contient des cours Moodle, il est automatiquement inscrit aux cours Moodle correspondant. Sélectionnez « Oui ».

• Protocole REST : ce protocole est activé par défaut sur Moodle. Veuillez vous assurer qu'il est activé;
• Documentation services web : veuillez laisser ce paramètre par défaut, à « Non ». Aucune documentation technique est présentement disponible.

Il est suggéré de choisir un utilisateur qui a tous les droits (droits exhaustifs) pour éviter tout problème. Il faut au minimum l'ensemble des droits suivants :
- Generate login user key - auth/userkey:generatekey
- Consulter le rapport d’achèvement du cours - report/completion:view
- Créer des cours - moodle/course:create
- Cacher/afficher les cours - moodle/course:visibility
- Modifier les réglages des cours - moodle/course:update
- Modifier la catégorie du cours - moodle/course:changecategory
- Modifier le nom du cours - moodle/course:changefullname
- Modifier le nom abrégé du cours - moodle/course:changeshortname
- Modifier le n° d’identification du cours - moodle/course:changeidnumber
- Modifier le résumé du cours - moodle/course:changesummary
- Voir les informations cachées des utilisateurs - moodle/user:viewhiddendetails
- Activer/désactiver les adresses de courriel - moodle/course:useremail
- Mettre à jour les profils des utilisateurs - moodle/user:update
- Accéder à tous les groupes - moodle/site:accessallgroups
- Créer les utilisateurs - moodle/user:create
- Inscrire des utilisateurs - enrol/lara:enrol
- Désinscrire les utilisateurs du cours - enrol/lara:unenrol

Si l'utilisateur n'a pas tous les droits requis, rendez-vous dans la section « Administration du site » sur Moodle, puis sous « Permissions », et cliquez sur « Administrateurs du site ». Veuillez ajouter l'utilisateur responsable de l'interconnexion comme administrateur, ou modifiez manuellement son profil de droits pour lui octroyer les droits requis.

Veuillez « Sélectionner un service » et créer un nouveau service à l'aide du bouton « Ajouter » de la section « Services personnalisés » :

• Nom : veuillez donner un nom à votre nouveau service. C'est ce nom qui sera affiché sur Lära lors de la création de cours, assurez-vous qu'il soit bien identifié;
• Nom abrégé : nom court, facultatif;
• Activé : veuillez cocher cette option pour rendre le service actif;
• Uniquement les utilisateurs autorisés : vous pouvez cocher cette option pour limiter qui pourra créer des jetons pour ce service.

Cliquez sur « Ajouter un service ».

- core_user_update_users
- core_course_update_courses
- core_user_get_users
- core_course_create_courses
- core_user_create_users
- core_completion_get_course_completion_status
- core_enrol_get_enrolled_users
- core_course_get_courses_by_field
- enrol_lara_enrol_users (ou enrol_manual_enrol_users)
- enrol_lara_unenrol_users (ou enrol_manual_unenrol_users)
- auth_userkey_request_login_url

Ajouter les fonctions à l'aide du bouton « Ajouter des fonctions » :

• Nom : veuillez donner un nom à votre nouveau jeton d'authentification;
• Utilisateur : veuillez rechercher et l'utilisateur « maître » du connecteur Lära-Moodle;
• Service : sélectionnez le service que vous avez créé et pour lequel vous désirez générer un jeton;
• Restriction IP : vous pouvez entrer une adresse IP ou une plage pour limiter l'accès au jeton. Nous vous suggérons de laisser ce champ vide;
• Valide jusqu'au : vous pouvez activer cette fonctionnalité pour limiter jusqu'à quand le jeton pour le connecteur sera valide. Nous vous suggérons de laisser ce champ désactivé.

Vous devrez maintenant copier et conserver le jeton généré pour les prochaines étapes de configurations, qui se dérouleront sur Lära : 

Veuillez noter que si l'utilisateur sélectionné pour créer le jeton n'a pas les capacités (droits) suffisantes pour utiliser le jeton,

• Nom administratif * : donnez un nom administratif au connecteur. Ce nom sera affiché dans les liste et doit être facile à identifier parmi les autres connecteurs Moodle créés;
• URL du Moodle * : entrez l'adresse URL (domaine) du Moodle à interconnecter;
• Token d'identification * : entrez le jeton que vous avez créé pour l'utilisateur à l'étape « Créer un jeton pour un utilisateur ». Si vous n'avez pas pris note de ce jeton, vous pouvez répéter l'étape pour créer un nouveau jeton;
• Identifiant de la catégorie Moodle : entrez l'identifiant de la catégorie sur Moodle. Vous devez créer un connecteur Moodle par catégorie, si vous en avez plusieurs;
• Paramètres à ajouter à l'entête lors des appels Moodle (au format Json) : [text]
• Champ utilisé pour trouver la liaison de l'utilisateur : sélectionnez le champ utilisateur qui sera utilisé pour faire la liaison entre l'utilisateur Lära et l'utilisateur créé sur Moodle;
• Branches : Sélectionnez une branche responsable de la gestion administrative du connecteur Moodle. La branche par défaut est la branche « racine », ou administrative de l'organigramme.
• Synchroniser les données des utilisateurs existants : permet de synchroniser les données utilisateur (par défaut : activé); 
• Permettre de créer des utilisateurs dans Moodle : permet créer des utilisateurs de Lära par défaut sur Moodle (par défaut : activé);
• Synchroniser la complétion des utilisateurs : permet de synchroniser la complétion de Moodle avec Lära (par défaut : activé);
• Permettre de créer des cours dans Moodle :permet de créer de nouveaux cours sur Moodle à parti d'éléments sur Lära (par défaut : activé);

Rendez-vous sous l'onglet « Configuration des données » et définissez les paramètres requis. Nous vous suggérons de laisser cette page par défaut :

• Méthode d'inscription : entrez une méthode d'inscription de Moodle. (par défaut : enrol_lara_enrol_users);
• Méthode de désinscription : entrez une méthode de désinscription de Moodle. (par défaut : enrol_lara_unenrol_users);
• Correspondance des rôles : entrer, en format Json, les correspondances entre les rôles de Lära et les rôles de Moodle (par défaut : vide);
• Plugin d'authentification (auth) : saisissez la méthode d'authentification pour Moodle (par défaut : manual)
• Générer un mot de passe pour l'utilisateur : activer pour fair créer un mot de passe par défaut sur Moodle (par défaut : coché).

• Choix du connecteur : sélectionnez le connecteur Moodle à utiliser, il correspond à une catégorie de cours sur Moodle;
• Nom du cours * : définissez le nom du cours Moodle affiché sur Lära LMS;
• Code administratif : entrez un code administratif pour cet élément (facultatif). Les codes administratifs sont utilisés pour noter les versions des documents, par exemple, ou les versions des sondages. Seuls les administrateurs et formateurs voient ces codes; 
• Section : sélectionnez la section dans laquelle vous voulez créer l'élément;
• Présentation de l'élément : rédigez la présentation de votre élément (onglet « Informations » sur l'élément). Vous pouvez utiliser un gabarit à l'aide du bouton « Utiliser un gabarit »;
• Cours disponibles : sélectionnez un cours déjà existant sur Moodle pour cette catégorie de cours. Ce cours doit avoir été créé sur le Moodle du connecteur sélectionné et être associé à la catégorie de cours du connecteur. 
• Créer un nouveau cours : permet de créer un nouveau cours sur Moodle, à partir des propriété précédentes :

• Nom complet du cours : entrez un nom pour votre cours à créer sur Moodle. (Par défaut, le nom du cours Lära est utilisé);
• Nom abrégé du cours : entrez un nom court pour votre cours à créer sur Moodle. (Par défaut, le nom du cours Lära est utilisé);
• Date de début du cours : entrez la date de début du cours sur Moodle;
• Date de fin du cours : entrez la date de fin du cours sur Moodle;
• Résumé du cours : Entrez les résumé du cours qui sera affiché sur Moodle.

• Aucun suivi de complétion : l'élément est facultatif, il ne peut pas servir de prérequis ni conduire à la complétion automatique de la session;

• Depuis un connecteur externe : l'élément sera automatiquement complété lorsque le participant aura rempli les exigences définies sur le cours Moodle;
• Afficher la complétion aux participants : le pourcentage de complétion de l'élément sera affiché sur l'élément pour chaque participant;
• Nombre de points associés à cette activité : pondération facultative en « Points » de l'élément. Le participant peut cumuler des points et compléter sa session automatiquement lors de la cumulation de X nombre de points.

• Disponible après une date spécifique : entrez une date et une heure de début de la capacité à accéder au cours Moodle;
• Disponible jusqu'à une date spécifique : entrez une date et une heure de fin de la capacité à accéder au cours Moodle;

• Disponible à l'achèvement d'un ou de plusieurs éléments : sélectionnez, parmi les éléments de la session déjà créés qui possèdent une règle de complétion, un ou plusieurs éléments à avoir complétés pour accéder à l'élément « Connecteur Moodle ».

Note : dans notre exemple, les participants devront avoir complété l'élément « Vidéo sur les notions de base ».

Note : l'onglet « Notifications programmées » n'apparaît qu'une fois l'élément créé. Vous devez donc retourner dans les paramètres pour le consulter ou modifier les notifications.