Concetto: API Peakon SCIM 2.0
L'API di Peakon automatizza il provisioning e il de-provisioning dei dipendenti, garantendo che la partecipazione al sondaggio Peakon sia in linea con i sistemi che supportano il protocollo SCIM 2.0, come Microsoft Azure Active Directory, Okta e OneLogin. Questo metodo consente a più sistemi di aggiornare e sincronizzare i record dei dipendenti.
Informazioni su SCIM 2.0
System for Cross-domain Identity Management (SCIM) 2.0 specifica un protocollo REST standardizzato per il provisioning unidirezionale degli utenti tramite HTTP. Il tuo attuale sistema di gestione delle identità può essere configurato per sincronizzare automaticamente le modifiche apportate al suo database con un'applicazione di terze parti come Peakon. Nel protocollo SCIM, il sistema centrale di gestione dell'identità è chiamato "fornitore di identità" e l'applicazione di terze parti è chiamata "fornitore di servizi". Configurando Peakon come fornitore di servizi con il tuo sistema di gestione delle identità esistente, la tua organizzazione sarà in grado di sfruttare appieno il provisioning automatico degli account.
Per istruzioni su come configurarlo, visitare Impostare il provisioning dei dipendenti utilizzando SCIM 2.0.
Operazioni supportate
L'API Peakon SCIM 2.0 supporta le seguenti operazioni:
- Crea utenti
- Aggiorna utenti
- Elimina utenti
- Attiva/disattiva gli utenti
- Operazioni in blocco per gli utenti
Estensione dello schema aziendale
Peakon supporta i seguenti attributi di base nell'estensione dello schema utente Enterprise, come definito nella specifica SCIM 2.0:
- numerodipendente
- Dipartimento
- Manager
Lo schema della tua azienda contiene lo schema utente Enterprise e le estensioni dello schema Peakon. Per recuperare gli schemi supportati dalla tua azienda, inclusi i campi disponibili, chiama l'endpoint
Ottieni schemi
.Estensione dello schema Peakon
Oltre ai campi di base, Peakon fornisce un'estensione dello schema personalizzata per consentire dati di campo per attributi personalizzati (ad esempio
Manager
, Data di nascita
, Reparto
, ecc.). Il formato di questa estensione segue il formato specificato nella specifica SCIM 2.0. Il tipo di valore degli attributi personalizzati dipende dal tipo di attributo:
Tipo di attributo | Tipo di valore |
|---|---|
Attributi del tipo di opzione. Esempio: Dipartimento . | Un valore stringa (max 256 caratteri). |
Attributi del tipo di data. Esempio: Data di nascita . | Una stringa DateTime (formato ISO 8601). |
Attributi di tipo numerico. Esempio: Stipendio . | Un valore intero. |
Attributo tipo di dipendente. Esempio: Manager . | Un valore stringa contenente l'indirizzo e-mail del dipendente a cui si fa riferimento. Poiché gli attributi del tipo di dipendente fanno riferimento ad altri dipendenti nel sistema, il dipendente a cui si fa riferimento deve esistere in precedenza nel sistema. È possibile farlo con un provisioning in due fasi, includendo solo i campi di base nella prima fase e i campi estesi nella seconda. Gli attributi personalizzati vengono forniti come sotto-oggetti dei campi delle risorse principali. Esempio:
Per recuperare gli schemi supportati dalla tua azienda, inclusi i campi disponibili, chiama l'endpoint Ottieni schemi . |
Carico utile
Visita Riferimento: carico utile API Peakon SCIM 2.0 per maggiori informazioni.
Limitazione della velocità
La velocità dell'API Peakon SCIM è limitata a 25.000 operazioni/ora. Una richiesta API SCIM in blocco consuma 1 operazione per operazione nel payload della richiesta. Le altre richieste API SCIM consumano 1 operazione. Qualsiasi integrazione dovrebbe limitare le proprie chiamate API per garantire che questo limite non venga superato.