Compartilhar via


Configurar o Miro para provisionamento automático de usuários com Microsoft Entra ID

O objetivo deste artigo é demonstrar as etapas a serem executadas no Miro e na ID do Microsoft Entra para configurar a ID do Microsoft Entra para provisionar e desprovisionar automaticamente usuários e/ou grupos no Miro.

Observação

Este artigo descreve um conector criado com base no serviço de provisionamento de usuários do Microsoft Entra. Para obter detalhes importantes sobre o que esse serviço faz, como ele funciona e perguntas frequentes, consulte Automatizar o provisionamento e o desprovisionamento de usuários em aplicativos SaaS com a ID do Microsoft Entra.

Pré-requisitos

O cenário descrito neste artigo pressupõe que você já tenha os seguintes pré-requisitos:

Como atribuir usuários ao Miro

A ID do Microsoft Entra usa um conceito chamado atribuições para determinar quais usuários devem receber acesso a aplicativos selecionados. No contexto do provisionamento automático de usuários, somente os usuários e/ou grupos que foram atribuídos a um aplicativo no ID do Microsoft Entra são sincronizados.

Antes de configurar e habilitar o provisionamento automático de usuários, você deve decidir quais usuários e/ou grupos no ID do Microsoft Entra precisam acessar o Miro. Depois de decidir, é possível atribuir esses usuários e/ou grupos ao Miro seguindo estas instruções:

Dicas importantes para atribuir usuários ao Miro

  • É recomendável que um único usuário do Microsoft Entra seja atribuído ao Miro para testar a configuração de provisionamento automático de usuário. Outros usuários e/ou grupos podem ser atribuídos mais tarde.

  • Ao atribuir um usuário ao Miro, é necessário selecionar qualquer função específica ao aplicativo válida (se disponível) na caixa de diálogo de atribuição. Os usuários com a função acesso padrão são excluídos do provisionamento.

Configurar o Miro para provisionamento

Para recuperar o Token Secreto necessário, entre em contato com a equipe de suporte do Miro. Esse valor é inserido no campo Token Secreto na guia Provisionamento do aplicativo Miro.

Antes de configurar o Miro para provisionamento automático de usuários com o ID do Microsoft Entra, você precisa adicionar Miro da galeria de aplicativos do Microsoft Entra à sua lista de aplicativos SaaS gerenciados.

Para adicionar o Miro por meio da galeria de aplicativos do Microsoft Entra, execute as seguintes etapas:

  1. Entre no Centro de administração do Microsoft Entra como pelo menos um Administrador de Aplicativos na Nuvem.
  2. Navegue até Entrar ID>Aplicativos empresariais>Novo aplicativo.
  3. Na seção Adicionar por meio da galeria , digite Miro na caixa de pesquisa.
  4. Selecione Miro no painel de resultados e adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.

Configurar o provisionamento automático de usuário para o Miro

Essa seção orienta você pelas etapas para configurar o serviço de provisionamento do Microsoft Entra para criar, atualizar e desabilitar usuários e/ou grupos no Miro com base em atribuições de usuário e/ou grupo no ID do Microsoft Entra.

Dica

Você também pode optar por habilitar o logon único baseado em SAML para o Miro, seguindo as instruções fornecidas no artigo de logon único do Miro. O logon único pode ser configurado independentemente do provisionamento automático de usuário, embora esses dois recursos sejam complementares.

Observação

Para saber mais sobre o ponto de extremidade SCIM do Miro, consulte este link.

Para configurar o provisionamento automático de usuários para o Miro no ID do Microsoft Entra

  1. Entre no Centro de administração do Microsoft Entra como pelo menos um Administrador de Aplicativos na Nuvem.

  2. Navegar até Entra ID>aplicativos empresariais

    Módulo de aplicativos empresariais

  3. Na lista de aplicativos, selecione Miro.

    O link do Miro na lista aplicativos

  4. Selecione a guia Provisionamento .

    Captura de tela das opções Gerenciar com a opção Provisionamento destacada.

  5. Defina o modo de provisionamento como Automático.

    Captura de tela da lista suspensa Modo de Provisionamento com a opção Automático destacada.

  6. Na seção Credenciais de Administrador, insira https://miro.com/api/v1/scim na URL do Inquilino. Insira o valor do Token de Autenticação SCIM recuperado anteriormente no Token Secreto. Selecione Testar Conexão para garantir que a ID do Microsoft Entra possa se conectar ao Miro. Se a conexão falhar, verifique se a sua conta do Miro tem permissões de administrador e tente novamente.

    URL do Locatário + Token

  7. No campo Email de Notificação , insira o endereço de email de uma pessoa ou grupo que deve receber as notificações de erro de provisionamento e marque a caixa de seleção – Enviar uma notificação por email quando ocorrer uma falha.

    Email de notificação

  8. Selecione Salvar.

  9. Na seção Mapeamentos , selecione Sincronizar usuários do Microsoft Entra com o Miro.

  10. Examine os atributos de usuário sincronizados da ID do Microsoft Entra para o Miro na seção Mapeamento de Atributos . Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário no Miro para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributos de usuário do Miro

  11. Na seção Mapeamentos , selecione Sincronizar grupos do Microsoft Entra com o Miro.

  12. Examine os atributos de grupo que são sincronizados da ID do Microsoft Entra para o Miro na seção Mapeamento de Atributos . Os atributos selecionados como propriedades correspondentes são usados para corresponder aos grupos no Miro para operações de atualização. Selecione o botão Salvar para confirmar as alterações. Desmarque Criar e Excluir em Ações de Objeto Alvo, já que a API SCIM do Miro não dá suporte à criação e exclusão de grupos.

    Atributos do grupo Miro

  13. Para configurar filtros de escopo, consulte as instruções a seguir fornecidas no artigo de filtro de escopo .

  14. Para habilitar o serviço de provisionamento do Microsoft Entra para Miro, altere o Status de Provisionamento para Ativado na seção Configurações .

    Status de provisionamento ativado

  15. Defina os usuários e/ou grupos que você deseja provisionar no Miro escolhendo os valores desejados no Escopo na seção Configurações .

    Escopo de provisionamento

  16. Quando estiver pronto para provisionar, selecione Salvar.

    Salvando a configuração de provisionamento

Essa operação inicia a sincronização inicial de todos os usuários e/ou grupos definidos no Escopo na seção Configurações . A sincronização inicial leva mais tempo para ser executada do que as sincronizações subsequentes, que ocorrem aproximadamente a cada 40 minutos, desde que o serviço de provisionamento do Microsoft Entra esteja em execução. Você pode usar a seção Detalhes de Sincronização para monitorar o progresso e seguir links para o relatório de atividade de provisionamento, que descreve todas as ações executadas pelo serviço de provisionamento do Microsoft Entra no Miro.

Para obter mais informações sobre como ler os logs de provisionamento do Microsoft Entra, consulte Relatórios sobre provisionamento automático de conta de usuário.

Limitações do conector

  • O ponto de extremidade SCIM do Miro não permite operações Criar e Excluir em grupos. Ele só dá suporte à operação de atualização de grupo.

Dicas de solução de problemas

  • Se houver erros com a criação de grupo, será necessário desabilitá-lo desmarcando Criar e Excluir em Ações de Objeto de Destino , pois a API do Miro SCIM não dá suporte à criação e exclusão de grupos.

    Dicas do grupo Miro

Recursos adicionais