Skip to main content

HelloID

Provisioning GitHub resources

The Tools4ever GitHub account contains source and target system connectors for use with HelloID's Provisioning module. These repository names start with HelloID-Conn-Prov-Source, or HelloID-Conn-Prov-Target, respectively. For example, HelloID-Conn-Prov-Source-AFAS-Profit. For more information on naming conventions, see Repo naming conventions.

Source system connectors

To see all available source system connectors, Add a source system in HelloID. The source connectors shown in this dialog box are imported from GitHub.

2023-08-29_10-04-38.jpg

Source system connectors include some or all of the following components:

Filename

Description

[root]\readme.md

Readme file describing the repository's functionality. Includes any relevant special instructions, limitations, or recommendations.

[root]\configuration.json

Input forms

[root]\persons.ps1

Persons import script

[root]\departments.ps1

Departments import script

[root]\personMapping.json

[root]\contractMapping.json

Persons/contracts Source mappings definitions

The checkmarks in the Create System dialog indicate which of these components are supported by the specific connector.

2023-08-29_14-25-25.jpg

The same source connectors can be found on GitHub; search for org:Tools4everBV topic:provisioning topic:source.

2022-12-02_14-15-40.jpg
2022-12-02_14-15-51.jpg

Target system connectors

To see all available target system connectors, search GitHub for org:Tools4everBV topic:provisioning topic:target. To add one, download the files; then Add a PowerShell v2 target system.

2022-12-02_14-16-39.jpg
2022-12-02_14-16-47.jpg

Tip

If GitHub doesn't include your target system (e.g., it is a proprietary system), start with HelloID-Conn-Prov-Target-V2-Template.

Target system connector repositories include some or all of the following components:

Filename

Description

[root]\readme.md

Readme file describing the repository's functionality. Includes any relevant special instructions, limitations, or recommendations.

[root]\create.ps1

[root]\enable.ps1

[root]\update.ps1

[root]\disable.ps1

[root]\delete.ps1

Account scripts

[root]\configuration.json

Input forms

[root]\entitlements.ps1

[root]\grantPermission.ps1

[root]\revokePermission.ps1

Retrieve permissions script and Separate permission scripts for Permissions