Configurer le spoke Miro

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 minutes de lecture

    • Intégrez l’instance ServiceNow et Miro en créant une application OAuth personnalisée dans Miro pour authentifier les ServiceNow demandes.

    Avant de commencer

    • Demander un Hub d'intégration abonnement.
    • Activer le spoke Miro.
    • Miro rôle requis : administrateur de la société
    • Rôle requis : administrateur

    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

    Rôle requis : administrateur de l’entreprise Miro .

    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 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 de 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 & Embed des paramètres de votre profil.
    8. Dans la section Vos applications, cochez la case J’accepte les termes et conditions , puis cliquez sur Créer une nouvelle 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 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. Cliquez sur 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 cliquez sur 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.

    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

    Rôle requis : Miro Administrateur de l’entreprise

    Procédure

    1. Dans le volet de navigation de gauche du profil de votre Miro 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é approvisionné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

    Rôle requis : administrateur

    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. Cliquez sur Afficher les détails de votre Miro Enterprise connexion.
    4. Dans les détails de votre Miro Enterprise connexion, 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 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. Cliquez sur Créer et obtenir un jeton OAuth.
      La Miro boîte de dialogue Autorisation OAuth s’ouvre.
    7. Dans la boîte de dialogue, localisez l’équipe pour laquelle vous avez créé l’application Miro Enterprise OAuth 2.0, puis cliquez sur 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 SCIM Miro Enterprise et votre ServiceNow instance.

    Avant de commencer

    Rôle requis : administrateur

    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. 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 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. Cliquez sur Créer une connexion.