Configurar o spoke do Miro

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura

    • Integre a instância ServiceNow e Miro criando uma aplicação OAuth personalizada em Miro para autenticar solicitações ServiceNow.

    Antes de Iniciar

    • Solicitar uma assinatura de Integration Hub.
    • Ative o spoke do Miro.
    • Função necessária:
      • Administrador da ServiceNow
      • Miro Administrador da empresa

    Criar uma Miro Enterprise aplicação OAuth 2.0

    Crie uma aplicação Miro Enterprise OAuth 2.0 para habilitar o acesso à API Miro.

    Antes de Iniciar

    Função necessária: Miro administrador da empresa.

    Procedimento

    1. Em um navegador da Web, abra a Plataforma Miro.
    2. Se você não criou nenhuma equipe em sua organização ou deseja criar e testar a aplicação OAuth 2.0 usando dados falsos, contrate uma equipe de desenvolvedores.
    3. No cabeçalho da página da Plataforma Miro, clique em Seus apps.
      A página de inscrição é aberta.
    4. Entre usando suas credenciais de administrador da empresa.
      O perfil da organização padrão é aberto.
    5. Na parte superior do painel de navegação esquerdo, clique no ícone do perfil da organização para selecionar a organização para a qual você deseja criar a aplicação OAuth 2.0.
      O perfil da organização selecionada é aberto.
    6. No painel de navegação esquerdo, clique em Configurações de perfil.
    7. Selecione a guia API, SDK e incorporação das configurações do seu perfil.
    8. Na seção Seus apps, marque a caixa de seleção Concordo com os Termos e Condições e clique em Criar novo app.
      A caixa de diálogo Criar novo app é aberta.
    9. Na caixa de diálogo, preencha os campos.
      Tabela 1. Caixa de diálogo Criar nova aplicação
      Campo Descrição
      Nome da app Nome da aplicação OAuth 2.0.
      Descrição Breve descrição da aplicação OAuth 2.0.
    10. Selecione a equipe para a qual você deseja criar a aplicação OAuth 2.0.
    11. Clique em Criar app.
      As configurações do app recém-criado são abertas.
    12. Na seção Seu app <app-name>, copie os valores nos campos ID do cliente e Segredo do cliente.
      Salve-os em um local seguro para uso posterior.
    13. Na seção Redirecionar URLs, insira a URL do provedor OAuth para o qual os usuários são redirecionados após a autenticação e clique em Adicionar.
      Insira https://instance.service-now.com/oauth_redirect.do, em que <instance> é o nome da sua instância ServiceNow.
    14. Na seção Escopos do OAuth, habilite o escopo organizações:read OAuth.
      Os escopos do OAuth especificam o nível de acesso que a aplicação tem aos recursos protegidos. O escopo OAuth organizações:read permite que sua aplicação leia informações sobre suas organizações e membros da organização.

    O que Fazer Depois

    Mantenha o perfil da sua organização aberto para que você possa habilitar o SCIM (Sistema para Gestão de identidade entre domínios) em sua conta Miro Enterprise.

    Habilitar SCIM na sua conta Miro Enterprise

    Habilite o SCIM (Sistema para Gestão de identidade entre domínios) em sua conta Miro Enterprise para que você possa gerar um token de acesso de API para autenticar suas solicitações de API Miro.

    Antes de Iniciar

    Função necessária: Miro Administrador da empresa

    Procedimento

    1. No painel de navegação esquerdo do perfil da organização Miro, clique em Segurança.
    2. Na página Segurança, selecione a opção para Habilitar SSO/SAML.
    3. Depois que o SSO/SAML estiver habilitado, selecione a opção para habilitar o Provisionamento de SCIM.
      Miro gera e exibe automaticamente seu token de acesso de API no campo Token de API.
    4. Opcional: Marque a caixa de seleção Enviar notificações por e-mail para usuários provisionados pelo SCIM para permitir que Miro envie notificações por e-mail a todos os usuários que foram provisionados usando o SCIM.
    5. Copie o token de acesso de API no campo Token de API.
      Salve-o em um local seguro para uso posterior.

    Criar uma conexão do Miro Enterprise

    Crie uma conexão entre suas aplicações Miro Enterprise e sua instância ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Em sua instância ServiceNow, navegue até Automação de Processo > Flow Designer.
      O Flow Designer é iniciado em uma nova guia.
    2. Selecione a guia Conexões.
    3. Clique em Exibir detalhes da conexão Miro Enterprise.
    4. Em seus detalhes de conexão Miro Enterprise, clique em Adicionar conexão.
      A caixa de diálogo Criar conexão é aberta.
    5. Na caixa de diálogo, preencha os campos.
      Tabela 2. Caixa de diálogo Criar conexão
      Campo Descrição
      Informação de conexão
      Nome da Conexão Nome da conexão Miro Enterprise. Este campo é preenchido automaticamente.
      Informações de credencial
      ID do cliente do OAuth ID de cliente atribuído à sua aplicação Miro Enterprise OAuth 2.0.
      Segredo do cliente do OAuth Segredo do cliente atribuído à sua aplicação Miro Enterprise OAuth 2.0.
      URL de redirecionamento do OAuth URL do provedor OAuth para o qual os usuários são redirecionados após a autenticação. Este campo é preenchido automaticamente com base no URL de redirecionamento que você especificou em Criar uma Miro Enterprise aplicação OAuth 2.0.
    6. Clique em Criar e obter token do OAuth.
      A caixa de diálogo Miro de autorização do OAuth é aberta.
    7. Na caixa de diálogo, localize a equipe para a qual você criou a aplicação Miro Enterprise OAuth 2.0 e clique em Instalar.
      O token de acesso OAuth se torna disponível para autorizar sua conexão Miro Enterprise.

    Criar uma Miro Enterprise conexão SCIM

    Crie uma conexão entre o Miro Enterprise SCIM e sua instância ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Em sua instância ServiceNow, navegue até Automação de Processo > Flow Designer.
      O Flow Designer é iniciado em uma nova guia.
    2. Selecione a guia Conexões.
    3. Clique em Exibir detalhes da sua Miro Enterprise conexão SCIM.
    4. Em Miro Enterprise detalhes da conexão SCIM, clique em Adicionar conexão.
      A caixa de diálogo Criar conexão é aberta.
    5. Na caixa de diálogo, preencha os campos.
      Tabela 3. Caixa de diálogo Criar conexão
      Campo Descrição
      Informação de conexão
      Nome da Conexão Nome da Miro Enterprise conexão SCIM. Este campo é preenchido automaticamente.
      Informações de credencial
      Token de API Token de acesso de API para autenticar Miro solicitações de API. Insira o mesmo token de acesso de API que você gerou e copiou em Habilitar SCIM na sua conta Miro Enterprise.
    6. Clique em Criar Conexão.