⚑ Prérequis: accès Superutilisateur.
Cet article explique la marche à suivre pour mettre en place le protocole SCIM.
Une fois l'intégration SCIM activée, votre service informatique pourra contrôler directement depuis votre système de gestion des identités :
- La création, la modification et la désactivation des utilisateurs ;
- Le niveau d'accès de ces utilisateurs, en leur attribuant des projets et des profils (les deux sont des groupes dans le protocole SCIM).
Configuration dans Borealis
1. Dans le Menu principal, accéder à Utilisateurs > Paramètres d'authentification :
2. Sélectionner SCIM à gauche. Dans l'encadré, cliquer sur le crayon pour modifier :
3. Cocher la case pour activer le provisionnement SCIM, puis cliquer sur le bouton Sauvegarder :
4. Ces deux informations s'affichent au bas de la page :
- La confirmation que le provisionnement SCIM est activé ;
- L'URL de provisionnement dans la bannière, accompagnée d'un jeton d'authentification. Ce jeton doit être copié immédiatement, car ces valeurs seront nécessaires lors de la configuration du service de gestion des identités.
ⓘ Remarque: Si le jeton est perdu, vous devez désactiver le provisionnement SCIM, puis l'activer de nouveau. Un nouveau jeton sera alors fourni. Cela signifie aussi que l'ancien jeton sera désactivé : toute intégration configurée précédemment avec l'ancien jeton cessera de fonctionner.
Configuration dans le service de gestion des identités
Accéder à votre service de gestion des identités (par exemple, Entra ID - Microsoft Azure Active Directory) et suivre les instructions pour terminer la configuration. Ces instructions peuvent varier selon votre service de gestion des identités.
-
Configurer la connectivité
- Entrer :
- URL du locataire (URL de base SCIM)
- Jeton secret
- Sélectionner Tester la connexion pour vérifier la communication entre Microsoft Entra ID et l'application.
- Enregistrer la configuration.
- Entrer :
-
Attribuer des utilisateurs et des groupes
- Ouvrir le service de gestion des identités.
- Sélectionner Utilisateurs et groupes.
- Choisir Ajouter un utilisateur/groupe.
-
Attribuer les utilisateurs et les groupes qui doivent être provisionnés vers l'application.
Microsoft Entra ID
-
Configurer les mappages d'attributs
- Ouvrir le service de gestion des identités.
- Sélectionner Mappage d'attributs.
- Ajouter les mappages pour les utilisateurs et les groupes.
- Attribuer une priorité de correspondance à vos attributs. La priorité de correspondance détermine l'ordre dans lequel Microsoft Entra ID vérifie les attributs d'un utilisateur pour trouver un compte existant dans l'application cible, ce qui permet d'éviter les doublons.
| Attribut SCIM mappé | Attribut Microsoft Entra ID | Priorité de correspondance |
| userName | userPrincipalName | 1 |
| name.givenName | givenName | |
| name.familyName | surName | |
| emails[type eq "work"].value | ||
| manager | manager | |
| active | isSoftDeleted (valeur calculée non stockée sur l'utilisateur) |
Attribut SCIM mappé |
Attribut Microsoft Entra ID | Priorité de correspondance |
| externalId | objectId | 1 |
| displayName | displayName | |
| members | members |
ⓘ Remarque:
1. Le mappage ci-dessus peut différer selon votre service de gestion des identités.
2. L'objectID du groupe correspond à l'identifiant unique SCIM dans Borealis.
-
Activer le provisionnement
Avant d'activer le provisionnement automatique, utiliser Provisionner à la demande pour tester vos mappages d'attributs et vérifier que les utilisateurs peuvent être provisionnés avec succès vers l'application.
Une fois les tests terminés, activer le provisionnement automatique :
- Ouvrir le service de gestion des identités.
- Sélectionner Provisionnement.
- Définir le Mode de provisionnement à Automatique.
- Définir l'État du provisionnement à Activé.
- Enregistrer la configuration.
ⓘ Remarque: Microsoft Entra ID commencera à planifier des tâches de synchronisation pour provisionner les utilisateurs et les groupes.
Liste des opérations prises en charge
| Point de terminaison | Opération | Détails |
| /Users | GET |
GET /Users : Récupérer la liste complète des utilisateurs GET /Users/{id} : Récupérer l'utilisateur correspondant à l'ID GET /Users?filter=userName eq “XXXXXXX” : Récupérer l'utilisateur correspondant au userName |
| /Users | POST | Créer un nouvel utilisateur |
| /Users | DELETE | DELETE /Users/{id} : Supprimer l'utilisateur correspondant à l'ID |
| /Users | PUT/PATCH | PATCH ou PUT /Users/{id} : Mettre à jour l'utilisateur correspondant à l'ID |
| /Groups | GET |
GET /Groups : Récupérer la liste complète des groupes GET /Groups/{id} : Récupérer le groupe correspondant à l'ID.
|
| /Groups | PATCH | PATCH /Groups/{id} : Utiliser les opérations add ou remove pour ajouter des membres au groupe ou en retirer des utilisateurs. |
| /ServiceProviderConfig | GET | Récupérer la configuration |
| /ResourceTypes | GET | Récupérer la liste des types de ressources pris en charge |
| /Schemas | GET | Récupérer la liste des schémas |
ⓘ Remarque: Tous les profils et tous les accès aux projets seront des groupes dans SCIM.
Par exemple, voici des groupes :
• SE - Data Entry
• Transmission line (Read-only)
• Transmission line (Full access)
Pour en savoir plus, consultez les articles sur Profils et projets et sur la création de profils personnalisés.