Table des matières
- Que permet de faire le connecteur Snowflake RH ?
- Comment fonctionne le connecteur Snowflake RH ?
- Mise en place du connecteur
Que permet de faire le connecteur Snowflake RH ?
Le connecteur Snowflake RH permet de récupérer les collaborateurs depuis une vue ou une table métier hébergée dans Snowflake (par exemple une vue YOUZER_FULL exposant les données RH), puis de les importer automatiquement dans Youzer afin d'alimenter les utilisateurs et leurs attributs.
Ce connecteur s'adresse aux organisations souhaitant mettre en place une synchronisation directe avec Snowflake, sans avoir recours à des fichiers CSV ni à un agent local.
Il permet notamment de :
- Synchroniser les collaborateurs depuis Snowflake vers Youzer ;
- Mapper les colonnes retournées par une requête SQL vers les attributs utilisateurs Youzer (nom, prénom, identifiant, dates, manager, attributs personnalisés, etc.) ;
- Planifier des synchronisations automatiques, comme pour les autres connecteurs RH.
À noter
Ce connecteur permet uniquement de lire une source de données RH présente dans Snowflake.
Il ne gère pas le provisioning des comptes Snowflake des collaborateurs.
Comment fonctionne le connecteur Snowflake RH ?
Le connecteur interroge Snowflake via la Snowflake SQL API afin d'exécuter une requête SQL définie lors de la configuration. Les données retournées sont ensuite traitées par Youzer afin de créer ou mettre à jour les utilisateurs en appliquant les mappings RH configurés.
Prérequis
Pour fonctionner, le connecteur nécessite :
- Un compte Snowflake contenant une vue ou une table RH accessible ;
- Un utilisateur technique dédié (par exemple
SVC_YOUZER_PROD) ; - Une authentification par paire de clés RSA (JWT Key Pair) (aucun mot de passe n'est utilisé) ;
- Un Warehouse Snowflake autorisé à exécuter les requêtes ;
- Une requête SQL retournant les collaborateurs, utilisant un nom d'objet pleinement qualifié (
BASE.SCHEMA.OBJET).
Ce connecteur ne nécessite pas
Contrairement à d'autres méthodes d'import, ce connecteur ne nécessite pas :
- d'Advanced Agent Youzer ;
- de dépôt de fichiers CSV ;
- de configuration ODBC ou DSN ;
- de comptes Snowflake individuels pour chaque collaborateur.
Prérequis côté Snowflake (DBA)
Avant de configurer le connecteur dans Youzer, le DBA Snowflake doit mettre en place les éléments suivants :
- Enregistrer la clé publique RSA sur l'utilisateur technique ;
- Accorder le droit USAGE sur le Warehouse utilisé ;
- Accorder le droit SELECT sur la vue ou la table RH ;
- Définir un rôle par défaut adapté sur l'utilisateur technique (recommandé), sauf si un rôle est explicitement renseigné dans la configuration du connecteur.
Mise en place du connecteur
1. Ajouter le connecteur
Depuis le catalogue des connecteurs RH, ajoutez le connecteur Snowflake RH à votre instance Youzer.
2. Configurer l'authentification
Renseignez les informations suivantes :
| Champ | Description |
|---|---|
| Identifiant compte Snowflake | Identifiant du compte, sans le domaine .snowflakecomputing.com (exemple : xy12345.eu-west-1) |
| Utilisateur service | Utilisateur technique Snowflake (exemple : SVC_YOUZER_PROD) |
| Clé publique RSA (Base64) | Clé publique au format PKCS#8 encodée en Base64 |
| Clé privée RSA (Base64) | Contenu du fichier .p8 encodé en Base64 |
3. Configurer les paramètres avancés
Dans l'onglet Paramètres avancés, renseignez un objet JSON similaire à l'exemple ci-dessous :
{
"warehouse": "COMPUTE_WH",
"query": "SELECT * FROM REF_MAIN_PROD.PEOPLE.YOUZER_FULL",
"role": "ROLE_YOUZER_READ"
}Description des paramètres
| Clé | Obligatoire | Description |
|---|---|---|
warehouse |
✅ Oui | Warehouse Snowflake utilisé pour exécuter la requête SQL |
query |
✅ Oui | Requête SQL retournant les collaborateurs. L'objet doit être référencé avec son nom complet (BASE.SCHEMA.OBJET). |
role |
Non | Rôle Snowflake utilisé lors de l'exécution de la requête. À renseigner uniquement si l'utilisateur ne possède pas un rôle par défaut adapté. |
Important
La base de données et le schéma sont définis directement dans la requête SQL.
Il n'est donc pas nécessaire de renseigner séparément un champ Database ou Schema.
4. Configurer les mappings RH
Associez les colonnes retournées par la requête SQL aux attributs utilisateurs Youzer.
Les principaux attributs à mapper sont notamment :
- Référence du collaborateur (
ref_connecteur_rh) ; - Nom ;
- Prénom ;
- Date d'arrivée ;
- Date de départ ;
- Manager ;
- Attributs personnalisés.
Lors de la première synchronisation, Youzer peut proposer automatiquement des suggestions de mapping à partir des noms de colonnes retournés par la requête.
5. Planifier la synchronisation
Configurez la fréquence d'exécution du connecteur depuis les paramètres standards de planification de Youzer.
6. Vérifier la première synchronisation
Une fois le connecteur configuré, il est recommandé de vérifier les points suivants :
- La requête SQL retourne bien les collaborateurs attendus ;
- Le nombre d'utilisateurs importés est cohérent ;
- Les mappings (nom, prénom, identifiant, manager, dates, etc.) sont corrects.
En cas d'erreur d'authentification, vérifiez :
- la correspondance entre la clé publique et la clé privée ;
- l'identifiant du compte Snowflake ;
- l'utilisateur technique utilisé ;
- le Warehouse configuré ;
- les droits d'accès à la vue ou à la table RH.