SAP HCM logoActive Directory logo

Identity and access management

SAP HCM to Active Directory integration: domain accounts per personnel area from SAP HR

With an integration between SAP HCM and Active Directory, KoppelHet creates a domain account for a new employee from SAP HR in the OU of their personnel area, with organisational unit, job and manager. The leaving date from SAP is set on the account in advance as its expiry date, and on that day it is disabled.

What the integration does

Organisations that run SAP HCM on-premise and manage their own Active Directory often create accounts from a weekly list out of SAP. Transfers only reach the domain weeks later, and leavers' accounts stay active until the list has been processed.

  1. The SAP administrator sets up the sending of HR master data once to a small KoppelHet program in your own network.
  2. On a hiring action the program creates the account in the OU of the personnel area, disabled until the start date.
  3. A change in the organisational assignment moves the account and changes the groups on the start date.
  4. On a leaving action the program sets the expiry date straight away and disables the account on that date.
  5. Leavers' accounts go to a separate OU, so IT can hand over mailbox and files.
SAP HCM → KoppelHet → Active DirectorySOURCESAP HCMTARGETActive DirectoryKoppelHetmapping · logging · monitoringSAP HCM → KoppelHet → Active DirectorySOURCESAP HCMTARGETActive DirectoryKoppelHetmapping · logging · monitoring
Out: Domain account with personnel number · OU per personnel area · Organisational unit, job and manager · Security groups per organisational unit · Expiry date and disabling

What to watch for with SAP HCM and Active Directory

  • SAP HCM and Active Directory are both in your own network. The KoppelHet program receives the messages from SAP and carries out the changes in the domain; KoppelHet's platform supplies the rules and records every action. No connection from outside to inside is needed.
  • The personnel area in SAP usually indicates the site or installation. KoppelHet uses it to choose the OU, so group policy per location is right without IT moving accounts.
  • A leaving action is often recorded weeks ahead in SAP. KoppelHet sets the leaving date as the account's expiry date straight away, so it also stops if the program is not running that day.
  • SAP only sends the infotypes that changed. KoppelHet keeps the latest state per employee, so a change of just the name does not take the account out of its OU or groups.
  • With HR master data SAP always sends the base infotypes 0000 to 0003, even if only the organisational assignment changes. KoppelHet only uses what the domain needs from them, and address and bank details are not included in the sending to the program.
  • Not every employee at an installation works at a PC. Per personnel area or job we agree who gets a domain account, so no unused accounts are created.

This integration is also part of joiner, mover, leaver.

How we build and run it

  • The integration runs on the KoppelHet platform, hosted in a data centre in the EU.
  • Every sync and every error is visible in the functional log; on an error your administrator is notified.
  • A change that cannot go through is not half-applied but queued for another attempt.
  • KoppelHet is ISO 27001 certified. Data travels encrypted and stays on the platform no longer than needed.
  • After go-live we manage the integration and adjust it when your process changes.
  • The integration fits next to your existing integration layer. Only the fields in the design are transferred; the platform keeps no register of its own.

Implementation, architecture and compliance

Implementation and price

This is not an app you switch on. We build the integration for your organisation on our platform, with building blocks we reuse on every project. So it is custom work that does not start from scratch.

A consultant prepares the intake and analyses both systems. We then record the mapping and exceptions field by field, test in the test or acceptance environment and go live at a moment you choose. Costs are a one-off amount for the setup and a monthly amount for platform, monitoring and support.

Price indication · Complex

Leave your work email and you see the price indication right away.

We only use your address to follow up on your question about this integration.

Frequently asked questions

What does our SAP administrator need to do?

Set up the distribution model, partner profile and change pointers for HR master data once. We supply the specification.

Does this also work with Microsoft 365 only?

Yes, we build that integration too.

What about the GDPR?

You are the controller and KoppelHet is the processor, under a data processing agreement. The integration only uses the infotypes Active Directory needs.

Technical details for IT

For those who want to know how it works under the hood: APIs, fields and sources used.

  • SAP HCM sends HR master data through ALE with message type HRMD_A (IDocs), created by change pointers, with a distribution model and partner profile. Infotypes 0000 (actions, STAT2), 0001 (company code, personnel area, organisational unit, position) and 0002; key PERNR. A KoppelHet agent in the network receives the IDocs.
  • The same agent writes employeeID (at most 16 characters), sAMAccountName (at most 20 characters), userPrincipalName, mail, givenName, sn, displayName, title, department, company, physicalDeliveryOfficeName, manager and accountExpires in Active Directory, and moves accounts between OUs.

Which fields are transferred

The key fields. The full mapping is agreed per customer.

Field in SAP HCMField in Active DirectoryNotes
PERNR (personeelsnummer)employeeIDFixed key
Infotype 0002: roepnaam of voornaamgivenName
Infotype 0002: achternaamsn en displayName
NaamgevingsregelsAMAccountNameAt most 20 characters
NaamgevingsregeluserPrincipalName en mail
Infotype 0001: personeelsgebiedOU en physicalDeliveryOfficeName
Infotype 0001: organisatie-eenheiddepartment en groepen
Infotype 0001: functie of positietitle
Infotype 0001: bedrijfsnummercompany
Infotype 0000: uitdienstmaatregelaccountExpires en uitschakelen

Related

Which systems do you want to connect?

Tell us which systems you use and what should happen automatically. Together we define the smallest working solution, with a clear design and a quote before building.