Tutorial: Integração do Microsoft Entra com o Voyance
Neste tutorial, você aprenderá a integrar o Voyance com o Microsoft Entra ID. A integração do Voyance com o Microsoft Entra ID oferece os seguintes benefícios:
- Você pode controlar no Microsoft Entra ID quem tem acesso ao Voyance.
- Você pode permitir que seus usuários entrem automaticamente no Voyance (Single Sign-On) com suas contas do Microsoft Entra.
- Você pode gerenciar suas contas em um local central.
Se você quiser saber mais detalhes sobre a integração de aplicativos SaaS com o Microsoft Entra ID, consulte O que é acesso ao aplicativo e logon único com o Microsoft Entra ID. Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.
Pré-requisitos
Para configurar a integração do Microsoft Entra com o Voyance, você precisa dos seguintes itens:
- Uma assinatura do Microsoft Entra. Se não tiver um ambiente Microsoft Entra, pode obter uma conta gratuita
- Subscrição ativada para início de sessão único do Voyance
Descrição do cenário
Neste tutorial, você configura e testa o logon único do Microsoft Entra em um ambiente de teste.
O Voyance suporta SSO iniciado por SP e IDP
O Voyance suporta o provisionamento de usuários Just In Time
Adicionar Voyance da galeria
Para configurar a integração do Voyance no Microsoft Entra ID, você precisa adicionar o Voyance da galeria à sua lista de aplicativos SaaS gerenciados.
Para adicionar o Voyance da galeria, execute as seguintes etapas:
Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.
Navegue até Identity>Applications>Enterprise applications>Novo aplicativo.
Na caixa de pesquisa, digite Voyance, selecione Voyance no painel de resultados e clique no botão Adicionar para adicionar o aplicativo.
Configurar e testar o logon único do Microsoft Entra
Nesta seção, você configura e testa o logon único do Microsoft Entra com o Voyance com base em um usuário de teste chamado Brenda Fernandes. Para que o logon único funcione, uma relação de vínculo entre um usuário do Microsoft Entra e o usuário relacionado no Voyance precisa ser estabelecida.
Para configurar e testar o logon único do Microsoft Entra com o Voyance, você precisa concluir os seguintes blocos de construção:
- Configure o Microsoft Entra Single Sign-On - para permitir que seus usuários usem esse recurso.
- Configure o Voyance Single Sign-On - para configurar as configurações do Single Sign-On no lado do aplicativo.
- Criar um usuário de teste do Microsoft Entra - para testar o logon único do Microsoft Entra com Brenda Fernandes.
- Atribua o usuário de teste do Microsoft Entra - para permitir que Brenda Fernandes use o logon único do Microsoft Entra.
- Criar usuário de teste Voyance - para ter uma contraparte de Brenda Fernandes no Voyance que está vinculada à representação de usuário do Microsoft Entra.
- Teste o logon único - para verificar se a configuração funciona.
Configurar o logon único do Microsoft Entra
Nesta seção, você habilita o logon único do Microsoft Entra.
Para configurar o logon único do Microsoft Entra com o Voyance, execute as seguintes etapas:
Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.
Navegue até a página de integração de aplicativos Voyance do>Identity>Applications>Enterprise, selecione Logon único.
Na caixa de diálogo Selecionar um método de logon único, selecione o modo SAML/WS-Fed para habilitar o logon único.
Na página Configurar Logon Único com SAML, clique no ícone Editar para abrir a caixa de diálogo Configuração Básica de SAML.
Na seção Configuração Básica do SAML, se desejar configurar o aplicativo no modo iniciado pelo IDP, execute as seguintes etapas:
a. Na caixa de texto Identificador , digite uma URL usando o seguinte padrão:
https://<companyname>.nyansa.com
b. Na caixa de texto URL de resposta, digite uma URL usando o seguinte padrão:
https://<companyname>.nyansa.com/saml/create/
Clique em Definir URLs adicionais e execute a seguinte etapa se desejar configurar o aplicativo no modo iniciado pela controladora de armazenamento :
Na caixa de texto URL de início de sessão, escreva um URL utilizando o seguinte padrão:
https://<companyname>.nyansa.com/
Nota
Estes valores não são reais. Atualize estes valores com o Identificador real, o URL de resposta e o URL de início de sessão. Entre em contato com a equipe de suporte do Voyance Client para obter esses valores. Você também pode consultar os padrões mostrados na seção Configuração Básica de SAML.
Na página Configurar Logon Único com SAML, na seção Certificado de Assinatura SAML, clique em Download para baixar o Certificado (Base64) das opções fornecidas de acordo com sua necessidade e salvá-lo em seu computador.
Na seção Configurar o Voyance, copie o(s) URL(s) apropriado(s) de acordo com sua necessidade.
a. Iniciar Sessão no URL
b. Identificador Microsoft Entra
c. URL de fim de sessão
Configurar o Voyance Single Sign-On
Em uma janela diferente do navegador da Web, faça logon no locatário do Voyance como administrador.
Vá para o canto superior direito da barra de navegação e clique em Perfil.
Clique em Configurações do administrador.
Clique na guia Acesso do Usuário.
Clique no botão SSO is disabled para configurar o Microsoft Entra ID como um IdP usando SAML 2.0.
Vá para a seção SAML v2 e execute as etapas abaixo:
a. Selecione Ativado.
b. Cole o URL de Login na caixa de texto URL de Login do IdP.
c. Abra o certificado codificado Base64 baixado no bloco de notas, copie o conteúdo dele para a área de transferência e cole-o na caixa de texto IdP Cert .
d. Clique em Guardar.
Criar um usuário de teste do Microsoft Entra
O objetivo desta seção é criar um usuário de teste chamado Brenda Fernandes.
- Entre no centro de administração do Microsoft Entra como pelo menos um Administrador de Usuário.
- Navegue até Identidade>de usuários Todos os usuários.>
- Selecione Novo usuário Criar novo usuário>, na parte superior da tela.
- Nas propriedades do usuário , siga estas etapas:
- No campo Nome para exibição , digite
B.Simon
. - No campo Nome principal do usuário, digite o username@companydomain.extensionarquivo . Por exemplo,
B.Simon@contoso.com
. - Marque a caixa de seleção Mostrar senha e anote o valor exibido na caixa Senha .
- Selecione Rever + criar.
- No campo Nome para exibição , digite
- Selecione Criar.
Atribuir o usuário de teste do Microsoft Entra
Nesta seção, você habilita Brenda Fernandes a usar o logon único do Azure concedendo acesso ao Voyance.
Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.
Navegue até Identity>Applications>Enterprise applications>Voyance.
Na lista de aplicativos, selecione Voyance.
Na página de visão geral do aplicativo, selecione Usuários e grupos.
Selecione Adicionar usuário/grupo e, em seguida, selecione Usuários e grupos na caixa de diálogo Adicionar atribuição .
- Na caixa de diálogo Usuários e grupos, selecione B.Simon na lista Usuários e clique no botão Selecionar na parte inferior da tela.
- Se você estiver esperando que uma função seja atribuída aos usuários, poderá selecioná-la na lista suspensa Selecionar uma função . Se nenhuma função tiver sido configurada para este aplicativo, você verá a função "Acesso padrão" selecionada.
- Na caixa de diálogo Adicionar atribuição, clique no botão Atribuir.
Criar usuário de teste do Voyance
Nesta seção, um usuário chamado Britta Simon é criado no Voyance. O Voyance suporta provisionamento de usuário just-in-time, que é habilitado por padrão. Não há nenhum item de ação para você nesta seção. Se um usuário ainda não existir no Voyance, um novo será criado após a autenticação.
Nota
Se você precisar criar um usuário manualmente, você precisa entrar em contato com a equipe de suporte da Voyance.
Testar o início de sessão único
Nesta seção, você testa sua configuração de logon único do Microsoft Entra usando o Painel de Acesso.
Ao clicar no bloco Voyance no Painel de Acesso, você deve entrar automaticamente no Voyance para o qual configurou o SSO. Para obter mais informações sobre o Painel de Acesso, consulte Introdução ao Painel de Acesso.