Skip to content

Tools4everBV/HelloID-Conn-Prov-Target-ActiveDirectory

Repository files navigation

HelloID-Conn-Prov-Target-ActiveDirectory

Important

This repository contains the connector and configuration code only. The implementer is responsible to acquire the connection details such as username, password, certificate, etc. You might even need to sign a contract or agreement with the supplier before implementing this connector. Please contact the client's application manager to coordinate the connector requirements.

Table of contents

Introduction

HelloID-Conn-Prov-Target-ActiveDirectory is a target connector. This connector is used to dynamically add Active Directory groups to Active Directory users by assigning subPermissions within HelloID.

The following lifecycle actions are available:

Action Description
create.ps1 PowerShell create lifecycle action. This action correlates the account
permissions/groups/subPermissions.ps1 PowerShell subPermissions lifecycle action
resources/groups/resources.ps1 PowerShell resources lifecycle action
configuration.json Default configuration.json
fieldMapping.json Default fieldMapping.json

Getting started

Provisioning PowerShell V2 connector

Correlation configuration

The correlation configuration is used to specify which properties will be used to match an existing account within ActiveDirectory to a person in HelloID.

Please rename the field mapping correlation field to the correlation field used in the dependent system. Most likely the built-in Microsoft Active Directory target system.

To properly setup the correlation:

  1. Open the Correlation tab.

  2. Specify the following configuration:

    Setting Value
    Enable correlation True
    Person correlation field PersonContext.Person.ExternalId
    Account correlation field employeeId

Tip

For more information on correlation, please refer to our correlation documentation pages.

Field mapping

The field mapping can be imported by using the fieldMapping.json file.

Connection settings

The following settings can be configured.

Setting Description Mandatory
Fixed domain controller Optionally fill in a domain controller if a fixed domain controller is required
Debug Creates extra logging for debug purposes

Prerequisites

The powershell ActiveDirectory module is required for this target connector.

Getting help

Tip

For more information on how to configure a HelloID PowerShell connector, please refer to our documentation pages.

Tip

If you need help, feel free to ask questions on our forum.

HelloID docs

The official HelloID documentation can be found at: https://docs.helloid.com/