Simployer Ones system for Cross-domain Identity Management (SCIM) — SJEKK DOMENENAV

Endret Mon, 2 Jun ved 10:59 AM

Informasjon om Simployer Ones SCIM API og hvordan du implementerer og bruker det

Klikk her for å gå til delen om hvordan du aktiverer og bruker Simployer Ones SCIM.

Bakgrunn
SCIM er en standard for opprettelse og sletting av brukere samt oppdatering av brukerdata i flere systemer. SCIM er bredt tatt i bruk, og at Simployer One er kompatibel med SCIM betyr at vi er kompatible med mange tjenester.

Simployer Ones SCIM er tilgjengelig via et API-endepunkt. Det betyr at du trenger en tjeneste for å bruke SCIM. Simployer One er foreløpig testet med tjenester som Okta, Slack og Google Workspace.

Simployer One kan være både en SCIM-klient og en SCIM-server. Vi anbefaler at Simployer One brukes som klient, siden oppdateringer av ansattinformasjon skjer i Simployer først. Et unntak er integrasjonen med Okta, hvor vi fungerer som en sannhetskilde, men er satt opp som server. Simployer One implementerer SCIM 2.0 i henhold til RFC-dokumentene fra Internet Engineering Task Force:

Det er kun mulig å hente informasjon fra Simployer One via SCIM for å opprette kontoer i andre tjenester. Vi støtter ikke synkronisering tilbake til Simployer One. Dette skyldes den sensitive naturen til Simployer Ones data, og at endringer via eksterne tjenester kan påvirke tjenesten negativt.

Forutsetninger

Du må være Eier i Simployer One for å kunne opprette en API-nøkkel.
Sørg for at kontoplanen din tillater bruk av SCIM.

Støttede funksjoner

Importere brukere (sende Simployer One-data til eksterne tjenester)

Fremgangsmåte
For å bruke Simployer Ones SCIM API trenger du bare en API-nøkkel. Hvis du ikke finner denne delen i kontoen din, kontakt Customer Success eller Support.

Hvis du ønsker en løsning som håndterer flere scenarioer og gir IT full kontroll over hele ansattlivssyklusen, anbefaler vi å bruke vår Okta-app.

Les mer om Simployer Ones Okta-app

For siste dokumentasjon, se docs.alexishr.com/scim

Autentisering
Autentiser kontoen din ved å inkludere din hemmelige Access Token i forespørselen.

Autentisering gjøres ved å sende Access Token i Authorization-headeren:

Authorization: Bearer <token>

Eksempel
Dette eksemplet viser en forespørsel for en spesifikk bruker-ID. Forespørsler til /Users returnerer alle brukere i kontoen din.

Forespørsel
GET /scim/v2/Users/<userID>

Headers

Accept: application/scim+json Accept-Charset: utf-8 Accept-Encoding: gzip Authorization: Bearer <token> Connection: close Content-Type: application/scim+json; charset=utf-8 Host: api.alexishr.com User-Agent: AlexisHR SCIM Integration

Respons

{  "schemas": [    "urn:ietf:params:scim:schemas:core:2.0:User",    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"  ],  "id": "<userID>",  "userName": "fname.lname@domain.com",  "name": {    "givenName": "Fname",    "familyName": "Lname"  },  "active": true,  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {    "employeeNumber": "1",    "organization": "Example AB",    "division": "Division 123",    "costCenter": "CODE-1",    "department": "Tech"  },  "meta": {    "resourceType": "User",    "created": "2021-04-19T09:48:04.317Z",    "lastModified": "2021-04-29T16:47:11.001Z",    "location": null  },  "displayName": "Fname Lname",  "profileUrl": "https://api.alexishr.com/files/upload/LUQVMYtUZcbwycnVUIVGBQboY0H8s9F4OrjgNyCGAzNnkBSDFGrKHntrTmCLE0E0.jpeg",  "title": "CEO",  "emails": [    {      "value": "fname.lname@domain.com",      "display": "fname.lname@domain.com",      "type": "work",      "primary": true    },    {      "value": "private-email@domain.com",      "display": "private-email@domain.com",      "type": "home"    }  ],  "phoneNumbers": [    {      "value": "+4623456789",      "type": "work",      "primary": true    },    {      "value": "+4612345678",      "type": "home"    }  ],  "photos": [    {      "value": "https://api.alexishr.com/files/upload/LUQVMYtUZcbwycnVUIVGBQboY0H8s9F4OrjgNyCGAzNnkBSDFGrKHntrTmCLE0E0.jpeg",      "type": "photo"    }  ],  "addresses": [    {      "streetAddress": "Street 1",      "locality": "Stockholm",      "postalCode": "12345",      "country": "SE",      "type": "home",      "primary": true    }  ] }