Rubrique
Ce guide explique comment utiliser Duo pour configurer le protocole Système de gestion des identités interdomaines (SCIM) avec NinjaOne.
Environnement
Plateforme NinjaOne
Fournisseur intégré Duo Security
Description
Intégrez votre fournisseur d’identité (IDP) via SCIM pour créer et supprimer automatiquement des techniciens et des utilisateurs finaux au sein de NinjaOne.
Cet article est destiné à servir de point de départ pour la configuration du SCIM avec NinjaOne. La configuration dépend de votre configuration Duo spécifique ; nous vous recommandons donc de consulter la section « Ressources complémentaires » pour trouver les procédures associées.
Indexer
- Prérequis et considérations importantes
- Activer SCIM dans NinjaOne
- Configurer SCIM dans Duo
- Attributs de cartographie entre NinjaOne et Duo
- Attribuer des utilisateurs ou des groupes au provisionnement SCIM
- Cartographier les groupes Duo avec les rôles NinjaOne
- Ressources complémentaires
Prérequis et considérations importantes
Avant de procéder au provisionnement SCIM avec Duo, NinjaOne vous recommande de vérifier plusieurs éléments de configuration et de déterminer s’ils doivent être inclus dans votre configuration de provisionnement.
Des points de départ et des instructions générales seront inclus pour chaque catégorie. Les éléments de configuration possibles incluent :
- Groupes : nécessaires si vous souhaitez cartographier automatiquement des groupes d’utilisateurs Duo à des rôles d’utilisateurs spécifiques dans NinjaOne. En savoir plus
- Créer et mapper les attributs utilisateur: obligatoire si vous devez mapper des utilisateurs finaux à une organisation spécifique ou créer des comptes de techniciens. En savoir plus
- Attribuer des attributs utilisateur: cela garantit que chaque utilisateur est associé à la bonne organisation NinjaOne (utilisateurs finaux) et dispose du type de compte approprié (technicien ou utilisateur final). En savoir plus
Créer et utiliser des groupes
Vous pouvez utiliser les groupes Duo pour associer des utilisateurs à des rôles spécifiques dans NinjaOne. Si vous n’utilisez pas de groupes, vous devez attribuer manuellement des rôles aux utilisateurs dans NinjaOne ; consultez la section Rôles et autorisations des utilisateurs pour plus d’informations.
Pour créer un nouveau groupe Duo, procédez comme suit :
- Connectez-vous au panneau d'administration Duo (externe).
- Accédez à Utilisateurs → Groupes, puis cliquez sur Ajouter un groupe.
- Saisissez un nom pour votre nouveau groupe dans le champ Nom du groupe.
- Cliquez sur « Ajouter un groupe » pour enregistrer le groupe. Attribuez-lui le statut « Actif » (recommandé) ou « Contournement » selon vos besoins.
- Cliquez sur « + Ajouter des utilisateurs au groupe » et ajoutez les utilisateurs souhaités.
- Répétez l'opération autant de fois que nécessaire.
Créer et mapper les attributs utilisateur
Avant de configurer SCIM avec Duo, nous vous recommandons de prendre en compte les cas d’utilisation suivants et de créer les attributs correspondants si nécessaire. Ces attributs utilisateur personnalisés seront ensuite mappés aux attributs NinjaOne lors du processus de configuration SCIM.
Vous pouvez également ajouter et importer ces attributs depuis votre répertoire externe (external) s’il est synchronisé avec Duo.
- Exigence n° 1: mapper les utilisateurs finaux à une organisation. Créez un attribut utilisateur Duo personnalisé qui sera mappé à l’attribut NinjaOne facultatif « organizationid ».
- Exigence n° 2: créer des comptes de techniciens NinjaOne. Créez un attribut utilisateur Duo personnalisé qui sera mappé à l’attribut NinjaOne facultatif « userType ».
Une fois que vous avez déterminé quels attributs utilisateur sont obligatoires pour votre provisionnement SCIM, procédez comme suit pour créer les attributs personnalisés dans Duo :
- Connectez-vous au panneau d’administration Duo (externe).
- Accédez à Utilisateurs →Attributs utilisateur. Cliquez sur Ajouter un attribut personnalisé.
- Saisissez un identifiant unique pour votre nouvel attribut dans le champ « Nom ». Il peut s’agir de la valeur de votre choix.
- Cliquez sur « Ajouter un attribut personnalisé » pour enregistrer les données.
- Répétez ces étapes pour chaque exigence.
Attribuer des attributs aux utilisateurs
Maintenant que les attributs personnalisés ont été créés, vous devez les attribuer aux utilisateurs cibles. Le protocole SCIM de NinjaOne provisonnera un compte en fonction des valeurs d’attributs attribuées à un utilisateur. Ces valeurs servent à définir le type d’utilisateur (technicien ou utilisateur final) et l’organisation (Toutes les organisations ou une organisation spécifique). Vous devrez attribuer les valeurs nécessaires à chaque utilisateur afin que leurs comptes soient créés avec la configuration souhaitée.
Vous pouvez attribuer des attributs à un utilisateur via les méthodes suivantes (externes) :
- Attributs utilisateur | Duo Security | Importer des valeurs d’attributs avec la synchronisation d’annuaire
- Attributs utilisateur | Duo Security | Ajouter des attributs personnalisés aux utilisateurs depuis le panneau d’administration
- Administration Duo - Importer des utilisateurs depuis un fichier CSV | Duo Security
Lorsque vous attribuez des attributs aux utilisateurs, vous devez attribuer la valeur correcte à l’attribut correspondant. Les valeurs suivantes sont les seules que vous devrez utiliser lors du processus de création de compte.
| Attribut | Valeur obligatoire |
|---|---|
| organizationID | « Tous » (crée un utilisateur final global) |
| organizationID | « <INSERTORGANIZATIONID> » (affecte un Utilisateur final à l'organisation correspondante ; consultez la section « NinjaOne Platform : Comment trouver un ID d'organisation » pour savoir comment obtenir cet ID) |
| userType | « technicien » (crée un compte de technicien NinjaOne) |
| userType | « endUser » (crée un compte d’utilisateur final NinjaOne) |
Activer SCIM dans NinjaOne
Découvrez l’utilisation de SCIM dans NinjaOne grâce à notre guide « NinjaOne Identity Management : gestion des identités avec SCIM ».
Pour activer SCIM et générer le jeton secret SCIM, procédez comme suit :
- Dans la console NinjaOne, accédez à Administration → Comptes → Fournisseurs d’identité et ouvrez l’entrée IDP.
- Cliquez sur « Activer » pour « Système de gestion des identités interdomaines (SCIM) ».
- Activez le bouton bascule « Activer le provisionnement SCIM » dans la fenêtre modale de configuration, puis cliquez sur « Générer un jeton ». Laissezcette fenêtre modale ouverte afin de pouvoir copier les données nécessaires aux étapes suivantes.
Configurer SCIM dans Duo
- Dans Duo, accédez à Applications → Gérer → Applications. Sélectionnez votre application « Duo Generic SAML Service Provider » pour NinjaOne.
- Ouvrez l’onglet « Provisioning » et sélectionnez « Bearer Token » dans le Menu déroulant « Mode d’authentification ».
- Copiez l’URL du point de terminaison de l’API et le Jeton secret SCIM depuis la console NinjaOne.
- Collez les données respectivement dans les champs Base URL et Jeton dans Duo.
- Testez la connexion pour vérifier qu’elle fonctionne, puis connectez-vous à l’application.
Attributs de cartographie entre NinjaOne et Duo
Une fois l’authentification réussie, vous recevrez une liste des attributs NinjaOne obligatoires et par défaut qui devront être mis en correspondance avec les attributs utilisateur de Duo.
Prenez note des attributs NinjaOne suivants :
- name.familyName
- name.givenName
- Nom d’utilisateur
Vous devez mapper les attributs NinjaOne aux attributs utilisateur Duo correspondants (comme indiqué ci-dessous) pour garantir la réussite du provisionnement SCIM :
| Attribut utilisateur Duo | Attribut NinjaOne |
|---|---|
| Nom de famille | name.familyName |
| Prénom | name.givenName |
| Adresse e-mail | Nom d’utilisateur |
| <organizationId> | (facultatif) organizationID |
| <userType> | (facultatif) type d'utilisateur |
Associer des utilisateurs finaux à une organisation spécifique
Associez votre attribut utilisateur Duo personnalisé (<ORGANIZATIONID>) à l’attribut facultatif de NinjaOne, « organizationId ». Si la valeur de l’ID d’organisation est manquante ou si elle est définie sur « all » pour un utilisateur final, un utilisateur final global sera créé.
Créer des comptes de technicien NinjaOne ou à la fois des comptes d’utilisateur final et de technicien
Associez votre attribut utilisateur Duo personnalisé (<USERTYPE>) à l’attribut facultatif de NinjaOne « userType ».
L’attribut userType accepte deux valeurs :
- « Technicien » crée un compte de technicien NinjaOne.
- « endUser » (sensible à la casse) crée un compte d’Utilisateur final NinjaOne.
Attribuer des utilisateurs ou des groupes au provisionnement SCIM
Une fois les attributs mappés, vous devez attribuer des groupes ou des utilisateurs cibles au provisionnement SCIM.
La décision d’attribuer des utilisateurs spécifiques, tous les utilisateurs disposant d’un accès SSO ou des groupes d’utilisateurs spécifiques à gérer via SCIM dépend des objectifs de votre organisation et de la configuration de Duo.
Cette section présente une approche couramment utilisée consistant à utiliser des groupes pour attribuer des utilisateurs au provisionnement SCIM. Veuillez vous reporter à la documentation de Duo pour déterminer la méthode la mieux adaptée à vos besoins.
Dans l’exemple suivant, nous avons créé un groupe pour les utilisateurs finaux et un groupe pour les techniciens. Une fois la configuration enregistrée, le processus de provisionnement des utilisateurs démarre automatiquement.
Mapper les groupes Duo aux rôles NinjaOne
Si vous attribuez des groupes au provisionnement SCIM dans Duo, ceux-ci apparaîtront dans la section « Mappage des groupes » de la page « Fournisseur d’identité » de la console NinjaOne. Le mappage des groupes vous permet d’attribuer des rôles d’utilisateur final ou de technicien à un groupe d’identité.
Pour en savoir plus sur la création et la gestion des rôles dans NinjaOne, consultez la section « Rôles et autorisations des utilisateurs ».
- Groupe d’identité: il s’agit des groupes mappés depuis le fournisseur d’identité (IDP).
- Rôles utilisateur: il s’agit des rôles attribués au groupe.
Pour définir la cartographie des groupes pour votre fournisseur d’identité, procédez comme suit :
- Dans la console NinjaOne, accédez à Administration → Comptes → Fournisseurs d’identité et ouvrez la fiche du fournisseur.
- Cliquez sur Modifier dans la section Cartographie des groupes.
- Mettez en correspondance les rôles NinjaOne avec leurs groupes Duo respectifs. Si vous n’avez pas configuré de groupes à mettre en correspondance entre Duo et votre division NinjaOne, aucune option de mise en correspondance éligible ne s’affichera dans la fenêtre contextuelle « Mettre en correspondance les groupes ». Pour résoudre ce problème, consultez les étapes décrites dans les sections « Mettre en correspondance les attributs entre NinjaOne et Duo » et « Attribuer des utilisateurs ou des groupes à l’approvisionnement SCIM ».
Chaque utilisateur et son rôle s’afficheront sur la page de configuration de son compte NinjaOne, ce qui vous permettra de suivre le mappage ou de modifier les autorisations si nécessaire.
Ressources complémentaires
Consultez les ressources suivantes pour en savoir plus sur la gestion des identités dans NinjaOne :