Prerequisites
Before getting started, make sure you can find all of the following elements in the Cobra dashboard. These are required to continue with the setup.
-
In the sidebar: Cobra Enterprise Beheer > Configuration > Cobra services
-
In the Cobra services section: Cobra API
Step by Step Instructions
Step 1 - Find API URL
This step assumes that you have already navigated to the Cobra API service as documented in the prerequisites above.
-
Switch to the Roles tab of the Cobra API service
-
Copy the Api URL and paste it into the API URL field of the connection flow and click Continue.
Step 2 - Create a API Client
-
Click on Cobra API client toevoegen
-
Enter a name for the integration (you can copy this from the connection flow) and click on Client secret aanmaken
-
Copy the values in the Client-Identifier and Client-secret fields and paste them into the connection flow's Client ID and Client Secret fields. Then, click Continue again
Step 3 - Assign the Required Permissions
Tick the required permissions as displayed below.
| Field | Permission |
|---|---|
| CompanyCostCenter | GET |
| CurrentEmployment | GET |
| Department | GET |
| Email* | GET |
| EmploymentHistory | GET |
| Group | GET |
| GroupParticipant | GET |
| Location | GET |
| Person | GET |
| PersonSalary | GET |
*Not required for anonymous flow
-
After ticking the required permission, click on the Save button in the popup in SD Worx.
-
Click on Set up integration in the connection flow
-
If there is an error, you might have misconfigured the permissions or submitted invalid credentials. You can always edit the permissions for the integration in SD Worx and try clicking the Set up integration button again.