{"id":19504556,"url":"https://github.com/tools4everbv/helloid-conn-prov-target-smile","last_synced_at":"2025-07-15T14:04:07.291Z","repository":{"id":235187367,"uuid":"787266102","full_name":"Tools4everBV/HelloID-Conn-Prov-Target-Smile","owner":"Tools4everBV","description":null,"archived":false,"fork":false,"pushed_at":"2024-05-16T08:48:59.000Z","size":97,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-02-25T22:11:24.543Z","etag":null,"topics":["cloud","powershell","provisioning","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":"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}},"created_at":"2024-04-16T07:47:45.000Z","updated_at":"2024-05-16T08:47:34.000Z","dependencies_parsed_at":"2024-04-22T16:15:37.547Z","dependency_job_id":"e524e92e-0bab-48b2-804f-bbfbecafa7ef","html_url":"https://github.com/Tools4everBV/HelloID-Conn-Prov-Target-Smile","commit_stats":null,"previous_names":["tools4everbv/helloid-conn-prov-target-smile"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Tools4everBV/HelloID-Conn-Prov-Target-Smile","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Smile","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Smile/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Smile/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Smile/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tools4everBV","download_url":"https://codeload.github.com/Tools4everBV/HelloID-Conn-Prov-Target-Smile/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Smile/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265437773,"owners_count":23765132,"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","powershell","provisioning","target"],"created_at":"2024-11-10T22:26:13.343Z","updated_at":"2025-07-15T14:04:07.251Z","avatar_url":"https://github.com/Tools4everBV.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# HelloID-Conn-Prov-Target-Smile\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://ribwtest.smilesaas.eu/img/poweredbysmile.png\"\u003e\n\u003c/p\u003e\n\n## Table of contents\n\n- [HelloID-Conn-Prov-Target-Smile](#helloid-conn-prov-target-smile)\n  - [Table of contents](#table-of-contents)\n  - [Introduction](#introduction)\n  - [Getting started](#getting-started)\n      - [Field mapping](#field-mapping)\n    - [Connection settings](#connection-settings)\n    - [Endpoints](#endpoints)\n    - [Remarks](#remarks)\n      - [No validation if the user account exists](#no-validation-if-the-user-account-exists)\n      - [Minimal error handling within the webhook](#minimal-error-handling-within-the-webhook)\n      - [`POST` calls only](#post-calls-only)\n  - [Getting help](#getting-help)\n  - [HelloID docs](#helloid-docs)\n\n## Introduction\n\n_HelloID-Conn-Prov-Target-Smile_ is a provisioning PowerShell V2 _target_ connector. Unlike conventional APIs, _Smile_ provides a webhook that exclusively supports either a 'push' or 'HTTP.POST'.\n\nThe following resources are available:\n\n| Action             | Description                           |\n| ------------------ | ------------------------------------- |\n| create.ps1         | PowerShell _create_ lifecycle action  |\n| update.ps1         | PowerShell _update_ lifecycle action  |\n| disable.ps1        | PowerShell _disable_ lifecycle action |\n| enable.ps1         | PowerShell _enable_ lifecycle action  |\n| configuration.json | Default _configuration_               |\n| fieldMapping.json  | Default _fieldMapping                 |\n\n## Getting started\n\n#### Field mapping\n\nThe field mapping can be imported by using the _fieldMapping.json_ file.\n\n### Connection settings\n\nThe following settings are required to connect to the webhook.\n\n| Setting     | Description                           | Mandatory |\n| ----------- | ------------------------------------- | --------- |\n| BaseUrl     | The URL to the webhook                    | Yes       |\n| EnvGUID     | The EnvGUID to connect to the webhook     | Yes       |\n| WebhookGUID | The WebhookGUID to connect to the webhook | Yes       |\n| TenantGUID  | The TenantGUID to connect to the webhook  | Yes       |\n\n### Endpoints\n\nThe following endpoint is being used.\n\n| Endpoint                                                                                            |\n| --------------------------------------------------------------------------------------------------- |\n| https://__{TenantName}__.smilesaas.eu/api/webhook/__{EnvGUID}__/__{WebhookGUID}__/__{TenantGUID}__  |\n\n\u003e [!NOTE]\n\u003e Note that the __TenantName__ is not part of the configuration.\n\n### Remarks\n\n#### No validation if the user account exists\n\nBecause there's no _HTTP.GET_ available to retrieve an account, the _create_ lifecycle action will __always__ create the account. If the account already exists, it will be updated instead. If the user is successfully created or updated, you will get back a random number. The connector doesn't actually handle this number since it has no meaning.\n\nBecause there's no way to validate the existence of an account within _Smile_, the correlation configuration is not necessary.\n\n#### Minimal error handling within the webhook\n\nThe webhook does not return any error information. If something fails, you will only receive a generic HTTP error code.\n\n#### `POST` calls only\n\nOne important thing to note is that the request to create or update an account is _in both cases_ an _HTTP.POST_.\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/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-smile","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-smile","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-smile/lists"}