Compartilhar via

Tutorial: integrar o Miro ao Microsoft Entra ID

  • Artigo

Nesse tutorial, você aprenderá a integrar o Miro ao Microsoft Entra ID. Outra versão deste tutorial pode ser encontrada em help.miro.com. Ao integrar o Miro ao Microsoft Entra ID, será possível:

  • Controlar no Microsoft Entra ID quem tem acesso ao Miro.
  • Permitir que os usuários se conectem automaticamente ao Miro com as respectivas contas do Microsoft Entra.
  • Gerencie suas contas em um local central.

Pré-requisitos

Para começar, você precisará dos seguintes itens:

  • Uma assinatura do Microsoft Entra. Caso você não tenha uma assinatura, obtenha uma conta gratuita.
  • Uma assinatura do Miro com SSO (logon único) habilitado.

Descrição do cenário

Neste tutorial, você vai configurar e testar o SSO do Microsoft Entra em um ambiente de teste.

Para configurar a integração do Miro com o Microsoft Entra ID, será necessário adicionar o Miro por meio da galeria à lista de aplicativos SaaS gerenciados.

  1. Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
  2. Navegue até Identidade>Aplicativos>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.

Opcionalmente, você também pode usar o Assistente de Configuração de Aplicativos do Enterprise. Neste assistente, você pode adicionar um aplicativo ao seu locatário, adicionar usuários/grupos ao aplicativo, atribuir funções, bem como percorrer a configuração de SSO. Saiba mais sobre os assistentes do Microsoft 365.

Configurar e testar o SSO do Microsoft Entra para o Miro

Configure e teste o SSO do Microsoft Entra para o Miro usando um usuário de teste chamado B.Fernandes. Para que o SSO funcione, é necessário estabelecer uma relação de vínculo entre um usuário do Microsoft Entra e o usuário relacionado no Miro.

Para configurar e testar o SSO do Microsoft Entra com o Miro, siga estas etapas:

  1. Configurar o SSO do Microsoft Entra – para permitir que os usuários usem esse recurso.
    1. Crie um usuário de teste do Microsoft Entra para testar o logon único do Microsoft Entra com B.Silva.
    2. Atribuir o usuário de teste do Microsoft Entra – para permitir que B.Fernandes use o logon único do Microsoft Entra.
  2. Configurar o SSO do Miro : para definir as configurações de logon único no lado do aplicativo.
    1. Criar um usuário de teste do Miro – para ter um equivalente de B.Fernandes no Miro que esteja vinculado à representação de usuário do Microsoft Entra.
  3. Testar o SSO – para verificar se a configuração funciona.

Configurar o SSO do Microsoft Entra

Siga estas etapas para habilitar o SSO do Microsoft Entra.

  1. Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.

  2. Navegue até a página de integração de aplicativos Identidade>Aplicativos>Aplicativos empresariais>Miro, localize a seção Gerenciar e selecione Logon único.

  3. Na página Escolher um método de logon único, escolha SAML.

  4. Na página Configurar o Logon Único com o SAML, clique no ícone de caneta da Configuração Básica do SAML para editar as configurações.

    Edit Basic SAML Configuration

  5. Na seção Configuração Básica do SAML, execute a seguinte etapa:

    a. Na caixa de texto Identificador, digite uma das seguintes URLs/padrões:

    Identificador
    https://miro.com/
    https://<SUBDOMAIN>.miro.com/<ORG_ID>/<SAMLSETTINGS_ID>
    https://miro.com/<ORG_ID>/<SAMLSETTINGS_ID>
    https://<SUBDOMAIN>.miro.com/<ORG_ID>

    b. Na caixa de texto URL de resposta, digite uma das seguintes URLs/padrões:

    URL de Resposta
    https://miro.com/sso/saml
    https://<SUBDOMAIN>.miro.com/sso/saml/<ORG_ID>
    https://miro.com/sso/saml/<ORG_ID>/<SAMLSETTINGS_ID>
    https://<SUBDOMAIN>.miro.com/sso/saml/<ORG_ID>/<SAMLSETTINGS_ID>

  6. Execute a etapa a seguir se você quiser configurar o aplicativo no modo SP iniciado:

    Na caixa de texto URL de Logon, digite a URL: https://miro.com/sso/login/

    Observação

    Esses valores não são reais. Atualize esses valores com o Identificador e a URL de Resposta reais. Entre em contato com a equipe de suporte do Miro para obter esses valores. Consulte também os padrões mostrados na seção Configuração Básica do SAML no Centro de administração do Microsoft Entra.

  7. Na página Configurar o Logon Único com SAML, na seção Certificado de Autenticação SAML, localize Certificado (Base64) e escolha Baixar para fazer o download do certificado e salvá-lo no computador. Você precisará dele para configurar o SSO no lado do Miro.

    Screenshot shows the Certificate download link.

  8. Na seção Configurar o Miro, copie a URL de Login. Você precisará dele para configurar o SSO no lado do Miro.

    Screenshot shows to copy Login URL.

Criar um usuário de teste do Microsoft Entra

Nesta seção, você criará um usuário de teste chamado B.Fernandes.

  1. Entre no centro de administração do Microsoft Entra como, no mínimo, Administrador de Usuários.
  2. Navegue até Identidade>Usuários>Todos os usuários.
  3. Na parte superior da tela, selecione Novo usuário>Criar novo usuário.
  4. Nas propriedades do Usuário, siga estas etapas:
    1. No campo Nome de exibição, insira B.Simon.
    2. No campo Nome principal do usuário, insira o username@companydomain.extension. Por exemplo, B.Simon@contoso.com.
    3. Marque a caixa de seleção Mostrar senha e, em seguida, anote o valor exibido na caixa Senha.
    4. Selecione Examinar + criar.
  5. Selecione Criar.

Atribuir o usuário de teste do Microsoft Entra

Nesta seção, você habilitará a B.Simon a usar o logon único permitindo acesso ao Miro.

  1. Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
  2. Navegue até Identidade>Aplicativos>Aplicativos empresariais>Miro.
  3. Na página de visão geral do aplicativo, selecione Usuários e grupos.
  4. Selecione Adicionar usuário/grupo e, em seguida, Usuários e grupos na caixa de diálogo Adicionar atribuição.
    1. Na caixa de diálogo Usuários e grupos, selecione B.Fernandes na lista Usuários e clique no botão Selecionar na parte inferior da tela.
    2. Se você estiver esperando que uma função seja atribuída aos usuários, escolha-a na lista suspensa Selecionar uma função. Se nenhuma função tiver sido configurada para esse aplicativo, você verá a função "Acesso Padrão" selecionada.
    3. Na caixa de diálogo Adicionar atribuição, clique no botão Atribuir.
  • Como alternativa, acesse as Propriedades do aplicativo e desative Atribuição de usuário necessáriaDisable assignment requirement

Configurar o SSO do Miro

Para configurar o logon único no lado do Miro, use o certificado baixado anteriormente e a URL de Logon que você copiou anteriormente. Nas configurações da conta do Miro, acesse a seção Segurança e ative Habilitar SSO/SAML.

  1. Cole a URL de Logon no campo URL de Entrada do SAML.

  2. Abra o arquivo de certificado com um editor de texto e copie a sequência de certificados. Cole a sequência no campo Certificado x509 da Chave. Miro settings

  3. No campo Domínios, digite em seu endereço de domínio, clique em Adicionar e siga o procedimento de verificação. Repita para seus outros endereços de domínio se você tiver algum. O recurso de SSO do Miro funcionará para os usuários finais cujos domínios estão na lista. Domain

  4. Decida se você vai usar o provisionamento Just-In-Time (inserindo seus usuários na sua assinatura durante o registro no Miro) e clique em Salvar para concluir a configuração de SSO no lado do Miro. Just in Time Provisioning

Criar um usuário de teste do Miro

Nesta seção, um usuário chamado B.Fernandes será criado no Miro. O Miro dá suporte ao provisionamento de usuário Just-In-Time, que está habilitado por padrão. Não há itens de ação para você nesta seção. Se o usuário ainda não existir no Miro, um será criado após a autenticação.

Testar o SSO

Nesta seção, você testará a configuração de logon único do Microsoft Entra com as opções a seguir usando o usuário de teste B.Fernandes.

Iniciado por SP:

  • Acesse diretamente a URL de Logon do Miro e inicie o fluxo de logon nela.

Iniciado por IdP:

  • Clique em Testar este aplicativo no portal do Azure e escolha fazer logon como B.Simon. Você deverá ser conectado automaticamente à assinatura do Miro para a qual configurou o SSO.

Use também os Meus Aplicativos da Microsoft para testar o aplicativo em qualquer modo. Quando você clica no bloco do Miro em Meus Aplicativos, se ele estiver configurado no modo SP você será redirecionado para a página de login do aplicativo para iniciar o fluxo de login; se estiver configurado no modo IdP, você entrará automaticamente no Miro para o qual configurou o SSO. Para obter mais informações sobre os Meus Aplicativos, confira Introdução aos Meus Aplicativos.