Guias de configuração do Blazor SAML Single Sign-On (SSO)

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

• Instale o Blazor SAML SSO Middleware no pacote do seu aplicativo usando o pacote nuget

    

        
        
  
  using miniorange.saml
  public class Startup
  {
    public void ConfigureServices(IServiceCollection services)
    {
 
      services.AddSession();
     services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme).AddCookie();
     services.AddControllersWithViews();
    }
    public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
    {
      app.UseHttpsRedirection();
      app.UseStaticFiles();
      app.UseRouting();
      app.UseAuthorization();
      app.MapRazorPages();
  
      app.UseCookiePolicy();
      app.UseAuthentication();
  
      app.UseminiOrangeSAMLSSOMiddleware();
      app.Run();
    }
  }
  
  

    

        
  
  using Microsoft.AspNetCore.Authentication.Cookies;
  using miniOrange.saml;
  
  var builder = WebApplication.CreateBuilder(args);
  
  builder.Services.AddRazorPages();
  // Add authentication services
  builder.Services.AddminiOrangeServices(Assembly.GetExecutingAssembly());
  
  var app = builder.Build();
  
  if (!app.Environment.IsDevelopment())
   {
      app.UseExceptionHandler("/Error");
  
      app.UseHsts();
   }
  
  app.UseHttpsRedirection();
  app.UseRouting();
  app.UseAuthorization();
  app.MapRazorPages();
  
  app.UseCookiePolicy();
  app.UseAuthentication();
  app.UseStaticFiles();
  app.UseminiOrangeSAMLSSOMiddleware();
  app.Run();
  app.useantiforgery();
  
  
  

• Após a integração, abra seu navegador e navegue pelo painel do middleware com a URL abaixo:
  https://<blazor-application-base-url>/?ssoaction=config
• Se a página de registro ou de login aparecer, você adicionou com sucesso o middleware miniOrange Blazor SAML SSO ao seu aplicativo.

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

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 Blazor como Provedor de Serviços (Middleware SSO)

Observação: após a instalação do plugin, precisamos configurar a relação de confiança entre seu aplicativo Blazor 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 e oferecer suporte ao Single Sign-On.

3.1: Compartilhar metadados SAML com o provedor de identidade

• Clique em Adicionar novo IDP para configurar o Blazor 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 middleware.

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 middleware 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 Blazor (SP) foram exportados para o provedor de identidade (IDP).
• Os metadados SAML do Provedor de Identidade (IDP) são importados no painel SSO do Blazor (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 middleware, 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

• Estas etapas permitem que você recupere as informações do usuário SSO em seu aplicativo na forma de declarações de usuário.
• Você também pode olhar o tour de configuração para entender como a integração do SSO funcionaria em seu aplicativo Blazor.
• Basta copiar e colar esse trecho de código onde você quiser acessar os atributos do usuário.

• Observação:Este middleware de teste suporta apenas informações do usuário em reivindicações, recuperando informações do usuário na sessão e cabeçalhos está disponível no plugin premium
• Você também pode copiar o código de integração abaixo:

        

            
      
    string name="";
    string claimtype="";
    string claimvalue="";

    if(User.Identity.IsAuthenticated)
    {
         foreach( var claim  in User.Claims) 
         {
           claimtype = claim.Type;
           claimvalue = claim.Value;
         }
         retrive custom attributes(for eg. Retrieve Mapped 'mobileNumber' attribute of your IDP)
       var identity = (ClaimsIdentity)User.Identity;
       IEnumerable claims = identity.Claims;
       string mobileNumber = identity.FindFirst("mobileNumber")?.Value;
    }
    
    
    

• Observação: Todos os atributos mapeados serão armazenados nas reivindicações para serem acessados ​​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&appid=[Your-Application-ID]
• Por exemplo, você pode usá-lo como:
  <a href=”https://base-url/?ssoaction=login”>Log in</a>