Partilhar via

Tutorial: Configurar o Miro para provisionamento automático de usuários

  • Artigo

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

Nota

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

Pré-requisitos

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

  • Um inquilino do Microsoft Entra
  • Um inquilino Miro
  • Uma conta de usuário no Miro com permissões de administrador.

Atribuindo usuários ao Miro

O Microsoft Entra ID usa um conceito chamado atribuições para determinar quais usuários devem receber acesso aos 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 Microsoft Entra ID 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 Microsoft Entra ID precisam acessar o Miro. Uma vez decidido, você pode atribuir esses usuários e/ou grupos ao Miro seguindo as instruções aqui:

Dicas importantes para atribuir usuários ao Miro

  • Recomenda-se que um único usuário do Microsoft Entra seja atribuído ao Miro para testar a configuração de provisionamento automático do usuário. Usuários e/ou grupos adicionais podem ser atribuídos posteriormente.

  • Ao atribuir um usuário ao Miro, você deve selecionar qualquer função válida específica do aplicativo (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 Miro. Esse valor será inserido no campo Token secreto na guia Provisionamento do seu aplicativo Miro.

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

Para adicionar Miro 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é Identity>Applications>Enterprise applications>Novo aplicativo.
  3. Na seção Adicionar da galeria, digite Miro na caixa de pesquisa.
  4. Selecione Miro no painel de resultados e, em seguida, adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.

Configurando o provisionamento automático de usuários para Miro

Esta 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 Microsoft Entra ID.

Gorjeta

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

Nota

Para saber mais sobre o endpoint SCIM de Miro, consulte isto.

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

  1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.

  2. Navegue até Aplicativos de identidade>>Aplicativos corporativos

    Painel Aplicações empresariais

  3. Na lista de aplicativos, selecione Miro.

    O link Miro na lista de Aplicações

  4. Selecione o separador Aprovisionamento.

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

  5. Defina o Modo de Aprovisionamento como Automático.

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

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

    URL do locatário + Token

  7. No campo Email de notificação, digite o endereço de e-mail 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 e-mail quando ocorrer uma falha.

    E-mail de Notificação

  8. Clique em Guardar.

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

  10. Analise os atributos de usuário sincronizados do ID do Microsoft Entra para 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 do usuário Miro

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

  12. Analise os atributos de grupo que são sincronizados do ID do Microsoft Entra para 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 de Destino , pois a API Miro SCIM não suporta a criação e exclusão de grupos.

    Atributos do Grupo Miro

  13. Para configurar filtros de âmbito, veja as instruções seguintes disponibilizadas no Tutorial de filtro de âmbito.

  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.

    Estado do Aprovisionamento Ativado

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

    Âmbito de Aprovisionamento

  16. Quando estiver pronto para aprovisionar, clique em Guardar.

    Guardar Configuração de Aprovisionamento

Esta operação inicia a sincronização inicial de todos os usuários e/ou grupos definidos em 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, enquanto o serviço de provisionamento do Microsoft Entra estiver em execução. Você pode usar a seção Detalhes da Sincronização para monitorar o progresso e seguir os 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 de Miro não permite operações de Criação e Exclusão em grupos. Ele suporta apenas a operação de atualização de grupo.

Dicas para resolução de problemas

  • Se tiver erros com a criação de grupos, é necessário desativá-lo desmarcando Criar e Excluir em Ações de Objeto de Destino , pois a API Miro SCIM não suporta a criação e exclusão de grupos.

    Dicas do Grupo Miro

Recursos adicionais

Próximos passos