Dans Alma nous gérons deux typologies de comtes :
- des comptes externes pour des individus membres de nos institutions
- des comptes internes pour des individus extérieurs à nos bibliothèques ou des comptes relatifs aux bibliothèques emprunteuses du PEB.
A chaque type de compte correspond un circuit et un mode de gestion.
| Compte externe | Compte interne | |
|---|---|---|
| « Cat. de poste » concernée | Personnel,Personnel hébergé,Étudiant, Professionnel | Lecteur extérieur, Bibliothèque PEB |
| Source des données | Système d’information (SI) des établissements (SI RH, Annuaire LDAP et SI scolarité) | Saisie dans le système par les bibliothécaires |
| Instance d’entrée des données | Zone réseau (SIS loader) | Zone institutionnel |
| Mode d’authentification du lecteur | SAML (Système d’authentification des établissements) | Service d’identité d’Exlibris |
| Le compte peut-il être modifié par les bibliothécaires | Non. Les modifications doivent redescendre du SI de l’établissement. | Oui. |
Circuit des données de comptes externes
Les comptes externes sont chargés chaque nuit dans la zone réseau à partir d’extractions des données fournis par les DSI. Dès que le compte est créé dans la zone réseau il est automatiquement copié dans les institutions.
1. Extraction des données par la DSI
2. Serveur SFTP DSI UB
Le serveur est configuré dans la Zone réseau (NZ) sous Configuration>Général>Systèmes externes>Définitions S/FTP. Le nom du serveur est depot.u-bordeaux.fr. Déclarer le répertoire Dépôt comme le répertoire racine du serveur.
Attention ! : Si vous travaillez dans le bac à sable il est nécessaire d’autoriser le serveur dans Configuration>Général>Systèmes externes>Connexions S/FTP autorisées. Il est nécessaire de redéfinir ces autorisations après chaque mise à jour des bacs à sable.
3. Le chargeur des lecteurs : profil d’intégration Student information system ou SIS Loader
Le SIS Loader est configuré dans la NZ Configuration>Général>Systèmes externes>Profils d’intégration>Student information system
Seul la parie SYNCHRONISER est à configurer :
- Active : Actif (Profil acctivé ou désactivé)
- Type de notice : Public
- Correspondance sur : Identifiant principale (clef de recouvrement. Chez nous l’EPPN)
- Notice sans correspondance : Ajouter (Autoriser ou non le job à créer des comptes)
- Planification : Tous les jours 5h
A noter ! : Dans la section IMPORTER vous pouvez générer un échantillon (1.) sur la base d’un compte lecteur existant. Ziper le fichier ainsi obtenu avant de le déposer sur le serveur FTP puis exécuter le profil de synchronisation (2.).
4. Envoi des informations lecteurs : configuration du webhook
Le webhook va permettre de déclencher une requête HTTPS vers le serveur web du SCOOP à chaque modification d’un compte lecteur Étudiant ou Personnel. Les données du lecteur accompagnent la requête POST.
Pour en savoir plus sur les webhooks
Le webhook est configuré via le profil d’intégration WEBHOOKS_UTILISATEURS situé dans la Zone réseau. Configuration>Général>Systèmes externes>Profils d’intégration>WEBHOOKS_UTILISATEURS
- Url de l’interlocuteur : https://scoop.u-bordeaux.fr/lecteurs/
- Secret : la clef est stocké dans une variable d’environnement Apache sur le serveur (/etc/apache2/envvars)
- Abonnement : on n’écoute les modifications des seuls comptes utilisateurs. On filtre en plus les lecteurs sur les groupes utilisateurs relatifs aux comptes institutionnels
A noter : A partir de la liste des profils d’intégration. Vous pouvez accéder à la liste des logs en cliquant sur …>Consulter la trace
5. Distribution des comptes dans les institutions
cf. https://github.com/louxfaure/gestions_lecteurs
Circuit des données des comptes internes
Les comptes relatifs aux lecteurs extérieurs et aux bibliothèques emprunteuses du PEB sont créés ou modifiés manuellement par les bibliothécaires dans l’institution où ces derniers travaillent. Grâce au webhook et à un programme maison les créations ou modification sont immédiatement distribuées dans les institutions.
Configuration des webhook
Les webhooks sont définis au niveau au niveau de chaque institution. Ils portent tous le même nom, pointent vers la même url et utilisent la même clef.
Configuration>Général>Systèmes externes>Profils d’intégration>WEBHOOKS_UTILISATEURS
Les comptes lecteurs sont filtrés sur les groupes utilisateurs PEB et Lecteur extérieur.
Programme de distribution des comptes
cf. https://github.com/louxfaure/gestions_lecteurs
Date de publication
Mis à jour le
Attention ! Certains établissements utilisent parfois de procédures complémentaires