OIIdentity en access management
Visma Peple One Identity koppeling: Peple als HR-bron voor One Identity Manager via de CSV-connector
Met een koppeling tussen Visma Peple en One Identity Manager staan medewerkers, organisatie-eenheden en contracten uit Peple elke dag klaar in vaste bestanden, die de CSV-connector van One Identity Manager inleest. One Identity Manager maakt daarmee accounts en rechten aan, en ziet een vertrek of het einde van een vervanging op de datum uit Peple.
Wat de koppeling doet
Organisaties die Visma Peple voor HR gebruiken en One Identity Manager voor identity governance, houden medewerkers met contracten bij meer eenheden en invallers vaak met de hand bij.
- In Visma Connect krijgt KoppelHet een client met alleen de exportscopes voor medewerkers, contracten, organisatie-eenheden en vervangingen.
- We leggen samen de kolommen en sleutels van drie bestanden vast, en de map waar One Identity Manager ze leest.
- KoppelHet start de exports in Peple, haalt de bestanden op en schrijft de nieuwe set pas weg als alles binnen is.
- One Identity Manager leest de bestanden in één systeemverbinding, alleen-lezen, met de afdelingen eerst.
- Vertrekkers blijven met hun datum uit dienst in het bestand tot na de afgesproken termijn.
Waar je op let bij Visma Peple en One Identity
- Een medewerker kan in Peple contracten bij meer organisatie-eenheden hebben. Bij dubbele sleutels in één bestand kiest de CSV-connector naar instelling de eerste, de laatste, geen enkele regel of een foutmelding. KoppelHet levert daarom één medewerkerregel met het hoofdcontract, en alle contracten als aparte regels in een eigen bestand met een eigen sleutel.
- Organisatie-eenheden in Peple hebben een bovenliggende eenheid en eigen begin- en einddatums. De CSV-connector kan één kolom als pad in een hiërarchie lezen en laadt bovenliggende eenheden dan eerst. KoppelHet bouwt dat pad uit de bovenliggende eenheden en laat opgeheven eenheden weg.
- Peple heeft een aparte export voor vervangingen, met begin- en einddatum. KoppelHet zet een vervanging als regel in het contractbestand met die datums, zodat One Identity Manager een invaller rechten op de eenheid geeft zolang de vervanging loopt, ook als hij daar geen eigen contract heeft.
- Bij een bestand als bron kan One Identity Manager ontbrekende personen niet als openstaand markeren. Peple staat bovendien maar twee volledige exports per dag per onderdeel toe. KoppelHet laat vertrekkers daarom met hun einddatum staan en bouwt de volledige stand zelf bij uit incrementele exports, met één volledige controle per nacht.
- Op zaterdagavond weigert Peple exports voor onderhoud. KoppelHet schrijft een nieuwe set pas weg als alle Peple-exports binnen zijn, en laat anders de vorige set staan, zodat One Identity Manager nooit een half bestand leest en medewerkers als verdwenen ziet.
- De CSV-connector leest datums volgens de taal die bij de systeemverbinding is ingesteld. KoppelHet schrijft alle datums uit Peple als jaar-maand-dag, zodat het einde van een vervanging op 03-04 niet als 4 maart wordt gelezen.
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
Hoe wordt het contractbestand in One Identity Manager gebruikt?
Dat bepalen jullie in de mapping, bijvoorbeeld als extra afdelingslidmaatschap. Rollen per eenheid kunnen daarop draaien.
Komen BSN of privéadres in de bestanden?
Nee. De koppeling vraagt de scopes voor contact- en belastinggegevens niet aan.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Peple via de Visma.net HRM & Payroll Reporting API (Visma Connect client credentials) met scopes voor de exports van employees, contracts, organizationunits en employeereplacement (POST command, GET query op jobId); incrementeel met changeTimestampAfter; twee volledige refreshes per endpoint per tenant per 24 uur; 503 met Retry-After tijdens onderhoud. Geen exportcontactinformation of exporttaxinformation.
- One Identity Manager leest via de CSV-connector drie bestanden in één systeemverbinding (UTF-8, één kopregel, tekstbegrenzers), met een sleutelkolom per bestand, Hierarchical sort order op het afdelingspad, Uniqueness violation behavior op Throw error, Read-only access en Data import in de synchronisatiestap. Toegang tot de bestanden direct of via een remote connection server.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Visma Peple | Veld in One Identity | Toelichting |
|---|---|---|
Personeelsnummer | Sleutelkolom medewerkerbestand (PersonnelNumber) | |
Voornaam en achternaam volgens nameusage | FirstName en LastName | |
businessemailaddress | DefaultEmailAddress | |
functionname en orgunit (hoofdcontract) | Functie en primaire afdeling | |
orgunit met orgunitparentid | Afdelingspad (Hierarchical sort order) | |
Contracten en vervangingen per orgunit | Regel per toewijzing in het contractbestand | |
manageruserid | Personeelsnummer leidinggevende | |
Begin- en einddatum contract of vervanging | EntryDate en ExitDate (JJJJ-MM-DD) |
Gerelateerd
Visma Peple → Active Directory
Visma Peple Active Directory koppeling: accounts vanuit Peple HRM & Payroll
ASVisma Peple → Arbodienst (SIVI)
Visma Peple arbodienst koppeling via SIVI: ziek- en herstelmeldingen uit Peple naar de arbodienst
Visma Peple → Microsoft Entra ID
Visma Peple Entra ID koppeling: Microsoft-accounts vanuit Peple HRM & Payroll
Visma Peple → Exact Online
Visma Peple Exact Online koppeling: kostenplaatsen klaar in Exact en medewerkerswijzigingen op een werklijst