Intégration à Roadmunk

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 8 minutes de lecture

    • 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
    Transmettre par pull 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. À partir d’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 API.
    7. Sur le formulaire Jetons d’API Roadmunk , entrez un nom pour votre jeton d’accès 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 API en sélectionnant Copier dans le presse-papiers.
      Enregistrez-le dans un endroit sécurisé pour une utilisation ultérieure.

    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 Roadmunk , demandez le module d’extension Gestion 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 permettant de créer le profil d’intégration Roadmunk dans Interface utilisateur principale est inactive.

    Procédure

    1. Accédez au profil d’intégration.
      InterfaceAction
      Interface utilisateur principale
      1. Accédez à Tous > Actifs Logiciels > Licence SaaS > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez le profil d’intégration Roadmunk.
      Espace de travail actifs logiciels
      1. Accédez à Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez Roadmunk dans la liste déroulante.
      4. Sélectionnez Continuer.
    2. Remplissez les champs du formulaire.
      Tableau 2. Formulaire Profil d’intégration
      Champ Description
      Nom d'affichage Nom du profil d’intégration. Par exemple, Roadmunk Integration.
      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 la table Autorisations utilisateur minimales .
      1. Dans la section Flux secondaire de téléchargement 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écocher.
      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é de l’utilisateur.
        Remarque :
        La case Télécharger l’activité est cochée par défaut. Si vous l’effacez, le travail SAM - Refresh <displayname> Activity planifié d’activité n’est pas créé.
        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 de l’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnement aux récupérations 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 à la récupération n’est pas déclenché ou le processus de réclamation n’est pas lancé.
    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 sont ouverts.
      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 fichier CSV de l’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 Gérer les pièces jointes).
      8. Dans la boîte de dialogue Pièces jointes, sélectionnez Choisir le fichier à localiser et sélectionnez le rapport de l’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 Roadmunk dernière version du rapport d’utilisateur.
    6. Ouvrez l’enregistrement des alias de connexion et d’informations d’identification en sélectionnant l’icône d’aperçu (icône Aperçu)en regard du champ Connexion et informations d’identification , puis en sélectionnant Ouvrir l’enregistrement dans l’aperçu de l’enregistrement.
    7. Dans le formulaire Alias de connexion et d’informations d’identification, sélectionnez le lien connexe Créer une connexion et des informations d’identification .
    8. Renseignez les champs de la boîte de dialogue Créer une connexion et des informations d’identification.
      Tableau 3. 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 pour la 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
    9. Sélectionnez Créer.
    10. 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.

    11. Une fois la connexion vérifiée, sélectionnez Publier.
    12. Sélectionnez Publier.
    13. 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.

    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éez 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 d’utilisation du logiciel pour les modèles logiciels générés automatiquement afin de comparer les logiciels utilisés aux logiciels possédés.
    Le rapprochement s’exécute également sur vos abonnements en tant que tâche planifiée ou sur demande. Vous pouvez afficher les résultats de votre 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é.