Intégration avec Miro Enterprise

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 7 minutes de lecture

    • Vous pouvez intégrer votre ServiceNow instance à l’application Miro Enterprise pour suivre vos abonnements logiciels et récupérer les licences inutilisées.

    Créer une Miro Enterprise application OAuth 2.0

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

    Avant de commencer

    Miro Rôle requis : administrateur de l’entreprise

    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, cliquez sur 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, cliquez sur l’icône de profil d’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, cliquez sur Paramètres du profil.
    7. Sélectionnez l’onglet API, SDK et Embed dans les paramètres de votre profil.
    8. Dans la section Vos applications, cochez la case J’accepte les conditions générales , puis cliquez sur Créer une application.
      La boîte de dialogue Créer une application s’ouvre.
    9. Renseignez les champs de la boîte de dialogue.
      Tableau 1. 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. Cliquez sur 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, entrez l’URL du fournisseur OAuth vers lequel les utilisateurs sont redirigés après authentification, puis cliquez sur 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 périmètres 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 les membres de votre organisation.

    Que faire ensuite

    Laissez votre profil d’organisation ouvert afin de pouvoir activer SCIM (System for Cross-domain Identity Management) 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 : administrateur de l’entreprise

    Procédure

    1. Dans le volet de navigation de gauche de votre Miro profil d’organisation, cliquez sur 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 permettre Miro l’envoi de notifications par e-mail à tous les utilisateurs qui ont été mis en service à 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 s’ouvre 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. Dans la boîte de dialogue Créer une connexion, renseignez les champs.
      Tableau 2. 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, 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é à 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 le Miro Enterprise fichier 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 s’ouvre dans un nouvel onglet.
    2. Sélectionnez l’onglet Connexions .
    3. Cliquez sur Afficher les détails de votre Miro Enterprise connexion SCIM.
    4. À partir des détails de votre Miro Enterprise connexion SCIM, cliquez sur Ajouter une connexion.
      La boîte de dialogue Créer une connexion s’ouvre.
    5. Renseignez les champs de la boîte de dialogue.
      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 SCIM. Ce champ se remplit automatiquement.
      Informations d'identification
      Jeton d'API Jeton d’accès d’API pour l’authentification des demandes d’API Miro . 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. Cliquez sur 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) à partir de 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 dans l’interface Miro Enterprise 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 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 4. 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 est défini 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 logicielle.
      Remarque :
      Gestion des actifs logiciels Extrait les événements à partir du moment où vous commencez à télécharger les abonnements des utilisateurs, 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 est défini sur Abonnement de récupération Miro.
    5. Cliquez sur 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 abonnements et Miro Récupérer l’abonnement Miro pour récupérer les données utilisateur de vos Miro applications d’entreprise.
    6. Une fois le formulaire rechargé, cliquez sur Publier.
      La boîte de dialogue Publier la confirmation s’ouvre.
    7. Dans la boîte de dialogue, cliquez sur 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 logicielle.

    Créez des autorisations logicielles pour les modèles logiciels générés automatiquement afin de suivre le logiciel utilisé par rapport au logiciel possédé.
    Le rapprochement s’exécute également sur vos abonnements sous la forme d’une 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 la vue Utilisation de la licence (Software Asset Workspace). Utilisez ces résultats pour déterminer votre position de conformité de licence et pour corriger toute non-conformité.