Tutorial: integração do logon único (SSO) do Microsoft Entra com o HeyBuddy
Neste tutorial, você aprenderá como integrar o HeyBuddy com a ID do Microsoft Entra. Ao integrar o HeyBuddy com a ID do Microsoft Entra, você poderá:
- Controlar na ID do Microsoft Entra quem tem acesso ao HeyBuddy.
- Permita que seus usuários façam logon automaticamente no HeyBuddy com suas 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.
- Assinatura habilitada para SSO (logon único) do HeyBuddy.
Descrição do cenário
Neste tutorial, você vai configurar e testar o SSO do Microsoft Entra em um ambiente de teste.
- O HeyBuddy dá suporte ao SSO iniciado por SP
- O HeyBuddy dá suporte ao provisionamento de usuário Just-In-Time
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.
Adicionando HeyBuddy da galeria
Para configurar a integração do HeyBuddy com a ID do Microsoft Entra, você precisará adicionar o HeyBuddy 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 HeyBuddy na caixa de pesquisa.
- Selecione HeyBuddy 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 SSO do Microsoft Entra no HeyBuddy
Configurar e testar o SSO do Microsoft Entra com o HeyBuddy usando um usuário de teste chamado B.Simon. Para que o SSO funcione, você deverá estabelecer uma relação de vínculo entre um usuário do Microsoft Entra e o usuário relacionado do HeyBuddy.
Para configurar e testar o SSO do Microsoft Entra com o HeyBuddy, execute as seguintes etapas:
- 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 HeyBuddy : para definir as configurações de logon único no lado do aplicativo.
- Criar um usuário de teste do HeyBuddy - para ter um equivalente de B.Simon no HeyBuddy 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>HeyBuddy>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 caneta da Configuração Básica do SAML para editar as configurações.
Na seção Configuração Básica do SAML, insira os valores para os seguintes campos:
a. Na caixa de texto URL de Logon, digite uma URL usando o seguinte padrão:
https://api.heybuddy.com/auth/<ENTITY ID>Observação
O valor não é real. Atualize o valor com a URL de Logon real. O valor
Entity IDna URL de Logon é gerado automaticamente para cada organização. Contate a equipe de suporte do Cliente HeyBuddy para obter esses valores.O aplicativo HeyBuddy espera as declarações SAML em um formato específico, o que exige a adição de mapeamentos de atributo personalizado à configuração de atributos de token SAML. A captura de tela a seguir mostra a lista de atributos padrão.
Além do indicado acima, o aplicativo EZOfficeInventory 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 seu requisito.
Nome Atributo de Origem Funções user.assignedroles Observação
Consulte este link sobre como instalar e configurar as funções para o aplicativo.
Na página Configurar o logon único com o SAML, na seção Certificado de Autenticação SAML, clique no botão Copiar para copiar a URL de Metadados de Federação do Aplicativo e salve-a no computador.
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ê permitirá que a usuária B.Fernandes use o logon único, concedendo-lhe acesso ao HeyBuddy.
- Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
- Navegue até Identidade>Aplicativos>Aplicativos Empresariais>HeyBuddy.
- 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ê tiver configurado as funções conforme explicado acima, será possível selecioná-las na lista suspensa Selecionar uma função.
- Na caixa de diálogo Adicionar atribuição, clique no botão Atribuir.
Configurar o SSO do HeyBuddy
Para configurar o logon único no lado do HeyBuddy, é necessário enviar a URL de Metadados de Federação do Aplicativo para a equipe de suporte do HeyBuddy. Eles definem essa configuração para ter a conexão de SSO de SAML definida corretamente em ambos os lados.
Criar um usuário de teste do HeyBuddy
Nesta seção, um usuário chamado Brenda Fernandes será criado no HeyBuddy. O HeyBuddy 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 um usuário ainda não existir no HeyBuddy, um novo será criado após a autenticação.
Observação
Se precisar criar um usuário manualmente, contate a equipe de suporte do HeyBuddy.
Testar o SSO
Nesta seção, você vai testar a configuração de logon único do Microsoft Entra com as opções a seguir.
Selecione Testar este aplicativo. Isso redirecionará você à URL de Logon do HeyBuddy, na qual poderá iniciar o fluxo de logon.
Acesse diretamente a URL de Logon do HeyBuddy, na qual você iniciará o fluxo de logon.
Você pode usar os Meus Aplicativos da Microsoft. Quando clicar no bloco do HeyBuddy em Meus Aplicativos, você será redirecionado para a URL de Logon do HeyBuddy. Para obter mais informações sobre os Meus Aplicativos, confira Introdução aos Meus Aplicativos.
Próximas etapas
Depois de configurar o HeyBuddy, você poderá impor o controle de sessão, que protege contra a exfiltração e infiltração dos dados confidenciais da sua organização em tempo real. O controle da sessão é estendido do acesso condicional. Saiba como impor o controle de sessão com o Microsoft Defender for Cloud Apps.