Intégration à Roadmunk

L’intégration de votre Gestion des actifs logiciels application à l’application Roadmunk vous permet de suivre vos abonnements logiciels et de récupérer les licences inutilisées.

Important :

Minimisez les risques de sécurité et protégez les informations en accordant l’accès uniquement aux autorisations nécessaires de l’utilisateur ou de l’API.

Tableau 1. Autorisations utilisateur minimales

Processus	Rôle d’utilisateur requis dans l’application Roadmunk	Périmètres d’authentification
Télécharger les abonnements	Administrateur de compte	Aucun champ d’application
Pull user activity (Transférer l’activité utilisateur)	Administrateur de compte	Aucun champ d’application
Récupérer l'abonnement	Administrateur de compte	Aucun champ d’application

Générer un jeton d’accès Roadmunk API

Générez un jeton d’accès API qui autorise l’accès à l’API Roadmunk GraphQL.

Avant de commencer

Roadmunk Rôle requis : Administrateur de compte

Procédure

1. Depuis un navigateur Web, ouvrez Roadmunk.
2. Connectez-vous à l’aide de vos informations d’identification d’administrateur de compte.
3. Dans le menu de navigation de gauche du Roadmunk tableau de bord, sélectionnez votre icône de profil, puis sélectionnez Paramètres du compte.
4. Dans l’en-tête de la page des paramètres de votre compte, sélectionnez l’onglet Intégrations .
5. Sous Intégrations existantes, sélectionnez Ajouter une intégration.
6. Lorsque vous êtes invité à sélectionner une intégration à configurer, sélectionnez Jetons d’API.
7. Sur le formulaire Jetons d’API, saisissez un nom pour votre jeton d’accès Roadmunk API dans le champ Nom de l’application .
8. Sélectionnez Créer un jeton d’API.
   Le jeton d’accès API est généré, puis la boîte de dialogue Jeton d’API créé s’ouvre.
9. Dans la boîte de dialogue Jeton d’API créé, copiez votre jeton d’accès d’API en sélectionnant Copier dans le presse-papiers.
   Conservez-le dans un endroit sécurisé pour une utilisation ultérieure.

Créer une connexion Roadmunk

Créez une connexion entre vos Roadmunk applications et votre ServiceNow instance afin que celle-ci puisse récupérer les données utilisateur de vos applications.

Avant de commencer

ServiceNow Rôle requis : admin

Procédure

1. Depuis votre ServiceNow instance, accédez à Automatisation des processus > Concepteur de flux.
   Flow Designer se lance dans un nouvel onglet.
2. Sélectionnez l’onglet Connexions .
3. Localisez votre Roadmunk connexion, puis sélectionnez Ajouter une connexion.
4. Renseignez les champs de la boîte de dialogue.

   Tableau 2. Boîte de dialogue Créer une connexion

   Champ	Description
   Information de connexion
   Nom de la connexion	Nom de la Roadmunk connexion. Ce champ se remplit automatiquement.
   URL de connexion	URL de connexion. Ce champ est automatiquement défini sur https://app-gateway.roadmunk.com, où application est la région géographique par défaut (Amérique du Nord) dans laquelle la connexion est créée. Si vous créez la connexion en dehors de la région de l’application par défaut (Amérique du Nord), vous pouvez changer la valeur de la région en EU (Europe) ou APAC (région Asie-Pacifique).
   Informations d'identification
   Jeton d'API	Jeton d’accès d’API qui autorise l’accès à l’API Roadmunk GraphQL. Entrez le même jeton d’accès API que celui que vous avez généré dans Générer un jeton d’accès Roadmunk API.

5. Sélectionnez Créer une connexion.

Créer un profil d'intégration Roadmunk

Créez un profil d’intégration Roadmunk pour suivre les abonnements logiciels et optimiser la gestion des licences pour vos Roadmunk applications.

Avant de commencer

Pour créer un profil d’intégration, demandez le module d’extension RoadmunkGestion des actifs logiciels - Gestion des licences SaaS (sn_sam_saas_int) auprès de ServiceNow Store.

ServiceNow Rôle requis : sam_integrator ou admin

Important :

Vous devez cocher la case Spoke Roadmunk pour cette intégration lors de l’installation des fonctionnalités facultatives sur la Application Manager page. Pour plus d’informations sur le choix des applications SaaS requises, reportez-vous à la section Demander le Gestion des licences SaaS.

Pourquoi et quand exécuter cette tâche

Si vous utilisez Software Asset Workspace, l’option de création du profil d’intégration Roadmunk dans Interface utilisateur principale est inactive.

Procédure

1. Accédez au profil d’intégration.

   Interface	Action
   Interface utilisateur principale	Accédez à la Tous > Actifs Logiciels > Licence SaaS > Profils d'intégration directe. Sélectionnez Nouveau. Sélectionnez le profil d’intégration Roadmunk.
   Espace de travail actifs logiciels	Accédez à la Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe. Sélectionnez Nouveau. Sélectionnez Roadmunk dans la liste déroulante. Sélectionnez Continuer.

2. Remplissez les champs du formulaire.

   Tableau 3. Formulaire Profil d’intégration

   Champ	Description
   Nom d'affichage	Nom du profil d’intégration. Par exemple, Intégration Roadmunk.
   Statut	État du profil d'intégration. Si vous n’avez pas publié le profil d’intégration, ce champ est automatiquement défini sur Brouillon. Si vous avez déjà publié le profil d’intégration, ce champ est automatiquement défini sur Publié.
   Type de profil	Type de profil d'intégration. Ce champ est automatiquement défini sur Abonnement Roadmunk.

3. Examinez les rôles d’utilisateur requis ou les autorisations d’API spécifiés dans le champ de configuration du fournisseur pour chaque processus afin de minimiser les risques de sécurité et d’optimiser SaaS les licences.
   Remarque :

   Pour plus d’informations, consultez Table des autorisations utilisateur minimales .
   1. Dans la section Télécharger le flux secondaire d’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnements de téléchargement Roadmunk.
      Remarque :

      La case Télécharger les abonnements est cochée par défaut et vous ne pouvez pas la désactiver.
   2. Dans la section Calculer le flux secondaire d’activité, vérifiez que le champ Flux secondaire est défini sur Roadmunk Mettre à jour l’activité utilisateur.
      Remarque :

      La case Télécharger l’activité est cochée par défaut. Si vous l’effacez, la tâche SAM - Refresh <displayname> Activity planifiée d’activité n’est pas créée.

      Dans le champ Analyser l’activité utilisateur , vous pouvez également sélectionner la date et l’heure à partir desquelles vous souhaitez analyser l’activité utilisateur. Par défaut, vous pouvez analyser l’activité des utilisateurs jusqu’à 60 jours avant la date actuelle et afficher les événements effectués par des utilisateurs individuels à partir du moment où vous créez ce profil.

      Remarque :

      Gestion des actifs logiciels extrait les événements à partir du moment où vous commencez à analyser l’activité de l’utilisateur, quelle que soit la date de création du profil.

      Vous pouvez modifier cette valeur dans le champ Seuil de la dernière activité de vos règles de réclamation de logiciel. Pour plus d'informations, consultez Examiner une règle de réclamation de logiciel.
   3. Dans la section Récupérer le flux secondaire d’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnement à la récupération Roadmunk.
      Remarque :

      La case Récupérer les abonnements est cochée par défaut. Si vous ne souhaitez pas récupérer les abonnements, vous pouvez décocher cette case. Si vous l’effacez, les candidats à la suppression sont créés, mais le flux secondaire d’abonnement de récupération n’est pas déclenché ou le processus de réclamation n’est pas initié.
4. Sélectionnez Enregistrer.

   Votre ServiceNow instance crée une ébauche de profil d’intégration.

   Le champ Connexion et informations d’identification s’affiche et est automatiquement défini sur sn_roadmunk_spoke. Roadmunk.

5. Facultatif : Pour éviter que votre profil d’intégration n’inclue les utilisateurs inactifs dans votre liste d’abonnements Roadmunk , activez le Roadmunk flux secondaire Télécharger les abonnements pour télécharger uniquement les utilisateurs actifs de votre Roadmunk compte.
   Par défaut, le flux secondaire Télécharger Roadmunk les abonnements télécharge tous les utilisateurs de votre Roadmunk compte, y compris les utilisateurs actifs et inactifs.
   1. Dans un nouvel onglet ou une nouvelle fenêtre, ouvrez Roadmunk.
   2. Connectez-vous à l’aide de vos informations d’identification d’administrateur de compte.
      Le Roadmunk tableau de bord s’ouvre.
   3. Dans le menu de navigation de gauche du Roadmunk tableau de bord, sélectionnez votre icône de profil, puis sélectionnez Paramètres du compte.
      Les paramètres de votre compte s’ouvrent.
   4. Dans l’en-tête de la page des paramètres de votre compte, sélectionnez l’onglet Rapports .
   5. Dans la liste des rapports disponibles Roadmunk , sélectionnez Télécharger le CSV utilisateur.
      Le Roadmunk rapport de l’utilisateur se télécharge au format .csv .
   6. Revenez au formulaire Profil d’intégration.
   7. Dans l’en-tête du formulaire, sélectionnez l’icône Gérer les pièces jointes (icône
   8. Dans la boîte de dialogue Pièces jointes, sélectionnez Choisir un fichier à localiser et sélectionnez le rapport d’utilisateur que vous avez téléchargé à l’étape Roadmunke.
   9. Une fois le rapport chargé, fermez la boîte de dialogue pour revenir au formulaire Profil d’intégration.
   Conseil :

   Pour supprimer continuellement les utilisateurs inactifs de votre liste d’abonnements Roadmunk , téléchargez et joignez périodiquement la dernière version du rapport d’utilisateur Roadmunk .
6. Sur le formulaire de profil d’intégration, sélectionnez Valider la connexion pour vérifier les détails de connexion et d’informations d’identification de cette intégration.

   La validation de la connexion vérifie les API Télécharger les abonnements et Calculer l’activité, mais pas les API Récupérer les abonnements.

7. Une fois la connexion vérifiée, sélectionnez Publier.
8. Sélectionnez Publier.
9. Dans la boîte de dialogue Publier la confirmation, sélectionnez OK.
   Remarque :

   Si vous décochez la case Télécharger l’activité après la publication du profil d’intégration, vous devez revalider les connexions, puis republier le profil d’intégration, car les événements suivants se produisent :

   • Le champ État du formulaire de profil d’intégration devient Brouillon.
   • Le bouton Valider la connexion s’affiche sur le formulaire.
   • La tâche actuelle SAM - Refresh <displayname> Activity est supprimée.

Que faire ensuite

Une fois l’intégration connectée, votre ServiceNow instance crée automatiquement des modèles logiciels, des règles de réclamation et des abonnements logiciels qui sont actualisés quotidiennement.

Après avoir créé un profil d’intégration, affichez les informations relatives au profil dans le Software Asset Workspace en accédant à Opérations de licence > Abonnement de l'utilisateur > Profils d'intégration directe. Vous pouvez sélectionner un profil d’intégration pour afficher les listes connexes suivantes. Si toutes les listes connexes suivantes ne sont pas visibles pour un profil d’intégration dans la vue par défaut, vous pouvez sélectionner la vue d’intégration personnalisée dans l’onglet Détails :

• Modèles logiciels
• Identificateurs d'abonnement non reconnus
• Travaux planifiés
• Résultats de la tâche planifiée
• Abonnements logiciels
• Règle d'exclusion de l'identificateur d'abonnement
• Règle d'exclusion de l'utilisateur de l'abonnement

Après avoir créé un profil d’intégration, vous pouvez définir des règles d’exclusion des abonnements afin d’exclure certains abonnements du calcul des coûts de licence. Pour plus d'informations, consultez Exclusions d’abonnements pour SaaS les applications SSO et.

Si vous souhaitez configurer plusieurs profils d’intégration avec des connexions uniques, créez des alias enfants pour gérer différentes configurations et paramètres pour chaque profil d’intégration. Pour plus d'informations, consultez Créer un alias enfant pour configurer plusieurs profils d’intégration.

Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements utilisateur. Pour plus d'informations, consultez Examiner une règle de réclamation de logiciel.

Créez des autorisations logicielles pour les modèles logiciels générés automatiquement afin de suivre les logiciels utilisés par rapport aux logiciels possédés.

• Pour plus d’informations sur la création d’autorisations logicielles dans l’interface Gestion des actifs logiciels utilisateur principale, reportez-vous à la section Créer des autorisations au format Gestion des actifs logiciels classique.
• Pour plus d’informations sur la création d’autorisations logicielles dans Software Asset Workspace, reportez-vous à la section Créer des autorisations dans l’espace de travail.
• Pour plus d’informations sur la création d’autorisations logicielles à l’aide du Gestion des actifs logiciels playbook, reportez-vous à la section Créer des autorisations à l’aide de la visite guidée.

Le rapprochement s’exécute également sur vos abonnements en tant que tâche planifiée ou à la demande. Vous pouvez afficher vos résultats de rapprochement dans la console de licence (Gestion des actifs logiciels application classique) ou dans la vue Utilisation de la licence (Software Asset Workspace). Utilisez ces résultats pour déterminer votre position en matière de conformité de licence et corriger toute non-conformité.

• Pour plus d’informations sur l’exécution du rapprochement dans l’application Gestion des actifs logiciels classique, reportez-vous à la section Exécuter le rapprochement de logiciel au format Gestion des actifs logiciels classique.
• Pour plus d’informations sur l’exécution du rapprochement dans Software Asset Workspace, reportez-vous à la section Exécuter le rapprochement de logiciel dans l’espace de travail.