Guia para configurar o SSO SAML do ASP.NET Framework usando o JumpCloud como IdP

Pré-requisitos: Download e instalação

• Para instalar o Pacote NuGet miniOrange SAML SSO no seu aplicativo .NET, basta instalar o pacote miniOrange NuGet sobre o seu aplicativo.

• Após a instalação, abra seu navegador e navegue até o painel do módulo com o URL abaixo:

 http(s)<your-dotnet-application-base-url>?ssoaction=config


• Se a página de registro ou de login aparecer, você adicionou com sucesso o módulo miniOrange SAML SSO ao seu aplicativo.

• Registre-se ou faça login com sua conta clicando em Registrar-se botão para configurar o módulo.

• Após o registro bem-sucedido, você receberá uma chave de licença de teste no seu endereço de e-mail registrado.

• Para ativar o módulo, você pode:
• Introduzir o chave de licença recebido por e-mail no campo de entrada fornecido.

OR

• Carregue o arquivo de licença que você baixou clicando em Clique aqui botão.

• Em seguida, marque a caixa “Li as condições acima e desejo ativar o módulo” e clique no botão Ativar licença botão.

Há duas maneiras detalhadas abaixo com as quais você pode configurar os metadados do seu Provedor de Identidade SAML no módulo.

A] Carregar metadados usando o botão Carregar metadados do IDP:

• Se o seu provedor de identidade tiver fornecido a URL de metadados ou o arquivo de metadados (somente formato .xml), você poderá simplesmente configurar os metadados do provedor de identidade no módulo usando o Carregar metadados do IDP opção.

• Copie o URL dos metadados ou baixe o arquivo de metadados para configurá-lo no seu provedor de identidade.

• Você pode consultar a captura de tela abaixo:

• Você pode escolher qualquer uma das opções de acordo com o formato de metadados disponível.

B] Configure os metadados do provedor de identidade manualmente:

• Depois de configurar seu Provedor de Identidade, ele irá fornecer a você ID da entidade IDP, URL de logon único do IDP e Certificado SAML X509 campos respectivamente.

• Clique Economize para salvar seus dados de IDP.

3. Testando SAML SSO

• Após carregar os detalhes dos metadados, navegue até Configurações do Provedor de Identidade seção. Passe o mouse sobre o Selecionar ações menu suspenso e clique em Configuração de Teste.

• A captura de tela abaixo mostra um resultado bem-sucedido. Clique em Integração SSO para continuar com a integração do SSO.

• Se você estiver enfrentando algum erro no módulo, será exibida uma janela semelhante à abaixo.

• Para solucionar o erro, siga os passos abaixo:

• Debaixo Resolução de problemas guia, ative a alternância para receber os logs do plugin.

• Uma vez habilitado, você poderá recuperar os logs do plugin navegando até Configurações de Plugin guia e clicando em Configuração de Teste.

• Faça o download do arquivo de log do Resolução de problemas aba para ver o que deu errado.

• Você pode compartilhar o arquivo de log conosco em aspnetsupport@xecurify.com e nossa equipe entrará em contato com você para resolver seu problema.

4. Mapeamento de Atributos

• Depois de testar a configuração, mapeie os atributos do seu aplicativo com os atributos do Provedor de Identidade (IdP).

• No menu à esquerda do módulo miniOrange ASP.NET SAML SSO, clique em Mapeamento de atributos/funções aba conforme mostrado na imagem.

• Se você quiser passar atributos adicionais do seu IdP, insira o Nome do Atributo e o Valor do Atributo correspondente em Mapeamento de atributos personalizados.

• Observação: Todos os atributos mapeados serão armazenados na sessão para que você possa acessá-los em seu aplicativo.

• Depois que os atributos forem mapeados, clique em Salvar mapeamento de atributos para aplicar alterações.

5. Código de Integração

• Estas etapas permitem que você recupere as informações do usuário SSO em seu aplicativo no formato de sessão.

• Você também pode olhar o tour de configuração para entender como a integração SSO funcionaria em seu aplicativo de módulo asp.net.

• Basta copiar e colar esse trecho de código onde você quiser acessar os atributos do usuário.

• Observação: Com o módulo de teste, os detalhes do usuário autenticado são armazenados em variáveis ​​de sessão. Nosso plugin premium oferece suporte para definir declarações de usuário usando autenticação baseada em cabeçalho, cookie de formulário e JWT.

6. Configurações de login

• Passe o mouse sobre Selecionar ações e clique em Copiar link SSO.

• Use o seguinte URL como um link no aplicativo de onde você deseja executar o SSO:

• Por exemplo, você pode usá-lo como:

7. Configurações de logout

• Use a seguinte URL como um link para seu aplicativo de onde você deseja executar o SLO:

• Por exemplo, você pode usá-lo como: