Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O objetivo deste artigo é 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 artigo descreve um conector baseado no serviço de provisionamento de utilizadores 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 artigo pressupõe que você já tenha os seguintes pré-requisitos:
- Uma conta de usuário do Microsoft Entra com uma assinatura ativa. Se ainda não tiver uma, pode criar uma conta gratuitamente.
- Uma das seguintes funções:
- 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
É 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ários. 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 utilizadores com o papel de Acesso Padrão são excluídos do provisionamento.
Configurar o Miro para o aprovisionamento
Para recuperar o Token Secreto necessário, entre em contato com a Equipe de Suporte Miro. Esse valor é inserido no campo Token secreto na guia Provisionamento do seu aplicativo Miro.
Adicionar Miro da galeria
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:
- Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.
- Navegue até Entra ID>Enterprise apps>Novo aplicativo.
- Na seção Adicionar da galeria, digite Miro na caixa de pesquisa.
- 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 início de sessão único baseado em SAML para o Miro, seguindo as instruções fornecidas no artigo "Miro Início de sessão único". 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
Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.
Navegue para Entra ID>Aplicações empresariais
Na lista de aplicativos, selecione Miro.
Selecione o separador Aprovisionamento.
Selecione + Nova configuração.
Na seção Credenciais do Administrador, insira
https://miro.com/api/v1/scimna URL do locatário. Insira o valor do Token de Autenticação SCIM recuperado anteriormente no Token Secreto. Selecione 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.
Selecione Criar para criar a sua configuração.
Selecione Propriedades na página de Visão Geral.
Selecione o ícone Editar para editar as propriedades. Habilite e-mails de notificação e forneça um e-mail para receber e-mails de quarentena. Ative a opção para evitar eliminação acidental. Selecione Aplicar para salvar as alterações.
Selecione Mapeamento de Atributos no painel esquerdo e selecione utilizadores.
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.
Selecione Grupos.
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.
Para configurar filtros de escopo, consulte as instruções a seguir fornecidas no artigo Filtro de escopo .
Use provisionamento sob demanda para validar a sincronização com um pequeno número de utilizadores antes de uma implementação mais ampla na sua organização.
Quando estiver pronto para provisionar, selecione Iniciar Provisão na página de Visão Geral .
Monitorizar o andamento da implementação
Depois de configurar o provisionamento, use os seguintes recursos para monitorar sua implantação:
- Use os logs de provisionamento para determinar quais usuários são provisionados com ou sem êxito
- Verifique a barra de progresso para ver o status do ciclo de provisionamento e quão perto ele está de ser concluído
- Se a configuração de provisionamento parecer estar em um estado não íntegro, o aplicativo entrará em quarentena. Saiba mais sobre o estado de quarentena no artigo estado de quarentena de aprovisionamento de aplicativos.
Limitações do conector
- O endpoint SCIM do Miro não permite Criar e Eliminar grupos. Suporta apenas a operação Update de grupos.
Dicas para resolução de problemas
Se tiver erros com a criação de grupos, é necessário desativá-los 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.
Recursos adicionais
- Gerir o aprovisionamento de contas de utilizador para Aplicações Empresariais
- O que é acesso ao aplicativo e logon único com o Microsoft Entra ID?