Intégration à Miro Enterprise

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 9 minutes de lecture

    • L’intégration de votre Gestion des actifs logiciels application à l’application Miro Enterprise 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 Miro Enterprise Périmètres d’authentification
    Télécharger les abonnements Administrateur de la société organisations :lire
    Pull user activity (Transférer l’activité utilisateur) Administrateur de la société organisations :lire
    Récupérer l'abonnement Administrateur de la société Aucun

    Créer une Miro Enterprise application OAuth 2.0

    Créez une Miro Enterprise application OAuth 2.0 pour permettre l’accès à l’API Miro .

    Avant de commencer

    Miro Rôle requis : consultez la table Autorisations utilisateur minimales .

    Procédure

    1. À partir d’un navigateur Web, ouvrez la plateforme Miro.
    2. Si vous n’avez pas créé d’équipes au sein de votre organisation ou si vous souhaitez créer et tester l’application OAuth 2.0 à l’aide de données fictives, faites appel à une équipe de développeurs.
    3. Dans l’en-tête de page de la Miro plateforme, sélectionnez Vos applications.
      La page d’inscription s’ouvre.
    4. Connectez-vous à l’aide de vos informations d’identification d’administrateur d’entreprise.
      Votre profil d’organisation par défaut s’ouvre.
    5. En haut du volet de navigation de gauche, sélectionnez l’icône de profil de l’organisation pour sélectionner l’organisation pour laquelle vous souhaitez créer l’application OAuth 2.0.
      Le profil de l’organisation sélectionnée s’ouvre.
    6. Dans le volet de navigation de gauche, sélectionnez Paramètres de profil.
    7. Sélectionnez l’onglet API, SDK & Embed des paramètres de votre profil.
    8. Dans la section Vos applications, cochez la case J’accepte les termes et conditions , puis sélectionnez Créer une application.
    9. Renseignez les champs de la boîte de dialogue.
      Tableau 2. Boîte de dialogue Créer une application
      Champ Description
      Nom de l'application Nom de l’application OAuth 2.0.
      Description Brève description de l’application OAuth 2.0.
    10. Sélectionnez l’équipe pour laquelle vous souhaitez créer l’application OAuth 2.0.
    11. Sélectionnez Créer une application.
      Les paramètres de votre application nouvellement créée s’ouvrent.
    12. Dans la section Votre application <app-name> copiez les valeurs des champs ID client et Secret client .
      Conservez-les dans un endroit sûr pour une utilisation ultérieure.
    13. Dans la section URL de redirection, saisissez l’URL du fournisseur OAuth vers lequel les utilisateurs sont redirigés après l’authentification, puis sélectionnez Ajouter.
      Entrez https:// instance.service-now.com/oauth_redirect.do, où <instance> est le nom de votre ServiceNow instance.
    14. Dans la section Périmètres OAuth, activez le périmètre OAuth organizations :read .
      Les champs d’application OAuth spécifient le niveau d’accès que l’application a à vos ressources protégées. Le périmètre OAuth organizations :read permet à votre application de lire des informations sur vos organisations et les membres de celle-ci.

    Que faire ensuite

    Laissez le profil de votre organisation ouvert afin de pouvoir activer le SCIM (Système de gestion des identités interdomaines) sur votre Miro Enterprise compte. Pour plus d'informations, consultez Activer SCIM sur votre Miro Enterprise compte.

    Activer SCIM sur votre Miro Enterprise compte

    Activez SCIM (Système de gestion des identités interdomaines) sur votre Miro Enterprise compte afin de pouvoir générer un jeton d’accès API pour authentifier vos Miro demandes API.

    Avant de commencer

    Miro Rôle requis : consultez la table Autorisations utilisateur minimales .

    Procédure

    1. Dans le volet de navigation de gauche de votre Miro profil d’organisation, sélectionnez Sécurité.
    2. Sur la page Sécurité, sélectionnez l’option permettant d’activer SSO/SAML.
    3. Une fois SSO/SAML activé, sélectionnez l’option permettant d’activer la mise en service SCIM.
      Miro génère et affiche automatiquement votre jeton d’accès API dans le champ Jeton d’API .
    4. Facultatif : Cochez la case Envoyer des notifications par e-mail aux utilisateurs provisionnés par SCIM pour permettre Miro l’envoi de notifications par e-mail à tous les utilisateurs provisionnés à l’aide de SCIM.
    5. Copiez le jeton d’accès API dans le champ Jeton d’API .
      Conservez-le dans un endroit sécurisé pour une utilisation ultérieure.

    Créer une connexion Miro Enterprise

    Créez une connexion entre vos Miro Enterprise applications et votre ServiceNow instance.

    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 Intégrations , puis recherchez Miro.
    3. Sélectionnez Afficher les détails pour votre Miro Enterprise connexion.
    4. Dans les détails de votre Miro Enterprise connexion, sélectionnez Configurer.
    5. Renseignez les champs de la boîte de dialogue Créer une connexion.
      Tableau 3. Boîte de dialogue Créer une connexion
      Champ Description
      Information de connexion
      Nom de la connexion Nom de la Miro Enterprise connexion. Ce champ se remplit automatiquement.
      Informations d'identification
      ID client OAuth ID client qui est affecté à votre Miro Enterprise application OAuth 2.0.
      Secret client OAuth Clé secrète du client qui est affectée à votre Miro Enterprise application OAuth 2.0.
      URL de redirection OAuth URL du fournisseur OAuth vers lequel les utilisateurs sont redirigés après authentification.

      Ce champ est renseigné automatiquement en fonction de l’URL de redirection que vous avez spécifiée dans Créer une Miro Enterprise application OAuth 2.0.
    6. Sélectionnez Créer et obtenir un jeton OAuth.
      Important :

      Cette étape doit être exécutée par un ServiceNow administrateur ayant le rôle d’administrateur d’entreprise dans Miro.

    7. Dans la boîte de Miro dialogue Autorisation OAuth, localisez l’équipe pour laquelle vous avez créé l’application Miro Enterprise OAuth 2.0, puis sélectionnez Installer.
      Remarque :
      Si une autre ServiceNow instance utilise les mêmes informations d’identification, vous serez invité à la réinstaller.
      Le jeton d’accès OAuth devient disponible pour autoriser votre Miro Enterprise connexion.

    Créer une Miro Enterprise connexion SCIM

    Créez une connexion entre le Miro Enterprise SCIM et votre ServiceNow instance.

    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 Intégrations , puis recherchez Miro.
    3. Sélectionnez Afficher les détails de votre Miro Enterprise connexion SCIM.
    4. Dans les détails de votre Miro Enterprise connexion SCIM, sélectionnez Configurer.
    5. Renseignez les champs de la boîte de dialogue Créer une connexion.
      Tableau 4. Boîte de dialogue Créer une connexion
      Champ Description
      Information de connexion
      Nom de la connexion Nom de la Miro Enterprise connexion SCIM. Ce champ se remplit automatiquement.
      Informations d'identification
      Jeton d'API Jeton d’accès API pour l’authentification des demandes API Miro .

      Entrez le même jeton d’accès API que celui que vous avez généré et copié dans Activer SCIM sur votre Miro Enterprise compte.
    6. Sélectionnez Créer une connexion.

    Créer un profil d'intégration Miro Enterprise

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

    Avant de commencer

    Pour créer un profil d’intégration, demandez le module d’extension Miro EnterpriseGestion 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 Miro 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 Miro Enterprise dans Interface utilisateur principale est inactive.

    Procédure

    1. Accédez au profil d’intégration.
      InterfaceAction
      Interface utilisateur principale
      1. Accédez à la Tous > Actifs Logiciels > Licence SaaS > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez le profil d’intégration Miro Enterprise.
      Espace de travail actifs logiciels
      1. Accédez à la Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez Miro Enterprise dans la liste déroulante.
      4. Sélectionnez Continuer.
    2. Renseignez les champs suivants du formulaire.
      Tableau 5. Formulaire Profil d’intégration
      Champ Description
      Nom d'affichage Nom du profil d’intégration. Par exemple, Miro Enterprise 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 Miro Entreprise.
    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 sur les rôles et les champs d’application requis, 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 au téléchargement Miro.
        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 Récupérer le flux secondaire d’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnement à la récupération Miro.
        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 après avoir rempli tous les champs obligatoires.
      Votre ServiceNow instance crée une ébauche de profil d’intégration.
    5. 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 de téléchargement d’abonnements, mais pas les API de récupération d’abonnements.

    6. Une fois la connexion validée, sélectionnez Publier.
    7. Dans la boîte de dialogue Publier la confirmation, sélectionnez OK.

    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.
    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é.