• ☝️ Effets sur les fonctionnalités Elevo
• ⚙️ Connexion au serveur SFTP Elevo et dépôt de fichier
• 💪🏼 Algorithmes supportés
• 🧷 Format du fichier
• ➕ Champs additionnels et SFTP
• 💾 Synchronisation

Cette méthode de synchronisation automatique est la plus universelle car elle peut s'adapter à n'importe quel système de base utilisateurs.

Elevo peut fournir un accès unique et sécurisé pour votre entreprise au SFTP Elevo où il vous sera possible de déposer les fichiers d'export de manière automatisée. Elevo synchronisera automatiquement les utilisateurs sans aucune intervention de votre part.

💡 Note : La plupart des SIRH proposent directement une fonctionnalité d'export automatique et régulier de votre base utilisateurs avec dépôt du fichier sur un serveur distant sécurisé (SFTP). Renseignez-vous au près de votre prestataire pour plus d'informations.

Pour mettre en place cette synchronisation, contactez notre support@elevo.io avec les informations suivantes :

• un contact technique,
• le nom de votre solution (de laquelle seront synchronisés les utilisateurs),
• l’adresse ou la plage d’adresses IPs que vous utiliserez pour vous connecter à notre gateway,
• une clé publique SSH que vous utiliserez pour vous connecter.

Le support Elevo vous fournira ensuite :

• votre identifiant de connexion à notre serveur SFTP,
• notre clé GPG publique pour le chiffrement des fichiers avant dépôt (optionnel),
• la confirmation que Elevo est prêt à traiter les fichiers pour synchronisation.

☝️ Effets sur les fonctionnalités Elevo

La synchronisation automatique des utilisateurs entraîne la modification de certains comportements et fonctionnalités d'Elevo :

• Il n'est plus possible de modifier, depuis Elevo, les attributs des utilisateurs synchronisés,
• Les utilisateurs ajoutés à votre SIRH seront automatiquement ajoutés à Elevo,
• Les utilisateurs supprimés de votre SIRH seront automatiquement suspendus sur Elevo

⚙️ Connexion au serveur SFTP Elevo et dépôt de fichier

Le protocole utilisé est le SFTP (SSH File Transfer Protocol). Les sessions sont initiées par vous-même pour l’envoi et la réception des fichiers. Vous disposerez d'un compte dédié, sécurisé par une clé SSH que vous nous aurez fournie. Par ailleurs, il sera nécessaire de nous fournir la liste de vos adresses IP afin de les whitelister au niveau réseau.

Les détails de connexion au serveur SFTP (nom de domaine, port et nom d'utilisateur) vous seront fournis par le support@elevo.io. Une fois la connexion établie les fichiers doivent être déposés dans le dossier "/uploads/users"

💪🏼 Algorithmes supportés

🧷 Format du fichier

Vous trouverez sur ces liens les modèles de fichier à compléter : Excel, Google Sheet et CSV.

Contraintes

• Respecter le format CSV RFC 4180,
• Le standard CSV définit via RFC4180 interdit explicitement de terminer une ligne par une virgule, sinon cela est interprété comme l’existence d’une colonne additionnelle (section 2.4),
• Être encodé au format UTF-8,
• La première ligne doit définir les en-têtes des colonnes,
• Doit contenir toutes les colonnes obligatoires,
• Peut ne pas contenir les colonnes optionnelles,
• Les colonnes non reconnues seront ignorées,
• Les colonnes peuvent être dans n'importe quel ordre.

Nom du fichier

Le nom de fichier n'a pas d'incidence sur le traitement. Elevo traitera tous les fichiers entrants qui seront déposés dans le bon dossier du serveur SFTP.

Identifiant unique pour les utilisateurs

Pour rendre plus fiable le rapprochement des utilisateurs entre le fichier CSV et les utilisateurs dans l'espace Elevo, le fichier requiert une colonne obligatoire uniq_identifier. 

Pour cette colonne il est nécessaire de respecter les conditions ci-dessous :

• constance : le champ doit rester constant d'une synchronisation à l'autre,
• unicité stricte : chaque utilisateur doit avoir une valeur différente,
• valeur : cela peut être par exemple l'ID utilisateur interne utilisé par le système fournissant les données.

💡 Note : le uniq_identifier est une chaîne de caractères et non un champ numérique, ce qui signifie que les valeurs 1 et 001 sont considérées comme des valeurs différentes.

Colonnes du fichier CSV

➕ Champs additionnels et SFTP

Elevo permet l'ajout de champs additionnels dans le profil des utilisateurs (en savoir plus). Ces champs sont tout à fait compatibles et synchronisables avec le SFTP.

Il est pour cela nécessaire d'ajouter une colonne dans le fichier dédié. L'intitulé exact de la colonne (en-tête) vous sera transmis par notre équipe Support au moment de la création du champ car celui-ci dépend de l'intitulé que vous définissez.

💾 Synchronisation

1️⃣ Retrait des lignes ignorées

Si la colonne skip est définie alors toutes les lignes pour lesquels skip est évalué à "true" sont retirées.

2️⃣ Validation de l'unicité des utilisateurs

Une première validation est faite uniquement sur la colonne uniq_identifier. Si cette colonne contient des valeurs en doublon la synchronisation est annulée et un rapport d'erreur est envoyé.

3️⃣ Réconciliation des données du fichier et des utilisateurs Elevo

Elevo utilise la colonne d'unicité de l'étape 1 du fichier CSV pour la comparer avec les utilisateurs présents sur Elevo.

• Les utilisateurs présents sur Elevo mais non présents dans le fichier CSV seront désactivés sur Elevo,
• Les utilisateurs présents dans le fichier CSV  mais non présents sur Elevo seront créés sur Elevo à l'étape de synchronisation.

4️⃣ Synchronisation

La synchronisation s'effectue ligne par ligne.

Si une ligne n'est pas valide (données non valides), cette ligne sera ignorée et la synchronisation continuera sur les lignes suivantes. L'utilisateur en question sera marqué en "erreur de synchronisation" et aucun changement ne sera fait pour cet utilisateur.

En cas d'erreur, un rapport est envoyé par e-mail sur l'adresse communiquée.