{"id":19504706,"url":"https://github.com/tools4everbv/helloid-conn-prov-source-generic-scim","last_synced_at":"2025-07-04T02:35:51.542Z","repository":{"id":94206292,"uuid":"361697673","full_name":"Tools4everBV/HelloID-Conn-Prov-Source-Generic-Scim","owner":"Tools4everBV","description":"Generic-Scim - Source","archived":false,"fork":false,"pushed_at":"2024-01-15T15:17:58.000Z","size":65,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-02-25T22:12:05.368Z","etag":null,"topics":["cloud","dei","provisioning","scim","source"],"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:48:06.000Z","updated_at":"2023-08-21T13:31:29.000Z","dependencies_parsed_at":"2024-01-15T16:59:04.322Z","dependency_job_id":"56209934-3bbe-4bd8-a545-ca039255d0ba","html_url":"https://github.com/Tools4everBV/HelloID-Conn-Prov-Source-Generic-Scim","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Tools4everBV/HelloID-Conn-Prov-Source-Generic-Scim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-Generic-Scim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-Generic-Scim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-Generic-Scim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-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-Source-Generic-Scim/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-Generic-Scim/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263434758,"owners_count":23466023,"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":["cloud","dei","provisioning","scim","source"],"created_at":"2024-11-10T22:26:52.449Z","updated_at":"2025-07-04T02:35:51.520Z","avatar_url":"https://github.com/Tools4everBV.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HelloID-Conn-Prov-Source-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\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- [Introduction](#Introduction)\n- [Getting started](#Getting-started)\n  + [Connection settings](#Connection-settings)\n  + [Prerequisites](#Prerequisites)\n  + [Contents](#Contents)\n  + [PowerShell functions](#PowerShell-functions)\n  + [Supported PowerShell versions](#Supported-PowerShell-versions)\n- [Setup the connector](#Setup-the-connector)\n- [Getting help](#Getting-help)\n- [Contributing](#Contributing)\n- [HelloID Docs](#HelloID-Docs)\n\n\n## Introduction\n\nThe _'HelloID-Conn-Prov-Source-Generic-Scim'_ connector is a working example source connector based on scim based API's. http://www.simplecloud.info.\n## Getting started\n\nThis connector is a working example for a scim based API.\n\n\u003e Although this is a working example, changes might have to be made according to your own environment.\n\nBefore implementing the connector in HelloID, make sure to test the connector in VSCode.\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| Uri               | The Uri to the SCIM API. \u003chttp://some-api/v1/scim\u003e |\n|             |                                            |\n\n### Prerequisites\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/PowerShell extension.\n\n### Contents\n\n| Files       | Description                                |\n| ----------- | ------------------------------------------ |\n| config.json | The configuration settings for HelloID                      |\n| persons.ps1  | The connector _persons_ file that retrieves the persons from the target system |\n| personMapping.json | A basic mapping for persons |\n|             |                                            |\n\n### PowerShell functions\n\nThe _persons.ps1_ file contains a few functions. All of which contain basic comment based help.\n\nThe functions that are available in version _1.0.0.0_:\n\n- Get-GenericScimUsers\n- Get-GenericScimOAuthToken\n- Invoke-GenericScimRestMethod\n- Select-GenericScimUserProperties\n- Resolve-HTTPError\n\nThe most important function is 'Select-GenericScimUserProperties'. This function is responsible for flattening out a user object with nested hash table's and / or array's to a flat object that can be imported in HelloID. This is also the function that will require editing when more attributes are required. At this point, only a few basic attributes are imported.\n\n### Supported PowerShell versions\n\nThe connector is created for both Windows PowerShell 5.1 and PowerShell Core 7.0.3. 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## Setup the PowerShell connector\n\n1. Make sure you have access to the scim based API for your application.\n\n2. Add a new 'Source System' to HelloID.\n\n3. On the _System_ tab, click __Custom connector configuration__ and import the code from the _configuration.json_ file.\n\n4. Copy and paste the code from _persons.ps1_ to the PowerShell script (persons) pane.\n\n5. Go to the _Configuration_ tab and fill in the required fields.\n\n![config](https://github.com/Tools4everBV/HelloID-Conn-Prov-Source-Generic-Scim/blob/main/assets/configuration.png)\n\n| Parameter         | Description                                                  |\n| ----------------- | ------------------------------------------------------------ |\n| ClientID          | The ClientID for the SCIM API                                |\n| ClientSecret      | The ClientSecret for the SCIM API                            |\n| Uri               | The Uri to the SCIM API. \u003chttp://some-api/v1/scim\u003e           |\n| IsConnectionTls12 | Enables TLS 1.2 (Only necessary when using Windows PowerShell 5.1)        |\n| PageSize          | The pagesize used for the SCIM endpoint. You will find this information within the API reference documentation |\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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-source-generic-scim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-source-generic-scim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-source-generic-scim/lists"}