Concept : API Peakon SCIM 2.0
L'API de Peakon automatise le provisionnement et le déprovisionnement des employés, garantissant que la participation aux enquêtes de Peakon s'aligne sur les systèmes prenant en charge le protocole SCIM 2.0, tels que Microsoft Azure Active Directory, Okta et OneLogin. Cette méthode permet à plusieurs systèmes de mettre à jour et de synchroniser les dossiers des employés.
À propos de SCIM 2.0
Le système de gestion des identités interdomaines (SCIM) 2.0 spécifie un protocole REST standardisé pour le provisionnement unidirectionnel des utilisateurs via HTTP. Votre système de gestion des identités existant peut être configuré pour synchroniser automatiquement les modifications apportées à sa base de données avec une application tierce comme Peakon. Dans le protocole SCIM, le système central de gestion des identités est appelé « fournisseur d'identité » et l'application tierce est appelée « fournisseur de services ». En configurant Peakon en tant que fournisseur de services avec votre système de gestion des identités existant, votre organisation pourra profiter pleinement du provisionnement automatique des comptes.
Pour obtenir des instructions sur la façon de le configurer, visitez Configurer le provisionnement des employés à l'aide de SCIM 2.0.
Opérations prises en charge
L'API Peakon SCIM 2.0 prend en charge ces opérations :
- Créer des utilisateurs
- Mettre à jour les utilisateurs
- Supprimer les utilisateurs
- Activer/désactiver les utilisateurs
- Opérations en masse pour les utilisateurs
Extension du schéma d'entreprise
Peakon prend en charge les attributs de base suivants dans l'extension du schéma utilisateur Enterprise, comme défini dans la spécification SCIM 2.0 :
- numéro d'employé
- Département
- Gestionnaire
Le schéma de votre entreprise contient le schéma utilisateur Enterprise de votre entreprise et les extensions de schéma Peakon. Pour récupérer les schémas pris en charge pour votre entreprise, y compris les champs disponibles, appelez le point de terminaison
Obtenir les schémas
.Extension du schéma Peakon
En plus des champs de base, Peakon fournit une extension de schéma personnalisée pour autoriser les données de champ pour les attributs personnalisés (par exemple,
Manager
, Date de naissance
, Département
, etc.). Le format de cette extension suit le format spécifié dans la spécification SCIM 2.0. Le type de valeur des attributs personnalisés dépend du type d'attribut :
Type d'attribut | Type de valeur |
|---|---|
Attributs de type d'option. Exemple : Département . | Une valeur de chaîne (max 256 caractères). |
Attributs de type de date. Exemple : Date de naissance . | Une chaîne DateTime (format ISO 8601). |
Attributs de type numérique. Exemple : Salaire . | Une valeur entière. |
Attribut de type d'employé. Exemple : Gestionnaire . | Une valeur de chaîne contenant l'e-mail de l'employé référencé. Étant donné que les attributs de type d'employé font référence à d'autres employés dans le système, l'employé référencé doit exister au préalable dans le système. Vous pouvez le faire avec un provisionnement en deux étapes, incluant uniquement les champs de base dans la première étape et les champs étendus dans la seconde. Les attributs personnalisés sont fournis en tant que sous-objet des champs de ressources principaux. Exemple:
Pour récupérer les schémas pris en charge pour votre entreprise, y compris les champs disponibles, appelez le point de terminaison Obtenir les schémas . |
Charge utile
Visite Référence : charge utile de l'API Peakon SCIM 2.0 pour plus d'informations.
Limitation de débit
L'API Peakon SCIM est limitée à 25 000 opérations/heure. Une demande d'API SCIM en masse consomme 1 opération par opération dans la charge utile de la demande. Les autres requêtes API SCIM consomment 1 opération. Toute intégration doit limiter ses appels API pour s’assurer que cette limite n’est pas dépassée.