Configurer le provisioning SCIM dans Uptrends

Note

La prise en charge de SCIM est disponible pour les comptes Uptrends Enterprise éligibles. Si vous souhaitez utiliser SCIM, contactez le support Uptrends ou votre account manager pour discuter des options et démarrer.

Configurer SCIM

Ce guide utilise Microsoft Entra ID comme exemple de fournisseur d’identité. Le même workflow et le même endpoint SCIM s’appliquent aux autres IdP.

Avant de commencer, assurez-vous de remplir les prérequis SCIM.

Effectuez les étapes suivantes pour configurer SCIM. Chaque étape inclut des instructions détaillées :

1. Configurer SCIM dans Uptrends.
2. Connecter votre fournisseur d’identité (IdP) à Uptrends via SCIM.
3. Provisionner votre IdP.
4. Vérifier la configuration SCIM dans Uptrends et dans votre IdP.
5. Ajouter des autorisations d’accès aux groupes synchronisés dans Uptrends.

Configurer SCIM dans Uptrends

Suivez ces étapes pour configurer SCIM dans votre compte Uptrends.

1. Connectez-vous à Uptrends en tant qu’administrateur.
2. Ouvrez les paramètres SCIM, selon votre vue :

• Accédez à Configuration de compte > Paramètres SCIM.
• Accédez à Administrateur > Opérateurs et groupes > Paramètres SCIM.

3. Créez un compte de service SCIM :

   a. Cliquez sur Créer un compte de service SCIM.

   b. Indiquez l’adresse e-mail du compte de service.

   c. Cliquez sur Créer.

   d. Une fois le compte créé, copiez la clé API et stockez-la de façon sécurisée. Vous l’utiliserez comme jeton secret dans votre IdP. Uptrends affiche la clé une seule fois. Si vous la perdez, générez une nouvelle clé API pour le compte de service SCIM. Pour plus de détails, consultez la section Jeton API SCIM.

   e. Copiez l’URL de l’endpoint SCIM. Utilisez-la comme URL de locataire dans votre IdP. Par exemple, utilisez https://api.uptrends.com/v4/scim/v2 comme URL de production.

   f. Cliquez sur Continuer.

Connecter votre fournisseur d’identité (IdP) à Uptrends via SCIM

Suivez ces étapes pour établir une connexion entre la plateforme Uptrends et votre IdP :

1. Créer une application d’entreprise hors galerie dans Microsoft Entra ID.

Note

Vous n’avez pas besoin d’une entrée dans l’Entra App Gallery pour utiliser SCIM avec Uptrends. Vous pouvez aussi configurer le SSO dans la même application d’entreprise en utilisant votre configuration SSO Uptrends existante.

2. Configurez le provisionnement SCIM dans Microsoft Entra ID :

   a. Dans l’application d’entreprise, accédez à Provisioning.

   b. Définissez Provisioning Mode sur Automatic.

   c. Si votre IdP vous demande de choisir une méthode d’authentification, sélectionnez Bearer authentication.

   d. Sous Admin Credentials, saisissez les informations suivantes :

• Tenant URL — URL de l’endpoint SCIM issue de l’écran de configuration de l’application web Uptrends. Par exemple, https://api.uptrends.com/v4/scim/v2.

• Secret Token — clé API de votre compte de service SCIM lorsque vous configurez SCIM dans Uptrends.

3. Cliquez sur Test Connection. Votre IdP vérifie l’endpoint et le jeton.

Un message s’affiche si la connexion réussit.

4. Cliquez sur Save, puis démarrez le provisionnement.

Provisionner votre IdP avec Uptrends via SCIM

Note

Assurez-vous d’avoir déjà attribué des utilisateurs et des groupes à l’application d’entreprise sous Users and groups avant de démarrer le provisionnement.

Suivez ces étapes pour définir la portée du provisionnement et synchroniser les utilisateurs IdP avec Uptrends :

1. Accédez à Settings > Provisioning, puis sélectionnez les utilisateurs et les groupes à synchroniser :

• Synchroniser uniquement les utilisateurs et groupes attribués (recommandé) — seuls les utilisateurs et groupes que vous attribuez à cette application d’entreprise sont provisionnés dans Uptrends.

• Synchroniser tous les utilisateurs et groupes — synchronise l’ensemble de votre répertoire. Utilisez cette option uniquement si vous souhaitez provisionner tous les utilisateurs et groupes dans Uptrends.

2. Définissez Provisioning status sur On.

3. Microsoft Entra ID exécute une synchronisation initiale, puis poursuit la synchronisation environ toutes les 40 minutes.

4. Suivez la progression sous Provisioning > View provisioning logs.

La synchronisation initiale peut prendre plus de temps selon le nombre d’utilisateurs et de groupes attribués.

Vérifier la réussite d’un provisionnement depuis l’IdP et Uptrends

Une fois le provisionnement terminé, vérifiez les éléments suivants :

Vérifier la configuration SCIM dans votre IdP

1. Dans votre application d’entreprise, accédez à Provisioning > View provisioning logs. Vérifiez que les utilisateurs et groupes apparaissent comme créés ou mis à jour sans erreurs.

Vérifier la configuration SCIM dans Uptrends

1. Ouvrez les paramètres SCIM, selon votre vue :

• Accédez à Configuration de compte > Paramètres SCIM.
• Accédez à Administrateur > Paramètres SCIM.

Vérifiez que l’URL de l’endpoint et le compte de service sont correctement configurés.

2. Ouvrez la page Opérateurs, selon votre vue :

• Accédez à Configuration de compte > Opérateurs et groupes.
• Accédez à Administrateur > Opérateurs et groupes.

Vérifiez que les opérateurs gérés par SCIM portent le libellé Géré par votre IdP dans la liste.

3. Ouvrez la page Groupes d’opérateurs, selon votre vue :

• Accédez à Configuration de compte > Opérateurs et groupes.
• Accédez à Administrateur > Opérateurs et groupes.

Vérifiez que les groupes d’opérateurs gérés par SCIM portent le libellé Géré par SCIM dans la liste. Vérifiez que l’appartenance correspond à vos attributions IdP.

4. Ouvrez le Journal d'audit, selon votre vue :

• Accédez à Configuration de compte > Journal d'audit.
• Accédez à Administrateur > Journal d'audit.

Vérifiez que les changements apportés aux utilisateurs et groupes à l’initiative de SCIM sont enregistrés dans le Journal d'audit Uptrends. Pour plus d’informations, consultez l’article de la base de connaissances Journal d’audit.

Une fois les opérateurs et groupes d’opérateurs provisionnés, consultez le comportement du provisionnement SCIM dans Uptrends pour connaître le comportement attendu, les autorisations, le calendrier de synchronisation et les limites actuelles.

Mapper les groupes synchronisés avec les autorisations Uptrends

SCIM synchronise uniquement les opérateurs et les groupes d’opérateurs dans Uptrends. Les autorisations restent contrôlées par Uptrends afin que vous puissiez accorder l’accès aux moniteurs, alertes et autres ressources sans modifier votre configuration IdP.

Suivez ces étapes pour accorder des autorisations d’accès aux groupes synchronisés dans Uptrends.

Pour chaque groupe synchronisé :

1. Ouvrez la page Opérateurs, selon votre vue :

• Accédez à Configuration de compte > Opérateurs et groupes.
• Accédez à Administrateur > Opérateurs et groupes.

2. Sélectionnez un groupe géré par SCIM portant le libellé Géré par SCIM.
3. Cliquez sur Autorisations.
4. Configurez les moniteurs, groupes de moniteurs, intégrations, alertes et autres ressources auxquels le groupe peut accéder.
5. Répétez l’opération pour chaque groupe qui a besoin d’un accès Uptrends.

Après avoir attribué les autorisations, connectez-vous en tant qu’utilisateur provisionné avec le SSO ou une connexion Uptrends. Vérifiez que l’utilisateur peut accéder aux moniteurs et fonctionnalités attendus pour son groupe synchronisé. Pour plus d’informations sur les autorisations Uptrends, consultez la vue d’ensemble des autorisations.

Jeton API SCIM

La clé API est le jeton secret que votre IdP utilise pour s’authentifier auprès d’Uptrends. Sans clé API valide, votre IdP ne peut pas synchroniser les utilisateurs et groupes avec les opérateurs et groupes d’opérateurs Uptrends.

Lors de la création de la clé API, notez les points suivants :

• Uptrends affiche la clé API une seule fois, au moment de sa création. Si vous la perdez, vous ne pourrez pas la récupérer plus tard. Révoquez la clé égarée dans l’onglet Gestion des API de l’opérateur du compte de service SCIM afin qu’elle expire immédiatement, puis générez une nouvelle clé API.
• La clé API est valable un an. Après son expiration, votre IdP ne peut plus provisionner d’opérateurs ni de groupes d’opérateurs tant que vous n’avez pas créé une nouvelle clé API et enregistré celle-ci comme jeton secret.
• Notez la date d’expiration et remplacez la clé API avant son expiration. Uptrends n’envoie pas de rappels d’expiration.

Remplacer un jeton

Pour remplacer un jeton, vous devez générer un nouveau jeton. Cette option est uniquement disponible pour le compte de service SCIM.

1. Ouvrez l’opérateur du compte de service SCIM depuis la page Configuration de compte ou depuis Administrateur > Opérateurs et groupes. Sur l’une ou l’autre page, utilisez l’une de ces options :

• Accédez à Paramètres SCIM, puis ouvrez l’opérateur du compte de service.
• Cliquez sur Voir tous les opérateurs, puis ouvrez l’opérateur du compte de service.

2. Accédez à Gestion des API.

3. Cliquez sur Ajouter un jeton Bearer. Le nom de jeton par défaut affiche la date d’expiration.

4. Cliquez sur Créer. Uptrends génère la clé API et l’affiche une seule fois. Copiez-la immédiatement. Elle ne pourra plus être affichée.

5. Dans les paramètres de provisionnement de votre fournisseur d’identité, remplacez le jeton secret précédent par la nouvelle clé API.

Note

La clé API précédente reste valide jusqu’à sa date d’expiration, même après la création d’une nouvelle clé. Mettez à jour le jeton secret dans votre fournisseur d’identité avec la nouvelle clé API, puis révoquez la clé inutilisée dans l’onglet Gestion des API afin qu’elle expire immédiatement. Révoquez-la seulement après avoir enregistré la nouvelle clé, afin que le provisionnement reste actif.

Dépannage

Échec de Test Connection

Si une connexion de test échoue, vérifiez les points suivants :

• Tenant URL correspond à l’endpoint SCIM exact fourni par Uptrends.
• Secret Token est la clé API du compte de service SCIM.

Aucun utilisateur ni groupe n’apparaît dans Uptrends

Si des utilisateurs ou des groupes n’apparaissent pas dans Uptrends après la synchronisation, vérifiez les points suivants :

• Les utilisateurs ou groupes sont attribués à l’application d’entreprise.
• La portée de synchronisation inclut les utilisateurs et groupes attendus.
• La synchronisation initiale est terminée. Consultez les journaux de provisionnement pour rechercher d’éventuels éléments ignorés ou échecs.
• L’utilisateur se trouve dans un groupe IdP attribué à l’application.

Opérateurs ou groupes en double

• Opérateurs : le userName IdP doit correspondre à l’e-mail ou au nom d’utilisateur de l’opérateur existant pour l’adoption.
• Groupes : SCIM n’effectue pas l’adoption par nom d’affichage. Définissez un ID externe correspondant avant le démarrage du provisionnement. Sinon, un nouveau groupe géré par SCIM est créé.

Les utilisateurs ne peuvent pas accéder aux moniteurs après la synchronisation

• SCIM ne définit pas les autorisations. Attribuez les autorisations au groupe géré par SCIM dans Uptrends.