Introduction

The Tools4ever GitHub account contains resources for use with HelloID's Provisioning module. Currently, it contains only one type of resource:

• Provisioning source and target systems (aka connectors)

Each repository comprises a set of PowerShell scripts and JSON files. For more information on these files, see GitHub Resources - Introduction.

This article demonstrates how to set up both source and target system connectors.

Provisioning connectors

These repository names start with HelloID-Conn-Prov-Source, or HelloID-Conn-Prov-Target, depending on whether the repository pertains to a custom PowerShell source system or a custom PowerShell target system. For example, HelloID-Conn-Prov-Source-AFAS-Profit.

For more information on naming conventions, see GitHub Resources - Introduction.

Set up a connector

1. Create and minimally configure a new PowerShell source system or target system. Use the instructions in Configure a custom PowerShell source system or Configure a custom PowerShell target system as a reference.
2. Download all files from the GitHub repository, and copy/paste their content as follows to finish configuring your new source or target system. Note that some repositories only contain (and require) a subset of these files. Some repositories may also contain additional files, in which case they are described in the repository's readme.
3. When finished, follow any other instructions in the repository's readme. There may be additional system-specific steps.

Source systems

• configuration.json
  System tab > Custom connector configuration > Wrench button
  
  
• persons.ps1
  System tab > PowerShell Script (Persons)
  
• departments.ps1
  System tab > PowerShell Script (Departments)
  
• personMapping.ps1
  Person tab > Import button
  
  
• contractMapping.ps1
  Contract tab > Import button
  
  

Target systems

• configuration.json
  Account tab > Custom connector configuration > Wrench button
  
  
• create.ps1, delete,ps1, disable.ps1, enable.ps1, update.ps1
  Account tab > Respective buttons
  
  
• entitlements.ps1
  Permissions tab > Entitlements > Configure button
  
  
  
• grantPermission.ps1
  Permissions tab > Permission grant > Configure button
  
  
• revokePermission.ps1