Руководства по настройке единого входа (SSO) Blazer SAML

Шаг 1: Предварительные условия: Загрузка и установка

• Установите промежуточное ПО Blazor SAML SSO в пакет вашего приложения, используя пакет 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();
  
  
  

• После интеграции откройте браузер и перейдите на панель управления промежуточным ПО по указанному ниже URL-адресу:
  https://<blazor-application-base-url>/?ssoaction=config
• Если появляется страница регистрации или страница входа в систему, значит, вы успешно добавили промежуточное ПО miniOrange Blazor SAML SSO в свое приложение.

• Зарегистрируйтесь или войдите в свою учетную запись, нажав на кнопку. Зарегистрировать филиал кнопка для настройки промежуточного программного обеспечения.

Шаг 2: Настройка поставщика идентификации

• Вам необходимо отправить метаданные вашего поставщика идентификации. Для отправки метаданных поставщика идентификации используйте URL-адрес метаданных поставщика идентификации или загрузите метаданные поставщика идентификации в виде файла .xml и загрузите его на стороне вашего поставщика идентификации. Оба варианта можно найти в разделе... Настройки поставщика услуг меню.

• В качестве альтернативы вы можете вручную добавить идентификатор сущности SP и URL-адрес ACS. Настройки поставщика услуг вкладка в плагине для настроек вашего поставщика идентификации (IdP).

Шаг 3: Настройка Blazor в качестве поставщика услуг (промежуточное ПО для единого входа).

Примечание: После установки плагина необходимо настроить доверительные отношения между вашим приложением Blazor и поставщиком идентификации. Метаданные SAML передаются поставщику идентификации, чтобы он мог обновить свою встроенную конфигурацию для поддержки единого входа (Single Sign-On).

3.1: Передача метаданных SAML поставщику идентификационных данных

• Нажмите на Добавить нового IDP для настройки единого входа (SSO) Blazor с использованием вашего поставщика идентификации.

• Под Настройки поставщика услуг На вкладке вы можете либо скопировать, либо вставить текст. URL метаданных на вашей стороне IDP или загрузить метаданные SP в виде XML-файла. Кроме того, у вас есть возможность скопировать и вставить его вручную. Базовый URL, Идентификатор объекта SP и URL-адрес СКД.
• Передайте метаданные SAML своему поставщику идентификационных данных.

3.2: Импорт метаданных SAML поставщика идентификации

• Выберите своего поставщика идентификационных данных из представленного списка.

Ниже описаны два способа настройки метаданных поставщика идентификации SAML в промежуточном программном обеспечении.

A] Загрузите метаданные, используя кнопку «Загрузить метаданные IDP»:

• Если ваш поставщик идентификационных данных предоставил вам URL-адрес метаданных или файл метаданных (только в формате .xml), то вы можете просто настроить метаданные поставщика идентификационных данных в промежуточном ПО, используя следующий код: Загрузка метаданных IDP опцию.
• Вы можете ознакомиться с приведенным ниже скриншотом:

• Вы можете выбрать любой из вариантов в зависимости от доступного вам формата метаданных.

B] Настройте метаданные поставщика идентификации вручную:

• После настройки вашего Поставщик удостоверений, это предоставит вам Идентификатор сущности IDP, URL-адрес единого входа IDP и Сертификат SAML X509 поля соответственно.
• Нажмите Сохранено чтобы сохранить данные вашего IDP.

Шаг 4: Тестирование SAML SSO

• Перед тестированием убедитесь в следующем:
• Метаданные Blazor (SP) SAML были экспортированы в поставщика идентификационных данных (IDP).
• Метаданные SAML поставщика идентификационных данных (IDP) импортируются в панель управления SSO Blazor (SP).
• Чтобы проверить правильность вашей конфигурации SAML, наведите курсор на Выберите действия и нажмите на Тестовая конфигурация.

• Примечание: В пробной версии плагина можно настроить и протестировать только одного поставщика идентификационных данных (IDP).
• На скриншоте ниже показан успешный результат. Нажмите на Готово для дальнейшего продолжения интеграции SSO.

• Если на стороне промежуточного программного обеспечения возникнет ошибка, вы увидите окно, похожее на приведенное ниже.

• Для устранения ошибки выполните следующие действия:
• Под Диагностика неисправностей Вкладка, включите переключатель, чтобы получать журналы плагина.


• После включения вы сможете получать журналы плагина, перейдя по адресу... Настройки поставщика идентификации вкладку и нажав на Тестовая конфигурация.
• Скачать журнальный файл из Устранение неполадок Нажмите вкладку, чтобы посмотреть, что пошло не так.
• Вы можете поделиться журнальный файл с нами в aspnetsupport@xecurify.com Наша команда свяжется с вами, чтобы решить вашу проблему.

Шаг 5: Интеграционный код

• Эти шаги позволяют получить информацию о пользователях SSO в вашем приложении в виде пользовательских утверждений.
• Вы также можете посмотреть установка тура чтобы понять, как будет работать интеграция SSO в вашем приложении Blazor.
• Просто скопируйте и вставьте этот фрагмент кода туда, где вам нужно получить доступ к атрибутам пользователя.

• Примечание:В пробной версии плагина промежуточное ПО поддерживает только информацию о пользователе в утверждениях; получение информации о пользователе в сессии и заголовках доступно в платной версии плагина.
• Вы также можете скопировать код интеграции, приведенный ниже:

        

            
      
    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;
    }
    
    
    

• Примечание: Все сопоставленные атрибуты будут храниться в утверждениях, к которым будет осуществляться доступ в вашем приложении.
• Если вам нужна помощь по вопросам интеграции, свяжитесь с нами по адресу [адрес электронной почты]. aspnetsupport@xecurify.com

Шаг 6: Добавьте следующую ссылку в ваше приложение для единого входа (SSO).

• Наведите указатель мыши на Выберите действия и нажмите на Скопировать ссылку SSO.

• Используйте скопированную ссылку в приложении, из которого вы хотите выполнить единый вход (SSO):
  https://base-url/?ssoaction=login&appid=[Your-Application-ID]
• Например, вы можете использовать его следующим образом:
  <a href=”https://base-url/?ssoaction=login”>Log in</a>