# Evolution HR

Product: Managed Identity Services
Source: https://docs.fortytwo.io/managed-identity-services/hr-provisioning/hr-systems/evolution-hr/

## Required HR configuration

In order for Fortytwo to connect to the HR system, we require a **Client ID** and **Client secret** configured under API access, to access [this API](https://4human-api-doc-prod.s3.eu-west-1.amazonaws.com/prod/index.html#/). Please provide this to your Fortytwo contact during the initial phase of implementation.

## Schema used for attribute mapping

The service sends each employee as a standard SCIM representation to the Entra ID Inbound Provisioning API. The below is a full example of the payload we send, and can be used to define attribute mapping in the customer tenant:

```json
{
  "displayName": "Alma Nakken",
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
    "department": null,
    "manager": {
      "value": "2"
    },
    "employeeNumber": "1",
    "organization": "Company Inc",
    "division": "HR"
  },
  "urn:ietf:params:scim:schemas:extension:fortytwo:1.0:User": {
    "enddate": null,
    "jobtitleid": 17,
    "orglevel0id": "197",
    "orglevel0name": "Company Inc",
    "orglevel1id": "187",
    "orglevel1name": "HR",
    "orglevel2id": null,
    "orglevel2name": null,
    "orglevel3id": null,
    "orglevel3name": null,
    "orglevel4id": null,
    "orglevel4name": null,
    "orglevelids": [
        "197",
        "187"
    ],
    "raw": null,
    "ssn": null,
    "startdate": null
  },
  "name": {
    "familyName": "Nakken",
    "givenName": "Alma"
  },
  "phoneNumbers": [
    {
      "type": "mobile",
      "value": "+4799999999"
    }
  ],
  "externalid": "1",
  "active": true,
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User",
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User",
    "urn:ietf:params:scim:schemas:extension:fortytwo:1.0:User"
  ],
  "title": "HR Consultant",
  "addresses": [
    {
      "primary": true,
      "type": "work",
      "region": "Oslo",
      "postalCode": "0862",
      "locality": "Oslo",
      "streetAddress": "Folke bernadottes vei 9A",
      "country": "NOR"
    }
  ]
}
```

| SCIM attribute                                                            | HR source object              | HR source attribute                                      |
|---------------------------------------------------------------------------|-------------------------------|----------------------------------------------------------|
| externalid                                                                | Employment                    | employeeid                                               |
| displayName                                                               | Employment                    | user.name                                                |
| title                                                                     | Employment                    | job.title                                                |
| name.familyName                                                           | UserProfile                   | surname                                                  |
| name.givenName                                                            | UserProfile                   | firstName                                                |
| phoneNumbers[type eq "mobile"].value                                      | UserProfile                   | workContactDetails.contactInfo.mobilePhone               |
| active                                                                    | Employment                    | firstWorkingDay, lastWorkingDay                          |
| addresses[type eq "work"].streetAddress                                   | UserProfile                   | workContactDetails.addressInfo.visitAddress.address      |
| addresses[type eq "work"].locality                                        | UserProfile                   | workContactDetails.addressInfo.visitAddress.city         |
| addresses[type eq "work"].region                                          | UserProfile                   | workContactDetails.addressInfo.visitAddress.municipality |
| addresses[type eq "work"].postalCode                                      | UserProfile                   | workContactDetails.addressInfo.visitAddress.zipCode      |
| addresses[type eq "work"].country                                         | UserProfile                   | workContactDetails.addressInfo.visitAddress.country      |
| urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber | Employment                    | employeeid                                               |
| urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager        | Employment                    | manager.employeeid                                       |
| urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization   | Employment, OrgStructure      | orgUnit.id used to get level 1 of org structure          |
| urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division       | Employment, OrgStructure      | orgUnit.id used to get level 2 of org structure          |
| urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department     | Employment, OrgStructure      | orgUnit.id used to get level 3 of org structure          |
| urn:ietf:params:scim:schemas:extension:fortytwo:1.0:User:startdate        | Employment                    | firstWorkingDay                                          |
| urn:ietf:params:scim:schemas:extension:fortytwo:1.0:User:enddate          | Employment                    | lastWorkingDay                                           |
| urn:ietf:params:scim:schemas:extension:fortytwo:1.0:User:ssn              | UserProfile                   | personalIdentification                                   |
| urn:ietf:params:scim:schemas:extension:fortytwo:1.0:User:jobtitleid       | Employment                    | job.id                                                   |
| urn:ietf:params:scim:schemas:extension:fortytwo:1.0:User:startdate        | Employment                    | firstWorkingDay                                          |
| urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel0name    | Employment, OrgStructure      | orgUnit.id used to get level 1 of org structure          |
| urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel1name    | Employment, OrgStructure      | orgUnit.id used to get level 2 of org structure          |
| urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel2name    | Employment, OrgStructure      | orgUnit.id used to get level 3 of org structure          |
| urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel3name    | Employment, OrgStructure      | orgUnit.id used to get level 4 of org structure          |
| urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel4name    | Employment, OrgStructure      | orgUnit.id used to get level 5 of org structure          |
| urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel0id      | Employment, OrgStructure      | orgUnit.id used to get level 1 of org structure          |
| urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel1id      | Employment, OrgStructure      | orgUnit.id used to get level 2 of org structure          |
| urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel2id      | Employment, OrgStructure      | orgUnit.id used to get level 3 of org structure          |
| urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel3id      | Employment, OrgStructure      | orgUnit.id used to get level 4 of org structure          |
| urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel4id      | Employment, OrgStructure      | orgUnit.id used to get level 5 of org structure          |
| urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevelids      | Employment, OrgStructure      | orgUnit.id used to get all ids from the org structure    |
