Tutorial: integração do logon único (SSO) do Microsoft Entra ao ePlatform
Neste tutorial, você aprenderá a integrar o ePlatform ao Microsoft Entra ID. Ao integrar o ePlatform ao Microsoft Entra ID, você poderá:
- Controlar no Microsoft Entra ID quem tem acesso ao ePlatform.
- Permitir que os usuários entrem automaticamente no ePlatform com suas contas do Microsoft Entra.
- Gerencie suas contas em um local central.
Para saber mais sobre a integração de aplicativos SaaS ao Microsoft Entra ID, confira O que é o acesso de aplicativos e o logon único com o Microsoft Entra ID.
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.
- Assinatura do ePlatform habilitada para SSO (logon único).
Descrição do cenário
Neste tutorial, você vai configurar e testar o SSO do Microsoft Entra em um ambiente de teste.
- O ePlatform dá suporte ao SSO iniciado por IdP
Observação
O identificador desse aplicativo é um valor de cadeia de caracteres fixo; portanto apenas uma instância pode ser configurada em um locatário.
Adicionar ePlatform da galeria
Para configurar a integração do ePlatform com Microsoft Entra ID, é necessário adicionar o ePlatform da galeria à sua lista de aplicativos SaaS gerenciados.
- Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
- Navegue até Identidade>Aplicativos>Aplicativos empresariais>Novo aplicativo.
- Na seção Adicionar por meio da galeria, digite ePlatform na caixa de pesquisa.
- Selecione ePlatform no painel de resultados e, em seguida, 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 logon único do Microsoft Entra para o ePlatform
Configure e teste o SSO do Microsoft Entra com o ePlatform usando um usuário de teste chamado B. Fernandes. Para que o SSO funcione, você precisa estabelecer uma relação de vínculo entre um usuário do Microsoft Entra e o usuário relacionado no ePlatform.
Para configurar e testar o SSO do Microsoft Entra com o SSO do ePlatform, conclua os seguintes blocos de construção:
- Configurar o SSO do Microsoft Entra: para permitir que os usuários usem esse recurso.
- Crie um usuário de teste do Microsoft Entra para testar o logon único do Microsoft Entra com B.Silva.
- Atribuir o usuário de teste do Microsoft Entra – para permitir que B.Fernandes use o logon único do Microsoft Entra.
- Configurar o SSO do ePlatform – para definir as configurações de logon único no lado do aplicativo.
- Criar um usuário de teste do ePlatform – para ter um equivalente de B. Fernandes no ePlatform que esteja vinculado à representação de usuário do Microsoft Entra.
- 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.
Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
Navegue até Identidade>Aplicativos>Aplicativos Empresariais>ePlatform>Logon único.
Na página Selecionar um método de logon único, escolha SAML.
Na página Configurar o logon único com o SAML, clique no ícone de edição/caneta da Configuração Básica do SAML para editar as configurações.
Na seção Configuração Básica de SAML, o aplicativo é pré-configurado e as URLs necessárias já são preenchidas previamente com o Azure. É necessário que o usuário salve a configuração, clicando no botão Salvar.
O aplicativo ePlatform espera as declarações do SAML em um formato específico, o que exige que você adicione mapeamentos de atributo personalizados à configuração dos atributos do token SAML. A captura de tela a seguir mostra a lista de atributos padrão.
Além do indicado acima, o aplicativo ePlatform espera que mais alguns atributos sejam passados novamente na resposta SAML, que são mostrados abaixo. Esses atributos também são pré-populados, mas você pode examiná-los de acordo com seus requisitos.
Nome Atributo de Origem upn user.userprincipalname Na seção Certificado de Autenticação SAML, clique no botão Editar para abrir a caixa de diálogo Certificado de Autenticação SAML.
Na seção Certificado de Autenticação SAML, copie o Valor da Impressão Digital e salve-o em seu computador.
Na seção Configurar o ePlatform, copie as URLs apropriadas de acordo com suas necessidades.
Criar um usuário de teste do Microsoft Entra
Nesta seção, você criará um usuário de teste chamado B.Fernandes.
- Entre no centro de administração do Microsoft Entra como, no mínimo, Administrador de Usuários.
- Navegue até Identidade>Usuários>Todos os usuários.
- Na parte superior da tela, selecione Novo usuário>Criar novo usuário.
- Nas propriedades do Usuário, siga estas etapas:
- No campo Nome de exibição, insira
B.Simon. - No campo Nome principal do usuário, insira o username@companydomain.extension. Por exemplo,
B.Simon@contoso.com. - Marque a caixa de seleção Mostrar senha e, em seguida, anote o valor exibido na caixa Senha.
- Selecione Examinar + criar.
- No campo Nome de exibição, insira
- Selecione Criar.
Atribuir o usuário de teste do Microsoft Entra
Nesta seção, você habilitará B.Simon a usar o logon único concedendo-lhe acesso ao ePlatform.
Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
Navegue até Identidade>Aplicativos>Aplicativos empresariais>ePlatform.
Na página de visão geral do aplicativo, localize a seção Gerenciar e escolha Usuários e grupos.
Escolha Adicionar usuário e, em seguida, Usuários e grupos na caixa de diálogo Adicionar Atribuição.
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.
Se você estiver esperando um valor de função na declaração SAML, na caixa de diálogo Selecionar Função, escolha a função apropriada para o usuário da lista e, em seguida, clique no botão Escolher na parte inferior da tela.
Na caixa de diálogo Adicionar atribuição, clique no botão Atribuir.
Configurar o SSO do ePlatform
Para configurar o logon único no lado do ePlatform, é necessário enviar o Valor da Impressão Digital e as URLs apropriadas copiadas da configuração do aplicativo para a equipe de suporte do ePlatform. Eles definem essa configuração para ter a conexão de SSO de SAML definida corretamente em ambos os lados.
Criar usuário de teste do ePlatform
Nesta seção, você criará um usuário chamado B.Fernandes no ePlatform. Trabalhe com a equipe de suporte do ePlatform para adicionar os usuários na plataforma ePlatform. Os usuários devem ser criados e ativados antes de usar o logon único.
Testar o SSO
Nesta seção, você testará sua configuração de logon único do Microsoft Entra usando o Painel de Acesso.
Ao clicar no bloco do ePlatform no Painel de Acesso, você deverá entrar automaticamente no ePlatform para o qual configurou o SSO. Para saber mais sobre o Painel de Acesso, veja Introdução ao Painel de Acesso.