Synchronisation utilisateur | MyQ X Server (Print Server)

La synchronisation utilisateur est une méthode permettant d’importer et de synchroniser périodiquement les données relatives aux utilisateurs de la base de données MyQ avec celles provenant de sources externes, telles que Microsoft Entra ID, des serveurs LDAP ou des fichiers CSV. L’importation de nouveaux utilisateurs est une étape facultative du processus de synchronisation. Dans la configuration de la synchronisation, vous pouvez activer ou désactiver l’importation de nouveaux utilisateurs ; si vous la désactivez, MyQ met uniquement à jour les comptes des utilisateurs déjà présents dans sa base de données.

Cette section fournit des informations détaillées sur la synchronisation. Elle décrit en détail les méthodes d’importation et de synchronisation disponibles dans MyQ et présente deux options pour exécuter les synchronisations :

Les mots de passe des utilisateurs ne sont ni synchronisés ni stockés dans la base de données MyQ dans le cas de synchronisations LDAP/MS Entra ID.

Quelles propriétés peuvent être synchronisées

Lorsque MyQ synchronise des utilisateurs à partir d’un service d’annuaire ou d’un fichier CSV, il mappe les attributs source aux propriétés utilisateur de MyQ. Toutes les propriétés utilisateur ne peuvent pas être renseignées par la synchronisation, et toutes les propriétés ne se comportent pas de la même manière selon les sources de synchronisation. Cette page récapitule les propriétés pouvant être synchronisées, leurs contraintes et les mappages d’attributs par défaut pour chaque type de source.

Propriété MyQ	Synchronisable	Contraintes
Nom d’utilisateur	Oui	Fixe selon le type de source : toujours `sAMAccountName` pour LDAP/AD, toujours `userPrincipalName` pour Entra ID (API Graph). Ne peut pas être modifié dans les paramètres de la source de synchronisation.
Nom complet	Oui	Aucune contrainte.
Alias	Oui	Plusieurs valeurs acceptées, séparées par des virgules. Permet de faire correspondre les travaux envoyés avec des identifiants autres que le nom d’utilisateur.
Numéro personnel	Oui	Doit être unique pour chaque utilisateur. Permet d’associer les utilisateurs entre les différentes sources.
Courriel	Oui	Aucune contrainte.
Adresses e-mail alternatives	Oui	Plusieurs valeurs acceptées, séparées par des virgules.
Téléphone	Non	Doit être saisi manuellement.
Service	Oui	Aucune contrainte.
Badges	Oui	Mode de synchronisation configurable : Ne pas synchroniser / Synchronisation complète / Synchroniser si le champ n’est pas vide / Ajouter de nouvelles données. Plusieurs valeurs acceptées, séparées par des virgules.
Code PIN	Oui	Mode de synchronisation configurable : mêmes options que pour les badges. Dans le fichier CSV, les codes PIN doivent être au format MD5 haché. Plusieurs valeurs sont acceptées, séparées par des virgules.
Langue par défaut	Oui	La valeur doit correspondre à l’abréviation d’une langue prise en charge, par exemple `en` ou `hr`.
Stockage de l’utilisateur	Oui	Aucune contrainte.
Remarques	Oui	Aucune contrainte.
Personnalisé (1-3)	Oui	Disponible pour les sources Entra ID (Graph API) et CSV. Permet de mapper tout attribut non couvert par les propriétés standard.
Utiliser le serveur d’authentification	Oui	À définir au niveau de la source de synchronisation – s’applique à tous les utilisateurs importés par cette source. Le mappage n’est pas effectué au cas par cas pour chaque utilisateur.
Source de synchronisation	Automatique	Définie par MyQ en fonction du nom de la source de synchronisation. Non configurable par utilisateur via la synchronisation.
Avancé (identité sur site)	Automatique	Rempli automatiquement pour les utilisateurs Entra ID hybrides à partir de `onPremisesSamAccountName` et `onPremisesDomainName`. Aucune configuration requise.

Mappages d’attributs par défaut par source

Lorsqu’un mappage par défaut existe, MyQ l’applique automatiquement. Les propriétés ne disposant pas de valeur par défaut doivent être configurées explicitement dans les paramètres de la source de synchronisation.

Active Directory (LDAP)

Propriété MyQ	Attribut AD par défaut	Remarques
Nom d’utilisateur	`sAMAccountName`	Fixe.
Nom complet	`cn`
Courriel	`mail`
Toutes les autres propriétés	(aucune)	Doit être configuré explicitement.

Propriétés couramment configurées explicitement :

Propriété MyQ	Attribut AD recommandé	Remarques
Alias	`userPrincipalName`	Effectuez le mappage ici si la détection du travail renvoie un UPN.
Alias	`mailNickname` ou `mail`	Effectuez le mappage ici si la détection des travaux renvoie des identifiants au format e-mail.
Numéro personnel	`employeeId`	Utile pour établir des correspondances entre les différentes sources.
Stockage de l’utilisateur	`HomeDrive`	Permet d’utiliser les fonctions Easy Print depuis / Easy Scan vers le dossier personnel de l’utilisateur.
Badge, code PIN	Personnalisé ou `extensionAttribute`	Vérifiez la protection des attributs confidentiels avant de l’activer.

Microsoft Entra ID (API Graph)

Propriété MyQ	Attribut par défaut	Remarques
Nom d’utilisateur	`userPrincipalName`	Fixe.
Nom complet	`displayName`
Courriel	`mail`
Langue	`preferredLanguage`
Département	`department`
Toutes les autres propriétés	(aucune)	Doit être configuré explicitement.

Les attributs disponibles pour le mappage explicite sont notamment : employeeId, mailNickname, upnPrefix, onPremisesSamAccountName, onPremisesDomainName et les attributs extensionAttribute1 à extensionAttribute15. Tout attribut de ressource utilisateur Entra ID peut également être saisi manuellement s’il ne figure pas dans la liste déroulante.

OpenLDAP

Propriété MyQ	Attribut par défaut	Remarques
Nom d’utilisateur	`uid`	Fixe.
Nom complet	`cn`
Courriel	`mail`
Toutes les autres propriétés	(aucune)	Doit être configuré explicitement. Le schéma varie selon l’installation – vérifiez les noms d’attributs dans votre annuaire.

Novell eDirectory

Aucun mappage par défaut. Toutes les propriétés doivent être configurées explicitement. Utilisez le navigateur LDAP dans l’onglet Général de la source de synchronisation pour identifier les noms d’attributs dans votre annuaire.

Google Workspace (LDAP sécurisé)

Propriété MyQ	Type d’attribut	Remarques
Nom d’utilisateur	`uid`
Nom complet	`cn`
Courriel	`mail`
Toutes les autres propriétés	(aucune)	Vérifiez les noms d’attributs par rapport à votre annuaire à l’aide du navigateur LDAP.

CSV

Toutes les propriétés sont mappées par nom de colonne (ou par position de colonne s’il n’y a pas de ligne d’en-tête).

Options du mode de synchronisation pour les badges et les codes PIN

Les modes de synchronisation suivants s’appliquent aux propriétés Badges et Code PIN pour tous les types de source qui les prennent en charge.

Mode	Comportement
Ne pas synchroniser	Les valeurs existantes dans MyQ ne sont pas modifiées.
Synchronisation complète	Les valeurs existantes sont remplacées par celles de la source, y compris par une valeur vide si la valeur source est vide.
Synchroniser si la valeur n’est pas vide	Les valeurs existantes ne sont remplacées que si la valeur source n’est pas vide. Paramètre par défaut pour les fichiers CSV.
Ajouter de nouvelles valeurs	Les nouvelles valeurs provenant de la source sont ajoutées sans remplacer celles qui existent déjà.

Voir également :