Blazor SAML シングル サインオン (SSO) セットアップ ガイド

ステップ 1: 前提条件: ダウンロードとインストール

• nuget パッケージを使用して、アプリケーション パッケージに Blazor SAML SSO ミドルウェアをインストールします。

    

        
        
  
  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: ID プロバイダーを構成する

• SP メタデータを ID プロバイダーに送信する必要があります。 SP メタデータの場合は、SP メタデータ URL を使用するか、SP メタデータを .xml ファイルとしてダウンロードして IdP 側にアップロードします。 これらのオプションは両方とも、 サービスプロバイダーの設定 タブには何も表示されないことに注意してください。

• または、SP エンティティ ID と ACS URL を手動で追加することもできます。 サービスプロバイダーの設定 プラグイン内のタブを IdP 構成に追加します。

ステップ 3: Blazor をサービス プロバイダー (SSO ミドルウェア) として構成する

注意： プラグインのインストール後、Blazor アプリケーションと ID プロバイダーの間の信頼をセットアップする必要があります。 SAML メタデータは ID プロバイダーと共有されるため、シングル サインオンをサポートするように組み込みの構成を更新できます。

3.1: SAML メタデータを ID プロバイダーと共有する

• ソフトウェアの制限をクリック 新しい IDP を追加 ID プロバイダーを使用して Blazor シングル サインオン (SSO) を構成します。

• サービスプロバイダーの設定 タブでは、コピーして貼り付けることができます。 メタデータ URL IDP 側または SPメタデータをダウンロードする XML ファイルとして。 さらに、手動でコピーして貼り付けることもできます。 Base URL, SPエンティティID, ACSのURL.
• SAML メタデータを ID プロバイダーと共有します。

3.2: ID プロバイダーの SAML メタデータをインポートする

• 表示されたリストから ID プロバイダーを選択します。

ミドルウェアで SAML ID プロバイダーのメタデータを構成するには、以下に詳しく説明する 2 つの方法があります。

A] [IDP メタデータのアップロード] ボタンを使用してメタデータをアップロードします。

• ID プロバイダーからメタデータ URL またはメタデータ ファイル (.xml 形式のみ) が提供されている場合は、 IDPメタデータのアップロード オプションを選択します。
• 以下のスクリーンショットを参照してください。

• 使用可能なメタデータ形式に応じて、オプションのいずれかを選択できます。

B] ID プロバイダーのメタデータを手動で構成します。

• を構成した後 ID プロバイダー、それはあなたに提供します IDPエンティティID、IDPシングルサインオンURL (NAIST) と SAML X509証明書 それぞれフィールド。
• 詳しくはこちら Save IDP の詳細を保存します。

ステップ 4: SAML SSO のテスト

• テストする前に、次のことを確認してください。
• Blazor (SP) SAML メタデータが ID プロバイダー (IDP) にエクスポートされました。
• ID プロバイダー (IDP) SAML メタデータは、Blazor (SP) SSO ダッシュボードにインポートされます。
• 行った SAML 設定が正しいかどうかをテストするには、 アクションの選択 をクリックします。入力したコードが正しければ、MFAの設定は正常に完了します テスト構成.

• 注意： プラグインの試用版では、XNUMX つの ID プロバイダー (IDP) のみを構成およびテストできます。
• 以下のスクリーンショットは、成功した結果を示しています。 クリック クリックします SSO 統合をさらに続行します。

• ミドルウェア側でエラーが発生した場合は、以下のようなウィンドウが表示されます。

• エラーのトラブルシューティングを行うには、次の手順に従います。
• トラブルシューティング タブで、プラグイン ログを受信するためのトグルを有効にします。


• 有効にすると、次の場所に移動してプラグイン ログを取得できるようになります。 ID プロバイダーの設定 タブをクリックしてクリックします テスト構成.
• ダウンロード ログファイル 解決します タブをクリックして、何が問題だったかを確認してください。
• あなたは共有することができます ログファイル 私たちと一緒に 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) 用に次のリンクをアプリケーションに追加します。

• ホバーオン アクションの選択 をクリックします。入力したコードが正しければ、MFAの設定は正常に完了します SSO リンクをコピーする.

• SSO を実行するアプリケーション内のコピーしたリンクを使用します。
  https://base-url/?ssoaction=login&appid=[Your-Application-ID]
• たとえば、次のように使用できます。
  <a href=”https://base-url/?ssoaction=login”>Log in</a>