Guias de configuração de logon único SAML do ASP.NET

Etapa 1: Pré-requisitos: Download e instalação

• Após a integração, abra seu navegador e navegue até o painel do conector com o URL abaixo:
  https://<your-application-base-url>/?ssoaction=config
• Se a página de registro ou de login aparecer, você adicionou com sucesso o conector 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.

Etapa 2: configure seu provedor de identidade

• Você precisa enviar os metadados do seu SP para o seu provedor de identidade. Para metadados do SP, use a URL de metadados do SP ou baixe os metadados do SP como um arquivo .xml e carregue-o no seu IdP. Você pode encontrar ambas as opções em Configurações do provedor de serviços aba.

• Alternativamente, você pode adicionar manualmente o ID da entidade SP e o URL do ACS de Configurações do provedor de serviços guia no plugin para suas configurações de IdP.

Etapa 3: Configurar o ASP.NET como Provedor de Serviços (Módulo SSO)

Observação: Após a instalação do plugin, precisamos configurar a confiança entre seu aplicativo ASP.NET e seu provedor de identidade. Os metadados SAML são compartilhados com o provedor de identidade para que ele possa atualizar sua configuração interna para oferecer suporte ao Single Sign-On.

3.1: Compartilhar metadados SAML com o provedor de identidade

• Clique em Adicionar novo IDP para configurar o ASP.NET Single Sign-On (SSO) usando seu provedor de identidade.

• Debaixo Configurações do provedor de serviços guia, você pode copiar e colar a URL de metadados do seu lado IDP ou baixar os metadados do SP como um arquivo XML. Além disso, você tem a opção de copiar e colar manualmente URL base, ID da entidade SP e URL do ACS.
• Compartilhe metadados SAML com seu provedor de identidade.

3.2: Importar metadados SAML do provedor de identidade

• Selecione seu provedor de identidade na lista exibida.

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.
• 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.

Etapa 4: Testando o SSO SAML

• Antes de testar, certifique-se do seguinte:
• Os metadados SAML do ASP.NET (SP) foram exportados para o provedor de identidade (IDP).
• Importando metadados SAML do provedor de identidade (IDP) no ASP.NET (SP).
• Para testar se a configuração SAML que você fez está correta, passe o mouse sobre Selecionar ações e clique em Configuração de Teste.

• Observação: Na versão de teste do plugin, você só pode configurar e testar um provedor de identidade (IDP).
• A captura de tela abaixo mostra um resultado bem-sucedido. Clique em Pronto 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 guia de soluçã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 do Provedor de Identidade 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.

Etapa 5: Código de Integração

• Esta etapa permite que você especifique o prefixo sso do parâmetro de sessão ou de declarações que será usado para acessar os Atributos do Usuário no seu aplicativo.
• Se você ainda está confuso sobre como funcionam as etapas de integração, dê uma olhada no Tour de configuração.

• Selecione o modo de armazenamento de atributos SSO e você verá agora o código de integração com base no método de autenticação selecionado e no idioma usado pelo seu aplicativo.
• Basta copiar e colar esse trecho de código onde você quiser acessar os atributos do usuário.

• Observação: Este módulo de teste suporta apenas autenticação baseada em sessão e Reivindicações do usuário está disponível no plugin premium.
• Observação: Todos os atributos mapeados serão armazenados na sessão para que você possa acessá-los em seu aplicativo.
• Se você precisar de alguma ajuda em relação ao código de integração, entre em contato conosco em aspnetsupport@xecurify.com

Etapa 6: adicione o seguinte link ao seu aplicativo para Single Sign-On (SSO)

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

• Use o link copiado no aplicativo de onde você deseja executar o SSO:
  https://base-url/?ssoaction=login
• Por exemplo, você pode usá-lo como:
  <a href=”https://base-url/?ssoaction=login”>Log in</a>

Etapa 7: Adicione o seguinte link ao seu aplicativo para SLO

• Use a seguinte URL como um link para seu aplicativo de onde você deseja executar o SLO:
  https://base-url/ssoaction=logout
• Por exemplo, você pode usá-lo como:
  <a href=”https://base-url/ssoaction=logout”>Log out</a>