Simployer Ones system för Cross-domain Identity Management (SCIM) — KONTROLLERA DOMÄNNAMN

Ändrad den Mån, 2 juni vid 11:03 F.M.

Information om Simployer Ones SCIM API och hur du implementerar och använder det

Klicka här för att gå till avsnittet om hur du aktiverar och använder Simployer Ones SCIM.

Bakgrund
SCIM är en standard för att provisionera och avprovisionera användare samt uppdatera användarinformation i flera system. SCIM är brett antaget, och att Simployer One är kompatibelt med SCIM innebär att vi är kompatibla med många tjänster.

Simployer Ones SCIM är tillgängligt via en API-endpoint. Det innebär att du behöver en tjänst för att använda SCIM. Simployer One är hittills testat med tjänster som Okta, Slack och Google Workspace.

Simployer One kan vara både en SCIM-klient och en SCIM-server. Vi rekommenderar att använda Simployer One som klient, eftersom uppdateringar av medarbetarinformation sker i Simployer först. Ett undantag är vår integration med Okta, där vi fungerar som sanningskälla men är konfigurerade som server. Simployer One implementerar SCIM 2.0 enligt RFC-dokument från Internet Engineering Task Force:

Det är endast möjligt att hämta information från Simployer One via SCIM för att skapa konton i andra tjänster. Vi stödjer inte synkronisering tillbaka till Simployer One. Detta beror på den känsliga naturen hos Simployer Ones data, och ändringar via externa tjänster kan påverka tjänsten negativt.

Förutsättningar

Du måste vara Ägare i Simployer One för att kunna skapa en API-nyckel.
Se till att ditt konto tillåter användning av SCIM.

Stödda funktioner

Importera användare (skicka Simployer One-data till externa tjänster)

Procedur
För att använda Simployer Ones SCIM API behöver du bara en API-nyckel. Om du inte hittar denna sektion i ditt konto, kontakta Customer Success eller Support.

Om du vill ha en lösning som hanterar fler scenarier och ger IT full kontroll över hela medarbetarlivscykeln rekommenderar vi att du använder vår Okta-app.

Läs mer om Simployer Ones Okta-app

För senaste dokumentationen, se docs.alexishr.com/scim

Autentisering
Autentisera ditt konto genom att inkludera din hemliga Access Token i förfrågan.

Autentisering görs genom att skicka Access Token i Authorization-headern:

Authorization: Bearer <token>

Exempel
Detta exempel är en förfrågan för en specifik userID. Förfrågningar till /Users returnerar alla användare i ditt konto.

Förfrågan
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    }  ] }