{"id":19504535,"url":"https://github.com/tools4everbv/helloid-conn-prov-source-caci-osiris","last_synced_at":"2026-05-13T08:32:09.344Z","repository":{"id":52305247,"uuid":"438324705","full_name":"Tools4everBV/HelloID-Conn-Prov-Source-Caci-Osiris","owner":"Tools4everBV","description":"Osiris - Source","archived":false,"fork":false,"pushed_at":"2024-06-18T07:38:08.000Z","size":42,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-01-08T10:44:56.641Z","etag":null,"topics":["edu","on-premises","provisioning","sis","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-12-14T16:31:59.000Z","updated_at":"2024-06-18T07:38:02.000Z","dependencies_parsed_at":"2024-11-10T22:28:14.053Z","dependency_job_id":null,"html_url":"https://github.com/Tools4everBV/HelloID-Conn-Prov-Source-Caci-Osiris","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-Caci-Osiris","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-Caci-Osiris/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-Caci-Osiris/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-Caci-Osiris/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tools4everBV","download_url":"https://codeload.github.com/Tools4everBV/HelloID-Conn-Prov-Source-Caci-Osiris/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240754371,"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":["edu","on-premises","provisioning","sis","source"],"created_at":"2024-11-10T22:26:10.846Z","updated_at":"2026-05-13T08:32:09.339Z","avatar_url":"https://github.com/Tools4everBV.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HelloID-Conn-Prov-Source-Caci-Osiris\n\n\u003e [!CAUTION]\n\u003e The customer must manually select the relevant data fields in Osiris. By default, all data is available, including BSN and other fields that we do not want to include in HelloID.\nMake sure to clearly communicate this to the customer, and always perform a preview of the data first to check if any unexpected fields are included.\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/osiris-logo.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  + [Remarks](#Remarks)\n- [Setup the connector](@Setup-The-Connector)\n- [Getting help](#Getting-help)\n- [HelloID Docs](#HelloID-docs)\n\n## Introduction\n\n_HelloID-Conn-Prov-Source-Caci-Osiris_ is a _source_ connector. Caci-Osiris provides a set of REST API's that allow you to programmatically interact with it's data. The HelloID connector uses the API endpoints listed in the table below.\n\n| Endpoint     | Description |\n| ------------ | ----------- |\n| /basis/student | Used to retrieve the students |\n| /generiek/student | Used to retrieve the student education information |\n| /generiek/student/zoek/ | Used to retrieve the student education information |\n\nWhen classes and groups needs to be included the additional API endpoint are necessary\n\n| Endpoint     | Description |\n| ------------ | ----------- |\n| /generiek/studentgroep | Used to retrieve the groups / classed education information |\n| /generiek/studentgroep/student | Used to retrieve the student from groups / classed education information |\n\n\n## Getting started\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 Caci Osiris. | Yes |\n| ApiKey     | The ApiKey to connector to Caci Osiris. ApiKeys are generated within the application. | Yes |\n| SchoolName | The name of the school for which the data will be fetched | Yes |\n| Limit      | The limit of students that will be fetched from Caci Osiris and imported in HelloID | Yes |\n| Isdebug    | When toggled, debug logging will be displayed | No |\n\n### Prerequisites\n\n- [ ] Enable the webservices\n\n### Remarks\n\n\n\n#### Rate limiting\n\nCurrently the _HelloID-Conn-Prov-Source-Caci-Osiris_ connector works as follows:\n\n1. First retrieve all students from Caci Osiris using a `GET /studenten`.\n2. For each student; we have to do a `GET /studenten/studentNummer` to get a 'so called' `richStudent` object containing information about the educations.\n\nSo, if an organization has a large number of students, a lot of API calls will have to be made. \n\nThe Caci Osiris API is rate limited to a max of 50 requests per second. Therefore; \n\n1. First we retrieve all students and store them in the `$responseStudents` object.\n\n```powershell\n  $responseStudents = Invoke-RestMethod @splatParam\n```\n\n2. For each individual student we will fetch the `richStudentData` data from Caci Osiris with a 1 second interval between each batch.\n\n```powershell\n  $persons | ForEach-Object {\n    $splatGetAdditionalStudentdataParams = @{\n        Uri     = \"$($config.BaseUrl)/basis/student?p_studentnummer=$($_.studentnummer)\"\n        Headers = $headers\n        Method  = 'GET'\n    }\n    $responseAdditionalStudentdata = Invoke-RestMethod @splatGetRichStudentParams -Verbose:$false\n    ...\n    Start-Sleep -Seconds 20\n  }\n```\n\n## Setup the connector\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\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-source-caci-osiris","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-source-caci-osiris","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-source-caci-osiris/lists"}