Configurer le spoke Miro

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 minutes de lecture
  • Intégrez l’instance ServiceNow et Miro créez une application OAuth personnalisée pour Miro authentifier ServiceNow les demandes.

    Avant de commencer

    • Demandez un Hub d'intégration abonnement.
    • Activez le spoke Miro.
    • Miro Rôle requis : administrateur de l’entreprise
    • Rôle requis : admin

    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

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

    Rôle requis : Miro 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

    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.
    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 le Miro Enterprise fichier SCIM et votre ServiceNow instance.

    Avant de commencer

    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.