Guide d'autorisation HiBob : configurer et ajouter les identifiants dans BrynQ
Introduction
Ce guide explique comment configurer vos identifiants Hibob dans BrynQ pour une interface.
Veuillez consulter attentivement la documentation Hibob sur les autorisations : elle explique en détail le fonctionnement des paramètres d'autorisation de Hibob.
De manière générale, il est vivement recommandé de bien connaître les concepts de base des systèmes sous-jacents.
Ce guide se concentre sur les autorisations nécessaires pour une interface dans BrynQ et sur la saisie des identifiants dans BrynQ, plutôt que sur le fonctionnement de tous les paramètres dans Hibob.
Bon à savoir
Une mauvaise configuration des autorisations entraîne des données manquantes dans l'interface, car BrynQ n'a pas les droits nécessaires pour extraire (entièrement) les données.
Dans Hibob, l'actualisation de l'environnement sandbox entraîne la perte des utilisateurs de service et
des groupes d'autorisations : l'autorisation doit alors être reconfigurée.
La configuration des autorisations est généralement identique pour les environnements sandbox et production de Hibob. Veillez toutefois à indiquer correctement le statut 'test' dans BrynQ.
Guide
Étape 1 : créez un utilisateur de service dans Hibob et saisissez-le dans BrynQ.
1. Connectez-vous à Hibob (l'URL peut être différente pour la sandbox).
2. Accédez à 'System Settings'
3. Sous 'Integrations', trouvez 'Service users' et cliquez sur 'Manage'.
4. Créez un
nouvel utilisateur de service. Nous vous recommandons de lui donner un nom clair, par exemple “BrynQ Hibob Interface”.
5. Après avoir cliqué sur Create, une fenêtre
apparaît avec les identifiants : un ID et un Token.
Copiez
les identifiants dans les champs correspondants de la fenêtre d'autorisation Hibob
dans BrynQ. (Le nom de votre connexion est libre
).
).
Dans BrynQ, activez l'option 'Test Environment' si vous utilisez la sandbox de Hibob.
Vous êtes bloqué dans Hibob ? Consultez cette page.
Étape 2 : configurez le groupe d'autorisations dans Hibob pour donner à BrynQ accès aux bonnes données
Il est essentiel que les bonnes autorisations soient définies dans Hibob avant de commencer le développement, les tests et la mise en production. Si des données manquent, vérifiez toujours les autorisations dans Hibob.
Votre interface peut nécessiter d'autres autorisations. Ce guide décrit une configuration générale adaptée à la plupart des interfaces.
1A. La fenêtre de l'utilisateur de service est encore ouverte ? Cliquez sur le bouton “Go to permission groups” dans
la fenêtre de l'utilisateur de service.
Ensuite, choisissez "Create a new Permission Group" pour l'utilisateur de service que nous venons de créer.
1B. Vous avez fermé la fenêtre de l'utilisateur de service ? Accédez à "System
settings" > "Account" > "Permission groups".
Créez un nouveau groupe d'autorisations pour l'utilisateur de service que nous venons de créer.
3. Donnez au groupe un nom clair, par exemple “BrynQ HiBob Integration"
4. Sous Members, trouvez l'utilisateur de service que vous venez de créer.
Cochez la case correspondante, puis cliquez sur Apply.
Dans la fenêtre, cliquez sur Create, puis sur Confirm.
5. Le nouveau groupe d'autorisations s'ouvre et vous voyez les autorisations que vous pouvez
attribuer.
Il est essentiel de bien suivre la section suivante de ce guide.
6. Dans l'onglet Features, accordez toutes les autorisations pour les trois sections : ‘Advanced Analytics’, ‘Docs’ et ‘Time Off’.
Pour cela, cochez toutes les cases de ces trois sections, sauf celles marquées “Admin only”.
Vous pouvez identifier les autorisations réservées aux administrateurs en survolant la case :
une note indique alors que l'autorisation est restreinte.
7. Accédez à l'onglet 'People’s data' .
8. Sélectionnez Docs et attribuez tous les droits Shared Docs
9. Sous People, attribuez tous les View rights.
Pour lire la date de naissance dans les données personnelles, des droits de modification sont nécessaires
pour Personal.
11. Cliquez sur Save. Une fenêtre contextuelle s'affiche.
12. Cliquez sur Apply dans la fenêtre contextuelle.
Dépannage
1. BrynQ signale que des champs de données sont manquants ou renvoient des valeurs inattendues lors de l'appel de l'API HiBob
Assurez-vous que la connexion pointe vers la sandbox ou l'environnement de production prévu.
Vérifiez que les bons identifiants de l'utilisateur de service ont été saisis dans BrynQ.
Assurez-vous que l'utilisateur de service est affecté au bon groupe d'autorisations dans HiBob.
Vérifiez que le groupe d'autorisations dans HiBob contient toutes les autorisations décrites ci-dessus. Adaptez-les si votre interface nécessite davantage d'autorisations.
Dans certains cas, certains champs n'apparaissent que si l'utilisateur de service dispose de droits de modification plutôt que de droits de lecture.
2. Des champs renvoient des valeurs 'null' alors que des données sont affichées dans HiBob
- Vérifiez que le champ a été renseigné
Assurez-vous que le champ est réellement rempli dans HiBob. - Vérifiez que le champ n'a pas été renommé
Un champ renommé peut ne plus correspondre à ce que BrynQ recherche. - Vérifiez que le champ 'standard' n'a pas été remplacé par un champ personnalisé
Si c'est le cas :
- Solution recommandée : déplacez les données du champ personnalisé vers le champ standard dans HiBob.
- Alternative (si c'est inévitable) : supprimez le champ standard du template BrynQ et remplacez-le par le champ personnalisé correspondant.