Integração com Miro Enterprise

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

    • A integração da aplicação Gestão de ativos de software com a aplicação Miro Enterprise permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

    Importante:
    Minimize os riscos de segurança e proteja as informações concedendo acesso somente ao usuário ou às permissões de API necessárias.
    Tabela 1. Permissões mínimas do usuário
    Processo Função do usuário necessária na aplicação Miro Enterprise Escopos de autenticação
    Download de assinaturas Administrador da empresa organizações:ler
    Extrair atividade do usuário Administrador da empresa organizações:ler
    Recuperar assinatura Administrador da empresa Nenhum(a)

    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

    Miro Função necessária: consulte a tabela Permissões mínimas do usuário.

    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, selecione 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, selecione o ícone de 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, selecione 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 selecione Criar novo app.
    9. Na caixa de diálogo, preencha os campos.
      Tabela 2. 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. Selecione 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 selecione 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. Para obter mais informações, consulte Habilitar SCIM na 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

    Miro Função necessária: consulte a tabela Permissões mínimas do usuário.

    Procedimento

    1. No painel de navegação esquerdo do perfil da organização Miro, selecione 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 habilitar Miro para enviar 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

    ServiceNow 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 Integrações e pesquise por Miro.
    3. Selecione Exibir detalhes para sua conexão Miro Enterprise.
    4. Nos detalhes da conexão Miro Enterprise, selecione Configurar.
    5. Na caixa de diálogo Criar conexão, 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 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. Selecione Criar e obter um Token do OAuth.
      Importante:

      Esta etapa deve ser executada por um administrador ServiceNow com a função de administrador da empresa em Miro.

    7. Na caixa de diálogo Miro de autorização do OAuth, localize a equipe para a qual você criou a aplicação Miro Enterprise OAuth 2.0 e selecione Instalar.
      Nota:
      Se outra instância ServiceNow estiver usando as mesmas credenciais, você será solicitado a reinstalar.
      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

    ServiceNow 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 Integrações e pesquise por Miro.
    3. Selecione Exibir detalhes para sua conexão Miro Enterprise SCIM.
    4. Em Miro Enterprise detalhes da conexão do SCIM, selecione Configurar.
    5. Na caixa de diálogo Criar conexão, preencha os campos.
      Tabela 4. 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. Selecione Criar conexão.

    Criação do perfil de Integração Miro Enterprise

    Crie um perfil de integração Miro Enterprise para rastrear assinaturas de software e otimizar o licenciamento de suas aplicações Miro Enterprise.

    Antes de Iniciar

    Para criar um perfil de integração Miro Enterprise, solicite o plug-in Gestão de ativos de software - Gestão de licenças de SaaS (sn_sam_saas_int) na ServiceNow Store.

    ServiceNow Função necessária: sam_integrator ou administrador

    Importante:
    Você deve marcar a caixa de seleção Miro Spoke para esta integração ao instalar recursos opcionais na página Application Manager. Para obter mais informações sobre como escolher as aplicações SaaS necessárias, consulte Solicitação Gestão de licenças de SaaS.

    Por Que e Quando Desempenhar Esta Tarefa

    Se você estiver usando Espaço para ativos de software, a opção para criar o perfil de integração Miro Enterprise em IU principal estará inativa.

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Tudo > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
      2. Selecione Novo.
      3. Selecione Perfil de integração do Miro Enterprise.
      Espaço de ativo do software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração diretos.
      2. Selecione Novo.
      3. Selecione Miro Enterprise na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos a seguir.
      Tabela 5. Formulário Perfil de integração
      Campo Descrição
      Nome para exibição Nome do perfil de integração. Por exemplo, Miro Enterprise Integration.
      Status Status do perfil de integração.
      • Se você não publicou o perfil de integração, este campo será definido automaticamente como Rascunho.
      • Se você já publicou o perfil de integração, este campo será definido automaticamente como Publicado.
      Tipo de Perfil Tipo de perfil de integração.

      Este campo é definido automaticamente como Assinatura do Miro Enterprise.
    3. Revise as funções de usuário necessárias ou as permissões de API especificadas no campo Configuração do fornecedor para cada processo para minimizar os riscos de segurança e otimizar SaaS licenças.
      Nota:
      Para obter mais informações sobre as funções e os escopos necessários, consulte Tabela de permissões mínimas do usuário.
      1. Na seção Subfluxo de assinatura de download, verifique se o campo Subfluxo está definido como Assinaturas de download do Miro.
        Nota:
        A caixa de seleção Baixar assinaturas está marcada por padrão e você não pode desmarcá-la.
      2. Na seção Recuperar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Miro Recuperar assinatura.
        Nota:
        A caixa de seleção Recuperar assinaturas está marcada por padrão. Se você não quiser recuperar assinaturas, poderá desmarcar esta caixa de seleção. Se você desmarcar, os candidatos a remoção serão criados, mas o subfluxo de assinatura de recuperação não será acionado ou o processo de recuperação não será iniciado.
    4. Selecione Salvar depois de preencher todos os campos obrigatórios.
      Sua instância ServiceNow cria um perfil de integração de rascunho.
    5. No formulário de perfil de integração, selecione Validar conexão para verificar os detalhes de conexão e credencial desta integração.

      A validação da conexão verifica as APIs de download de assinaturas, mas não as APIs de recuperação de assinaturas.

    6. Depois que a conexão for validada, selecione Publicar.
    7. Na caixa de diálogo Confirmação de publicação, selecione OK.

    O que Fazer Depois

    Depois que a integração se conecta, sua instância ServiceNow cria automaticamente modelos de software, regras de recuperação e assinaturas de software que são atualizadas diariamente.

    Se você quiser configurar vários perfis de integração com conexões exclusivas, crie aliases secundários para gerenciar diferentes configurações e definições para cada perfil de integração. Para obter mais informações, consulte Crie um alias secundário para configurar vários perfis de integração.

    Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas de usuário. Para obter mais informações, consulte Revisar uma regra de recuperação de software.

    Crie direitos de software para os modelos de software gerados automaticamente para rastrear o software usado em relação ao software de propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licenças (Gestão de ativos de software aplicação clássica) ou na exibição de uso de licença (Software Asset Workspace). Use esses resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade.