Ce guide d'implémentation a pour but de vous accompagner dans la mise en place et la configuration d'une solution SCIM. Une grande partie de la configuration doit être effectuée au niveau du fournisseur d'identité (IdP) du client.

Configuration

Étape n° 1 : Préparer le compte

1. Activez l'option SCIM dans la section Intégrations de la configuration client.
2. Enregistrer la page.
3. Accédez à la section Rôles et autorisations.
4. Une fois la page ouverte, ouvrez la section « Rôles et autorisations » dans le panneau de gauche.
5. Cliquez sur « Ajouter un nouveau rôle d'employé » pour créer un nouveau rôle utilisateur pouvant être utilisé pour tester l'intégration SCIM.
6. Saisissez un identifiant de nom SCIM pour faire référence à la fonction de cet utilisateur, puis sélectionnez Administrateur de l'entreprise comme rôle d'employé hérité .
7. Cliquez sur Créer un rôle .
8. Les autorisations du rôle s'afficheront alors. Accordez à l'utilisateur l'accès aux autorisations d'administrateur de société/compte, activez l'autorisation d'accès à l'API en haut du rôle et accordez-lui un accès complet à l'autorisation SCIM .
   • Remarque : Si un client possède plusieurs comptes et qu’il doit créer des utilisateurs en double dans chacun d’eux, vous devrez également activer l’accès complet à l’autorisation « Autoriser la fusion des employés » .
9. Cliquez sur Enregistrer en haut à droite de la page.
10. Ouvrez la section Employés de Rôles et autorisations.
11. Cliquez sur Ajouter un nouvel employé pour créer un utilisateur de test et lui attribuer le nouveau rôle d'utilisateur SCIM.
12. Faites une copie du fichier SCIM Attribute Mappings , qui répertorie tous les attributs Paradox par défaut pris en charge, et partagez-la avec le client.
    • Remarque : Les attributs par défaut et les attributs personnalisés supplémentaires peuvent être extraits des API de schéma. Cette opération peut être effectuée par le technicien du client ou par vous-même.

Étape n° 2 : Déterminer l’identifiant unique de l’employé

1. Retournez à la section Intégrations de la configuration client.
2. Dans la sous-section SCIM , sélectionnez l' attribut principal . Par défaut, il s'agira de l'option de connexion définie dans la section Confidentialité des données de la configuration client, mais vous pouvez la modifier et choisir l'une des options suivantes :
   • Numéro d'employé
   • E-mail
   • SCIM Identifiant externe
   • Nom d'utilisateur SCIM
   • Numéro de téléphone
3. Cliquez sur le bouton + Ajouter une adresse IP pour ajouter une API autorisée.
4. Répétez l'étape 3 pour toutes les adresses IP à ajouter à la liste blanche. Sinon, toutes les adresses IP pourront appeler les terminaux SCIM de Paradox .
5. Sélectionnez les limites maximales des opérations en masse . Les options incluent :
   • 5
   • 10 (par défaut)
6. Enregistrer la page.
7. Accédez à la section Rôles et autorisations.
8. Ouvrez la section Rôles et autorisations dans le panneau de gauche.
9. Chaque rôle utilisateur dans le CEM doit être associé à un ID externe . Il s'agit de la valeur que le client envoie dans l'attribut role afin d'attribuer aux utilisateurs le rôle approprié. Survolez le premier rôle utilisateur, cliquez sur son menu d'actions (ou sur les points de suspension), puis sélectionnez « Modifier » .
10. Lorsque la page s'ouvre, saisissez l' identifiant externe attribué au rôle.
11. Enregistrer la page.
12. Répétez les étapes 9 à 11 pour chaque rôle utilisateur.

Étape n° 3 : Générer un jeton d’authentification

1. Usurpez l'identité du nouvel employé de SCIM. Vous pouvez procéder comme suit :
   1. Cliquez sur votre avatar.
   2. Cliquez sur votre nom.
   3. Rechercher l'utilisateur SCIM.
   4. Sélectionnez leur nom dans la liste.
2. Ouvrez leur profil depuis le menu de l'avatar.
3. Cliquez sur le bouton Paramètres en haut à droite du profil.
4. Dans la section ID du compte et secret de l'API , cliquez sur Générer le secret de l'API .
5. Copiez l' identifiant du compte et le secret de l'API . Ils serviront respectivement de client_id et client_secret lors de la génération du jeton d'authentification.

6. Effectuez une requête HTTP vers le point de terminaison Oauth2 en utilisant l'URL de base appropriée, le client_id et client_secret de l'utilisateur d'intégration SCIM.

{{base_url}}/api/v1/public/auth/token

Accept:application/json
Content-Type:application/x-www-form-urlencoded

client_id:{{client_id}}
grant_type:client_credentials
client_secret:{{client_secret}}

7. Enregistrez le access_token figurant dans le corps de la réponse. Le client devra l'ajouter à l'intégration SCIM de son fournisseur d'identité afin de pouvoir autoriser ses requêtes.

2. Le jeton d'authentification vous sera communiqué sous forme de note privée à l'aide de l'outil Paradox PrivateBin .

Étape n° 4 : Consulter les ressources SCIM

Les utilisateurs clients peuvent consulter les ressources SCIM ci-dessous :

• Orientez le client vers la section « Implémentations SCIM 2.0 » de la documentation relative aux implémentations SCIM .
• Documentation du manuel client d'implémentation Paradox prise en charge (téléchargeable et partageable au format PDF).
• Des informations complémentaires sont disponibles dans la documentation du protocole SCIM relative aux points de terminaison SCIM Paradox .

Tests de l'API SCIM

Pour tester l'authentification SKIM, suivez les étapes ci-dessous.

1. Récupérez l' client_id et secret_key de l'utilisateur d'intégration SCIM que vous avez créé à l'étape n° 1 ci-dessus.
2. Appliquez les valeurs aux variables appropriées dans la collection SCIM Postman et envoyez-les au point de terminaison OAuth2.

{
	"info": {
		"_postman_id": "b0cd3e06-1534-42f1-ba9a-a90a0007789b",
		"name": "SCIM",
		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
		"_exporter_id": "20564521"
	},
	"item": [
		{
			"name": "Users",
			"item": [
				{
					"name": "[Sample] Get Users",
					"protocolProfileBehavior": {
						"disabledSystemHeaders": {
							"host": true
						}
					},
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Accept",
								"value": "application/scim+json"
							}
						],
						"url": {
							"raw": "{{host}}/scim/v2/Users",
							"host": [
								"{{host}}"

3. Le access_token dans la réponse peut désormais être utilisé dans l'en-tête Authorization .

Cartographie des attributs SCIM

Dépannage