Intégration à Miro Enterprise

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 8 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 n’accordant l’accès qu’aux utilisateurs ou aux autorisations d’API nécessaires.
    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
    Extraire 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 : reportez-vous au tableau Autorisations minimales de l’utilisateur .

    Procédure

    1. À partir d’un navigateur Web, ouvrez la plateforme Miro.
    2. Si vous n’avez créé aucune équipe au sein de votre organisation ou si vous souhaitez créer et tester l’application OAuth 2.0 à l’aide de fausses données, faites appel à une équipe de développeurs.
    3. Dans l’en-tête de la 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 de société.
      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 d’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 du 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 nouvelle application.
    9. Renseignez les champs de la boîte de dialogue.
      Tableau 2. Boîte de dialogue Créer une nouvelle 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 l’application que vous venez de créer s’ouvrent.
    12. Dans la section Votre application <nom-application>, 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, entrez l’URL du fournisseur OAuth vers lequel les utilisateurs sont redirigés après authentification, puis sélectionnez Ajouter.
      Saisissez 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 de l’application à vos ressources protégées. Le périmètre OAuth organizations :read permet à votre application de lire des informations sur vos organisations et leurs membres.

    Que faire ensuite

    Gardez le profil de votre organisation ouvert afin de pouvoir activer SCIM (System for Cross-domain Identity Management) 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 (System for Cross-domain Identity Management) sur votre Miro Enterprise compte afin de pouvoir générer un jeton d’accès API pour authentifier vos Miro demandes d’API.

    Avant de commencer

    Miro Rôle requis : reportez-vous au tableau Autorisations minimales de l’utilisateur .

    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 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 approvisionnés par SCIM pour activer Miro l’envoi de notifications par e-mail à tous les utilisateurs qui ont été 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ûr 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. À partir de votre ServiceNow instance, accédez à Automatisation des processus > Concepteur de flux.
      Flow Designer apparaît dans un nouvel onglet.
    2. Sélectionnez l’onglet Connexions .
    3. Sélectionnez Afficher les détails de 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 affecté à votre Miro Enterprise application OAuth 2.0.
      Secret client OAuth Clé secrète du client 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 se remplit 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 disposant du rôle d’administrateur de la société dans Miro.

    7. Dans la boîte de Miro dialogue Autorisation OAuth, recherchez 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é à procéder à une réinstallation.
      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 SCIM Miro Enterprise et votre ServiceNow instance.

    Avant de commencer

    ServiceNow Rôle requis : admin

    Procédure

    1. À partir de votre ServiceNow instance, accédez à Automatisation des processus > Concepteur de flux.
      Flow Designer apparaît dans un nouvel onglet.
    2. Sélectionnez l’onglet Connexions .
    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 Ajouter une connexion.
    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 Miro demandes API.

      Saisissez 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 profil d’intégration Miro 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 Miro Enterprise , demandez le module d’extension Gestion des actifs logiciels - Gestion des licences SaaS (com.sn_sam_saas_int) auprès du ServiceNow Store.

    ServiceNow Rôle requis : sam_integrator ou admin

    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 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 Tout > 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 des ressources logicielles
      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 Enterprise.
    3. Dans l’onglet Télécharger le flux secondaire d’abonnement , vérifiez que le champ Connexion et informations d’identification est défini sur sn_miro_spoke. Miro_Enterprise et le champ Flux secondaire sont définis sur Abonnements de téléchargement Miro.
      Vous pouvez afficher les événements effectués par des utilisateurs individuels jusqu’à un an avant la date actuelle. Pour plus d'informations, consultez Réviser une règle de réclamation de logiciel.
      Remarque :
      Gestion des actifs logiciels Extrait les événements à partir du moment où vous commencez à télécharger les abonnements utilisateur, quelle que soit la date de création du profil.
    4. Dans l’onglet Récupérer le flux secondaire d’abonnement , vérifiez que le champ Connexion et informations d’identification est défini sur sn_miro_spoke. Miro_Enterprise_SCIM et le champ Flux secondaire sont définis sur Abonnement de récupération Miro.
    5. Sélectionnez Enregistrer.
      Votre ServiceNow instance crée une ébauche de profil d’intégration. Le profil d’intégration utilise les flux secondaires Télécharger les Miro abonnements et Miro Récupérer les abonnements pour récupérer les données utilisateur de vos Miro applications d’entreprise.
    6. Une fois le formulaire rechargé, sélectionnez Publier.
      La boîte de dialogue Publier la confirmation s’ouvre.
    7. Dans la boîte de dialogue, 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 utilisateur qui sont actualisés quotidiennement.

    Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements des utilisateurs. Pour plus d'informations, consultez Réviser 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 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 de conformité de licence et pour remédier à toute non-conformité.