HiBob-autorisatiegids: inloggegevens instellen en toevoegen in BrynQ
Introductie
In deze gids lees je hoe je je Hibob-inloggegevens in BrynQ instelt voor een interface.
Bestudeer zeker de Hibob-documentatie over rechten. Daarin zie je precies hoe de rechteninstellingen van Hibob werken.
Over het algemeen raden we sterk aan om bekend te zijn met de basisprincipes van de onderliggende systemen.
In deze gids richten we ons op welke rechten nodig zijn voor een interface in BrynQ en hoe je de inloggegevens in BrynQ invoert, en niet op hoe alle instellingen in Hibob zelf werken.
Goed om te weten
Verkeerd ingestelde rechten leiden tot ontbrekende data in de interface, omdat BrynQ dan niet de rechten heeft om de data (volledig) op te halen.
In Hibob gaan bij het verversen van de sandboxomgeving de service users en
rechtengroepen verloren. De autorisatie moet dan opnieuw worden ingesteld.
Het instellen van rechten werkt over het algemeen hetzelfde voor de sandbox- en de live-omgeving van Hibob. Zorg wel dat je de 'test'-status correct aangeeft in BrynQ.
Stappenplan
Stap 1: Maak een service user aan in Hibob en voer deze in BrynQ in.
1. Log in bij Hibob (de url kan voor de sandbox afwijken).
2. Ga naar 'System Settings'
3. Zoek onder 'Integrations' naar 'Service users' en klik op 'Manage'.
4. Maak een
nieuwe service user aan. We raden aan een duidelijke naam te kiezen, zoals “BrynQ Hibob Interface”.
5. Nadat je op Create hebt geklikt, verschijnt er een venster
met de inloggegevens: een ID en een Token.
Kopieer
de inloggegevens naar de bijbehorende velden in het Hibob-autorisatievenster
in BrynQ. (De naam van je verbinding mag je zelf kiezen
).
).
Zet in BrynQ de optie 'Test Environment' aan als je de sandbox van Hibob gebruikt.
Loop je vast in Hibob? Raadpleeg dan deze pagina.
Stap 2: Stel de rechtengroep in Hibob in om BrynQ toegang te geven tot de juiste data
Het is cruciaal dat de juiste rechten in Hibob zijn ingesteld voordat ontwikkeling, testen en livegang kunnen starten. Ontbreekt er data? Controleer dan altijd de rechten in Hibob.
Jouw specifieke interface kan andere rechten nodig hebben. Deze gids beschrijft een algemene inrichting die voor de meeste interfaces geschikt is.
1A. Is het service user-venster nog open? Klik op de knop “Go to permission groups” in
het service user-venster.
Kies daarna "Create a new Permission Group" voor de service user die we zojuist hebben aangemaakt.
1B. Heb je het service user-venster gesloten? Ga naar "System
settings" > "Account" > "Permission groups".
Maak een nieuwe rechtengroep aan voor de service user die we zojuist hebben aangemaakt.
3. Geef de groep een duidelijke naam, zoals “BrynQ HiBob Integration"
4. Zoek onder Members de service user die je zojuist hebt aangemaakt.
Vink het bijbehorende vakje aan en klik op Apply.
Klik in het venster op Create en daarna op Confirm.
5. De nieuwe rechtengroep wordt geopend en je ziet de rechten die je kunt
toekennen.
Het is cruciaal dat je het volgende deel van de gids goed uitvoert.
6. Geef op het tabblad Features alle rechten voor de drie onderdelen: ‘Advanced Analytics’, ‘Docs’ en ‘Time Off’.
Vink hiervoor elk vakje onder deze drie onderdelen aan, behalve de vakjes die gemarkeerd zijn als “Admin only”.
Je herkent admin-only rechten door met de muis over het vakje te gaan.
Er verschijnt dan een melding dat het recht beperkt is.
7. Ga naar het tabblad 'People’s data' .
8. Selecteer Docs en ken alle Shared Docs-rechten toe
9. Ken onder People alle View rights toe.
Om de geboortedatum uit de persoonsgegevens te kunnen lezen, zijn bewerkrechten nodig
voor Personal.
11. Klik op Save. Er verschijnt een pop-up.
12. Klik in de pop-up op Apply.
Problemen oplossen
1. BrynQ meldt dat datavelden ontbreken of onverwachte waarden teruggeven bij het aanroepen van de HiBob API
Zorg dat de verbinding naar de bedoelde sandbox- of productieomgeving wijst.
Controleer of de juiste inloggegevens van de service user in BrynQ zijn ingevoerd.
Zorg dat de service user in HiBob aan de juiste rechtengroep is gekoppeld.
Controleer of de rechtengroep in HiBob alle hierboven beschreven rechten bevat. Pas deze zo nodig aan als je interface meer rechten nodig heeft.
In sommige gevallen verschijnen bepaalde velden alleen als de service user bewerkrechten heeft in plaats van leesrechten.
2. Velden geven 'null'-waarden terug, terwijl er wel data in HiBob staat
- Controleer of het veld is ingevuld
Controleer of het veld in HiBob daadwerkelijk gevuld is. - Controleer of het veld niet is hernoemd
Een hernoemd veld komt mogelijk niet meer overeen met wat BrynQ zoekt. - Controleer of het 'standaard'-veld niet is vervangen door een custom field
Als dat zo is:
- Voorkeursoplossing: Verplaats de data van het custom field naar het standaardveld in HiBob.
- Alternatief (als het niet anders kan): Verwijder het standaardveld uit de BrynQ-template en vervang het door het bijbehorende custom field.