{"id":19504704,"url":"https://github.com/tools4everbv/helloid-conn-prov-target-generic-scim","last_synced_at":"2026-05-16T19:05:33.145Z","repository":{"id":94206313,"uuid":"361694721","full_name":"Tools4everBV/HelloID-Conn-Prov-Target-Generic-Scim","owner":"Tools4everBV","description":"Generic-Scim - Target","archived":false,"fork":false,"pushed_at":"2024-01-15T15:18:13.000Z","size":91,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-01-08T10:45:17.622Z","etag":null,"topics":["dei","provisioning","scim","target"],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Tools4everBV.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-26T09:37:55.000Z","updated_at":"2023-05-10T14:53:49.000Z","dependencies_parsed_at":"2024-01-15T16:59:15.794Z","dependency_job_id":"4935e532-7aee-4c38-b300-3f96a3e546c3","html_url":"https://github.com/Tools4everBV/HelloID-Conn-Prov-Target-Generic-Scim","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Generic-Scim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Generic-Scim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Generic-Scim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Generic-Scim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tools4everBV","download_url":"https://codeload.github.com/Tools4everBV/HelloID-Conn-Prov-Target-Generic-Scim/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240754366,"owners_count":19852189,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dei","provisioning","scim","target"],"created_at":"2024-11-10T22:26:52.431Z","updated_at":"2026-05-16T19:05:33.140Z","avatar_url":"https://github.com/Tools4everBV.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HelloID-Conn-Prov-Target-Generic-Scim\n\n| :information_source: Information |\n|:---------------------------|\n| 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.       |\n\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://www.tools4ever.nl/connector-logos/scim-logo-2.png\"\u003e\n\u003c/p\u003e\n\n## Table of contents\n\n- [HelloID-Conn-Prov-Target-Generic-Scim](#helloid-conn-prov-target-connectorname)\n  - [Table of contents](#table-of-contents)\n  - [Introduction](#introduction)\n  - [Supported features](#supported-features)\n  - [Getting started](#getting-started)\n    - [HelloID Icon URL](#helloid-icon-url)\n    - [Requirements](#requirements)\n    - [Connection settings](#connection-settings)\n    - [Correlation configuration](#correlation-configuration)\n    - [Field mapping](#field-mapping)\n    - [Account Reference](#account-reference)\n  - [Remarks](#remarks)\n  - [Development resources](#development-resources)\n    - [API endpoints](#api-endpoints)\n    - [API documentation](#api-documentation)\n  - [Getting help](#getting-help)\n  - [HelloID docs](#helloid-docs)\n\n\n## Introduction\n\nThe _'HelloID-Conn-Prov-Target-Generic-Scim'_ connector is a working example target connector based on scim based API's. http://www.simplecloud.info. You can use this connector as a basis for applications using an API based on SCIM. The example connector uses OAuth for authentication. Before implementing this connector in your environment, make sure to check if OAUth is supported or if there's a different method of authentication.\n\n## Supported features\n\nThe following features are available:\n\n| Feature                                   | Supported | Actions                                 | Remarks           |\n| ----------------------------------------- | --------- | --------------------------------------- | ----------------- |\n| **Account Lifecycle**                     | ✅         | Create, Update, Enable, Disable, Delete |                   |\n| **Permissions\\Groups**                    | ✅         | Retrieve, Grant, Revoke                 | Static   |\n| **Resources**                             | ❌         | -                                       |                   |\n| **Entitlement Import: Accounts**          | ✅         | -                                       |                   |\n| **Entitlement Import: Permissions\\groups**       | ✅         | -                                       |                   |\n| **Governance Reconciliation Resolutions** | ✅      | -                                       |                   |\n\n\n## Getting started\n\n### HelloID Icon URL\nURL of the icon used for the HelloID Provisioning target system.\n```\nhttps://www.tools4ever.nl/connector-logos/scim-logo-2.png\n```\n\n### Requirements\n\n- When using the HelloID On-Premises agent, Windows PowerShell 5.1 must be installed.\n\n- When the connector needs to be modified, make sure to have installed VSCode/\n\n### Supported PowerShell versions\n\nThe connector is created for both Windows PowerShell 5.1 and PowerShell Core. This means that the connector can be executed in both cloud and on-premises using the HelloID Agent.\n\n\u003e Older versions of Windows PowerShell are not supported.\n\n### Connection settings\n\n| Setting     | Description |\n| ------------ | ----------- |\n| ClientID          | The ClientID for the SCIM API                      |\n| ClientSecret      | The ClientSecret for the SCIM API                  |\n| BaseUrl           | The Uri to the SCIM API. \u003chttp://some-api/scim\u003e|\n| TokenUrl          | The Uri to the Token generation endpoint. \u003chttp://some-api/oauth/token\u003e\n\n### Correlation configuration\n\nThe correlation configuration is used to specify which properties will be used to match an existing account within _{connectorName}_ to a person in _HelloID_.\n\nAs this is a template, below values are only an example, it may differ for specific implementations.\n\n| Setting                   | Value                             |\n| ------------------------- | --------------------------------- |\n| Enable correlation        | `True`                            |\n| Person correlation field  | `PersonContext.Person.ExternalId` |\n| Account correlation field | `ExternalId` \n\n                |\n\n\u003e [!TIP]\n\u003e _For more information on correlation, please refer to our correlation [documentation](https://docs.helloid.com/en/provisioning/target-systems/powershell-v2-target-systems/correlation.html) pages_.\n\n\n### Field mapping\n\nThe field mapping can be imported by using the _fieldMapping.json_ file.\n\n### Account Reference\n\nThe account reference is populated with the property `id` \n\n\n## Remarks\n- There is duplicate mapping logic in both the *create* and *update*. If you modify the field mapping, be sure to update both files accordingly.\n- In the *create* operation, all users are currently retrieved. In many cases, this can be optimized using a filter.  \n  If filtering is not possible and fetching all users takes too long, consider moving this logic to a resource script.\n\n## Setup the connector\n\n1. Make sure you have access to the scim based API for your application.\n\n2. Add a new 'Target System' to HelloID.\n\n3. On the _Account_ tab, click __Custom connector configuration__ and import the code from the _configuration.json_ file.\n\n4. Under __Account Create__ click __Configure__ and import the code from the _create.ps1_ file.\n\n5. Go to the _Configuration_ tab and fill in the required fields.\n\n\n## Development resources\n\n### API endpoints\n\nThe following endpoints are used by the connector\n\n| Endpoint | Description               |\n| -------- | ------------------------- |\n| GET /Users   | Retrieve user information, used in correlation and import |\n| GET /Users/{id} | Retrieve a specific user. used in update, enable,disable and delete |\n| POST /Users  | create an user |\n| PATCH /Users/{id} | update a specific user\n| GET /Groups     | Retrieve available groups. used in permissions.ps1, and import.ps1 |\n| PATCH /Groups   | add a member to a group |\n\n\n### API documentation\n\n\nhttps://scim.cloud/#Overview\n\n\n\n## Getting help\n\n\u003e _For more information on how to configure a HelloID PowerShell connector, please refer to our [documentation](https://docs.helloid.com/hc/en-us/articles/360012557600-Configure-a-custom-PowerShell-source-system) pages_\n\n## Contributing\n\nFind a bug or have an idea! Open an issue or submit a pull request!\n\n## HelloID Docs\n\nThe official HelloID documentation can be found at: https://docs.helloid.com/\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-generic-scim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-generic-scim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-generic-scim/lists"}