{"id":19504576,"url":"https://github.com/tools4everbv/helloid-conn-prov-source-sdworx","last_synced_at":"2026-04-16T09:39:24.941Z","repository":{"id":113208854,"uuid":"308569419","full_name":"Tools4everBV/HelloID-Conn-Prov-Source-SDworx","owner":"Tools4everBV","description":"SDworx Cobra HRM - Source","archived":false,"fork":false,"pushed_at":"2026-02-02T14:50:08.000Z","size":90,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-02-03T03:37:54.810Z","etag":null,"topics":["hrm","on-premises","provisioning","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":"CHANGELOG.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-10-30T08:30:55.000Z","updated_at":"2023-08-22T06:21:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"a58588ec-92ba-40d5-9cb5-414007e6c7db","html_url":"https://github.com/Tools4everBV/HelloID-Conn-Prov-Source-SDworx","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Tools4everBV/HelloID-Conn-Prov-Source-SDworx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-SDworx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-SDworx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-SDworx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-SDworx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tools4everBV","download_url":"https://codeload.github.com/Tools4everBV/HelloID-Conn-Prov-Source-SDworx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-SDworx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31880868,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T09:23:21.276Z","status":"ssl_error","status_checked_at":"2026-04-16T09:23:15.028Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["hrm","on-premises","provisioning","source"],"created_at":"2024-11-10T22:26:17.578Z","updated_at":"2026-04-16T09:39:24.928Z","avatar_url":"https://github.com/Tools4everBV.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HelloID-Conn-Prov-Source-SDworx\n\n#### ⚠️ BREAKING CHANGE IN V2.0.0\n\u003e [!CAUTION]\n\u003e The `ExternalID` in `persons.ps1` is changed from `person.ID` to `person.PersonNumber`. This is a breaking change!\n\u003e The `ExternalID` used in the mapping now matches the `ExternalID` returned by the `persons.ps1` script. This ensures consistency between your mapping configuration and the data returned by the script.  \n\n\u003e [!IMPORTANT]  \n\u003e 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\u003cp align=\"center\"\u003e \n  \u003cimg src=\"https://github.com/Tools4everBV/HelloID-Conn-Prov-Source-SDworx/blob/main/Logo.png?raw=true\"\u003e\n\u003c/p\u003e\n\n## Introduction\nHelloID-Conn-Prov-Source-SDworx is a source connector. SDworx cobra provides a set of REST API's that allow you to programmatically interact with its data.\n\n## Getting Started\n### Requirements\n- HelloID Provisioning agent (cloud or on-prem).\n- Connection settings\n- Authorization on the required endpoints\n\n\u003e [!NOTE]  \n\u003e The required endpoints depend on the configuration and requirements.\n\n### Connection settings\n\nThe following settings are required to connect to the API.\n\n| Setting        | Description                                                                             | Mandatory |\n| -------------- | --------------------------------------------------------------------------------------- | --------- |\n| BaseUrl        | The URL to the SDworx cobra environment                                                 | Yes       |\n| ClientID       | ClientID for authorization                                                              | Yes       |\n| Apikey         | Apikey for authorization                                                                | Yes       |\n| HistoricalDays | The number of days in the past from which the contracts will be imported (default 90)   | Yes       |\n| FutureDays     | The number of days in the future from which the contracts will be imported (default 90) | Yes       |\n\n## Remarks\n\n- All persons are retrieved from SDworx Cobra. For this reason only persons with an contract are returned to HelloID.\n- In `person.ps1`, phone numbers can be split by type. The default types currently used are **Work Phone** and **Mobile**.\n- For email addresses, the email type (work / private) is not provided. Therefore, filtering is applied based on `index` **1** and **2**. As the index order is not consistent, it is possible that a private email address is mapped as a work email.\n- Some endpoints are commented out in the `person.ps1` script. Adjust the script according to your requirements to enable or disable these endpoints.\n\n## Development resources\n\n### API endpoints\n\nThe following endpoints are used by the connector\n\n| Endpoint                    | Description                                                                  |\n| --------------------------- | ---------------------------------------------------------------------------- |\n| /OAuth/Token                | Retrieve OAuth access token                                                  |\n| /odata/Person               | Retrieve personal details                                                    |\n| /odata/CurrentEmployment    | Retrieve current employment information                                      |\n| /odata/EmploymentHistory    | Retrieve employment history                                                  |\n| /odata/Organization         | Retrieve organization information                                            |\n| /odata/Phone                | Retrieve phone number information                                            |\n| /odata/Email                | Retrieve email address information                                           |\n| /odata/Department           | Retrieve department information                                              |\n| /odata/Address              | Retrieve address information *(disabled in the script by default)*           |\n| /odata/CostCenterAllocation | Retrieve cost center allocation *(disabled in the script by default)*        |\n| /odata/Group                | Retrieve group information *(disabled in the script by default)*             |\n| /odata/SalaryEmployment     | Retrieve salary employment information *(disabled in the script by default)* |\n| /odata/GroupParticipant     | Retrieve group participant information *(disabled in the script by default)* |\n\n### API documentation\n\n[API documentation](https://apihrafdeling.cobra.sdworx.com/Resources)\n\n## Getting help\n\n\u003e [!TIP]\n\u003e _For more information on how to configure a HelloID PowerShell connector, please refer to our [documentation](https://docs.helloid.com/en/provisioning/target-systems/powershell-v2-target-systems.html) pages_.\n\n\u003e [!TIP]\n\u003e  _If you need help, feel free to ask questions on our [forum](https://forum.helloid.com)_.\n\n## HelloID docs\n\nThe official HelloID documentation can be found at: https://docs.helloid.com/","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-source-sdworx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-source-sdworx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-source-sdworx/lists"}