Identity en access management
HoorayHR SailPoint koppeling: HoorayHR als gezaghebbende bron in SailPoint
Met een koppeling tussen HoorayHR en SailPoint wordt elke medewerker uit HoorayHR een identiteit in SailPoint, met entiteit, team, functie, teamleider als manager en de datums van het dienstverband. KoppelHet levert HoorayHR als volledig bestand aan een Delimited File-bron, zodat SailPoint toegang toekent bij de start en intrekt na het vertrek.
Wat de koppeling doet
Organisaties die HR in HoorayHR vastleggen en toegang met SailPoint besturen, hebben in SailPoint nog geen bron die HoorayHR kent. Identiteiten komen dan uit een handmatige export, waarin een einddatum of een teamwissel van vorige week ontbreekt.
- Een admin in HoorayHR maakt een API-sleutel met alleen leesscopes; in SailPoint komt een Delimited File-bron met een identity profile.
- KoppelHet leest alle medewerkers, contracten, teams en entiteiten en laat gevoelige velden direct vallen.
- KoppelHet schrijft één regel per medewerker, met het afgesproken team, de teamleider en de datums in een vaste notatie.
- SailPoint aggregeert het bestand en berekent met een transform de lifecycle state.
- Rollen en toegangsprofielen in SailPoint volgen team, entiteit en lifecycle state.
Waar je op let bij HoorayHR en SailPoint
- SailPoint heeft geen bron voor HoorayHR, en HoorayHR noemt geen koppeling met een IAM-systeem. KoppelHet levert de medewerkers als bestand aan een Delimited File-bron, die SailPoint als gezaghebbende bron kan gebruiken.
- De HoorayHR-API kent geen filter op wijzigingsdatum voor medewerkers, dus de koppeling leest altijd de hele lijst. Dat past bij een Delimited File-bron, die bij elke aggregatie alle accounts wil zien. KoppelHet schrijft het bestand daarom elke ronde volledig, zonder eigen wijzigingslogica.
- Een medewerker kan in HoorayHR in meer teams zitten, en een transform in SailPoint gebruikt van een meerwaardig attribuut alleen de eerste waarde. KoppelHet zet het afgesproken team als losse kolom voor de afdeling, en alle teams in een aparte meerwaardige kolom voor de rollen.
- SailPoint vindt een manager via manager correlation op een account in dezelfde bron. In HoorayHR heeft een team teamleiders, en een teamleider kan rechten over zichzelf hebben. KoppelHet zet de User Name van de teamleider in de kolom Manager Name, en kiest voor een teamleider van zijn eigen team een vaste andere bron, zodat niemand zijn eigen manager wordt.
- SailPoint eist bij elke identiteit een werkadres, maar controleert niet of het een zakelijk adres is. Het inlogadres in HoorayHR kan bij medewerkers zonder werkmail een privéadres zijn. KoppelHet controleert het domein en vult zo nodig een adres volgens de naamgevingsregel in.
- Een contract in HoorayHR heeft de status toekomstig, actief of inactief, en een medewerker heeft naast de startdatum een historische anciënniteitsdatum. KoppelHet levert de startdatum van het huidige dienstverband en de contractstatus als kolommen, zodat de transform een herintreder niet als lang in dienst ziet.
- Bij een inactief abonnement of een betalingsachterstand weigert HoorayHR elke aanvraag. KoppelHet laat dan het vorige bestand staan in plaats van een leeg bestand te leveren, zodat SailPoint niet alle identiteiten als vertrokken ziet.
Deze koppeling hoort ook bij in-, door- en uitstroom.
Hoe we het bouwen en beheren
- De koppeling draait op het KoppelHet platform, gehost in een datacenter in de EU.
- Elke synchronisatie en elke fout is zichtbaar in de functionele logging; bij een fout krijgt jullie beheerder een melding.
- Een mutatie die niet door kan, wordt niet half doorgezet maar klaargezet om opnieuw te proberen.
- KoppelHet is ISO 27001-gecertificeerd. Gegevens gaan versleuteld over en blijven niet langer op het platform dan nodig.
- Na livegang beheren wij de koppeling en passen we hem aan als jullie proces verandert.
- De koppeling past naast je bestaande integratielaag. Alleen de velden uit het ontwerp gaan over; het platform houdt geen eigen registratie bij.
Implementatie en prijs
Dit is geen app die je aanzet. We bouwen de koppeling voor jullie organisatie op ons platform, met bouwstenen die we steeds opnieuw gebruiken. Zo is het maatwerk, zonder dat we bij nul beginnen.
Een consultant bereidt de intake voor en analyseert beide systemen. Daarna leggen we de mapping en uitzonderingen per veld vast, testen we in de test- of acceptatieomgeving en gaan we live op een moment dat jij kiest. De kosten bestaan uit een eenmalig bedrag voor de inrichting en een maandbedrag voor platform, monitoring en beheer.
Veelgestelde vragen
Kan SailPoint HoorayHR niet zelf aanroepen?
De API-sleutel van HoorayHR handelt als een admin en ziet ook BSN en bankgegevens. Die sleutel houden we liever bij KoppelHet, dat alleen de nodige velden doorgeeft.
Welk team wordt de afdeling?
Dat spreken we in de intake af, bijvoorbeeld het team met een vaste naamcode of het eerste team uit een vaste lijst.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- HoorayHR via api.hoorayhr.io met een persoonlijke API-sleutel (pk_…, rol admin) als Bearer-token: GET /users (alleen filter op id; velden id, firstName, nickName, formattedLastName, email, jobTitle, entityId, teams, companyStartDate, companyEndDate, seniorityDate), /contracts (status ACTIVE, FUTURE, INACTIVE), /teams-information (teamLeadersIds, teamMembersIds) en /entities. 403 met INACTIVE_COMPANY of PAYMENT_OVERDUE stopt de ronde.
- SailPoint Identity Security Cloud met een Delimited File-bron als gezaghebbende bron (meerwaardige attributen ondersteund). Verplichte identity attributes uid (uniek over alle profielen), email (niet gevalideerd) en lastname; Manager Name met manager correlation; Lifecycle State via een transform op de datums en de contractstatus.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in HoorayHR | Veld in SailPoint | Toelichting |
|---|---|---|
id (HoorayHR) | uid (User Name) | |
email of naamgevingsregel | email (Work Email) | Nooit emailPrivate |
formattedLastName | lastname | |
nickName of firstName | firstname | |
Afgesproken team | Identity attribute afdeling | |
Alle teams | Meerwaardige kolom voor rollen | |
Teamleider van het afgesproken team | Manager Name | |
entityId (naam uit entities) | Identity attribute entiteit | |
companyStartDate, companyEndDate en contractstatus | Lifecycle State (via transform) |
Gerelateerd
HoorayHR → Active Directory
HoorayHR Active Directory koppeling: domeinaccount uit het personeelsdossier
ASHoorayHR → Arbodienst (SIVI)
HoorayHR arbodienst koppeling via SIVI: verzuimdossiers en hun fasen uit HoorayHR naar de arbodienst
HoorayHR → Microsoft Entra ID
HoorayHR Entra ID koppeling: Microsoft 365-account op de startdatum uit HoorayHR
HoorayHR → Google Workspace
HoorayHR Google Workspace koppeling: Google-account vanaf de indienstdatum