×

.NET Framework で構築されたアプリケーションについては、こちらをクリックして詳細な手順をご確認ください。

シングルサインオン (SSO) を構成する SAML ID プロバイダーを選択してください

ご利用のIDプロバイダーが見つからない場合は、 aspnetsupport@xecurify.comまでご連絡ください。お客様のIDプロバイダーとのASP.NET Core SSOの設定を迅速にサポートいたします。

IdP が見つかりませんでしたか?

aspnetsupport@xecurify.comまでご連絡いただければ、お客様のIDプロバイダー（IdP）とのASP.NET Core SSOの設定を迅速にサポートいたします。

Azure

セットアップガイド

ビデオガイド

ADFS

セットアップガイド

Auth0

セットアップガイド

ビデオガイド

ピンフェデレート

セットアップガイド

ビデオガイド

セットアップガイド

ビデオガイド

Google Appsの

セットアップガイド

ミニオレンジ

セットアップガイド

Office365

セットアップガイド

Salesforce

セットアップガイド

WordPress

セットアップガイド

OneLogin

クラスリンク

Shibboleth

アジュール B2C

Shopifyサービス

ASP.NET SAML 2.0 コアミドルウェアを構成する手順

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

.NET5以降
NETCore2.1 & .NETCore3.1
NET Frameworkの

NuGetパッケージ
.NET CLI

PM> NuGet\Install-Package miniOrange.SAML.SSO

注： miniOrange ASP.NET SAML SSOミドルウェアをアプリケーションに統合するには、プロジェクトに以下の名前空間、サービス、ミドルウェアを追加する必要があります（緑色でマークされています）。以下にサンプル例を示します。

    
        
        
  
     using miniOrange.saml;
     using System.Reflection;

     public class Startup
     {
       public Startup(IConfiguration configuration)
       {
         Configuration = configuration;
       }
       public IConfiguration Configuration {get;}
       // This method gets called by the runtime. Use this method to add services to the container.
       public void ConfigureServices(IServiceCollection services)
       {
         services.AddRazorPages();
         services.AddminiOrangeServices(Assembly.GetExecutingAssembly());
      }

     // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
       public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
       {
        if (env.IsDevelopment())
        {
         app.UseDeveloperExceptionPage();
        }
        else
        {
         app.UseExceptionHandler("/Error");
      // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
         app.UseHsts();
        }

      app.UseHttpsRedirection();

      app.UseCookiePolicy();
      app.UseAuthentication();
    
      #if NET9_0_OR_GREATER
      app.MapStaticAssets();
      #else
      app.UseStaticFiles();
      #endif

      app.UseminiOrangeSAMLSSOMiddleware();

      app.UseRouting();
      app.UseAuthorization();
      app.UseEndpoints(endpoints =>
      {
        endpoints.MapRazorPages();
      });
     }
   }

    
        
  
    using miniOrange.saml;
    using System.Reflection;

    var builder=WebApplication.CreateBuilder(args);
    

    // Add services to the container.
    builder.Services.AddRazorPages();
    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();

    #if NET9_0_OR_GREATER
    app.MapStaticAssets();
    #else
    app.UseStaticFiles();
    #endif

    app.UseminiOrangeSAMLSSOMiddleware();

    app.Run();

1.ASP.NET Coreアプリケーションにミドルウェアを追加する

統合後、ブラウザを開いて、以下の URL でコネクタダッシュボードを参照します。
https://<asp.net-core-application-base-url>/?ssoaction=config
登録ページまたはログインページが表示されたら、miniOrange ASP.NET Core SAML ミドルウェア認証がアプリケーションに正常に追加されています。

ASP.NET Core SAML シングルサインオン (SSO) | ASP.NET Core 認証 | ASP.NET Core SAML SSO - saml dll レジスタ

をクリックしてアカウントに登録またはログインします。 会員登録する ボタンをクリックしてミドルウェアを設定します。

2. ID プロバイダーを構成する

下 プラグインの設定 タブで、表示されたリストから ID プロバイダーを選択します。

ASP.NET Core SAML シングルサインオン (SSO) | ASP.NET Core 認証 | ASP.NET Core SAML SSO - ID プロバイダーの選択

SAML SP メタデータを取得して ID プロバイダー側で構成するには、以下に XNUMX つの方法を詳しく説明します。

A] SAML メタデータ URL またはメタデータファイルを使用する:

プラグイン設定メニュー、探す サービスプロバイダーの設定。その下に、メタデータ URL と SAML メタデータをダウンロードするオプションがあります。
メタデータ URL をコピーするか、メタデータファイルをダウンロードして、アイデンティティプロバイダー側で同じ設定を行います。
以下のスクリーンショットを参照してください。

ASP.NET Core SAML シングルサインオン (SSO) | ASP.NET Core 認証 | ASP.NET Core SAML SSO - ダウンロードされたメタデータのコピー

B] メタデータを手動でアップロードする:

ノーザンダイバー社の サービスプロバイダーの設定 セクションでは、次のようなサービスプロバイダーのメタデータを手動でコピーできます。 SP エンティティ ID、ACS URL、シングルログアウト URL そして、それを構成のためにアイデンティティプロバイダーと共有します。
以下のスクリーンショットを参照してください。

ASP.NET Core SAML シングルサインオン (SSO) | ASP.NET Core 認証 | ASP.NET Core SAML SSO - 手動メタデータ

3. ASP.NET Core SAML ミドルウェアをサービスプロバイダーとして構成する

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

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

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

ASP.NET Core SAML シングルサインオン (SSO) | ASP.NET Core 認証 | ASP.NET Core SAML SSO - メタデータのアップロード

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

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

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

ASP.NET Core SAML シングルサインオン (SSO) | ASP.NET Core 認証 | ASP.NET Core SAML SSO - SAML DLL 構成

4. SAML SSO のテスト

以下を行うには、 テスト構成 ボタンをクリックして、行った SAML 構成が正しいかどうかをテストします。
以下のスクリーンショットは、成功した結果を示しています。クリック SSO統合 SSO 統合をさらに続行します。

ASP.NET Core SAML シングルサインオン (SSO) | ASP.NET Core 認証 | ASP.NET Core SAML SSO - SAML dll テスト構成

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

ASP.NET Core SAML シングルサインオン (SSO) | ASP.NET Core 認証 | ASP.NET Core SAML SSO - デバッグログを有効にする

エラーのトラブルシューティングを行うには、次の手順に従います。

解決します タブで、プラグインログを受信するためのトグルを有効にします。

有効にすると、次の場所に移動してプラグインログを取得できるようになります。 プラグインの設定 タブをクリックしてクリックします テスト構成.
ダウンロード ログファイル 解決します タブをクリックして、何が問題だったかを確認してください。
あなたは共有することができます ログファイル 私たちと一緒に aspnetsupport@xecurify.com 私たちのチームが問題を解決するためにご連絡いたします。

5. 属性マッピング

構成をテストした後、アプリケーション属性をアイデンティティプロバイダー (IdP) 属性にマップします。
注意： マッピングされたすべての属性はセッションに保存されるため、アプリケーションでアクセスできるようになります。

ASP.NET Core SAML シングルサインオン (SSO) | ASP.NET Core 認証 | ASP.NET Core SAML SSO - 属性マッピング

6. 統合コード

この手順により、アプリケーション内の SSO ユーザー情報をユーザークレームの形式で取得できます。
見ることもできます セットアップツアー SSO 統合が Blazor アプリケーションでどのように機能するかを理解するために。
ユーザー属性にアクセスしたい場所にそのコードスニペットをコピーして貼り付けるだけです。

ASP.NET Core SAML シングルサインオン (SSO) | ASP.NET Core 認証 | ASP.NET Core SAML SSO - 統合コード

注意：この試用版ミドルウェアはクレーム内のユーザー情報のみをサポートしており、セッションおよびヘッダー内のユーザー情報の取得はプレミアムプラグインで利用できます。
以下から統合コードをコピーすることもできます。

          
              
        
      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

7. ログイン設定

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

8. ログアウト設定

SLO を実行するアプリケーションへのリンクとして、次の URL を使用します。
https://base-url/?ssoaction=logout
たとえば、次のように使用できます。
<a href=”https://base-url/?ssoaction=logout”>Log out</a>

IDP を構成するには、appsetting.json ファイルでサービスプロバイダーのメタデータを見つけることができます。 SP メタデータについては、以下のスクリーンショットを参照してください。

ASP.NET Core SAML シングルサインオン (SSO) | ASP.NET Core 認証 | ASP.NET Core SAML SSO - SP メタデータ

miniOrangeセクションから、spendedityidとacsurlをコピーし、IDプロバイダーのチームに提供してください。

サービスプロバイダーのメタデータが IdP 側で構成されると、IdP メタデータファイル、メタデータ URL、または IdP エンティティ ID、IdP SSO URL などのメタデータ URL が提供されます。
IDP メタデータを構成するには、次の場所に移動します。 アプリ設定.json ファイル。 miniorange の JSON セクションには次の設定があります。
IDP を直接設定するには、次の場所に移動します。 アプリ設定.json ファイルにソフトウェアを指定する必要があります。

ASP.NET Core SAML シングルサインオン (SSO) | ASP.NET Core 認証 | ASP.NET Core SAML SSO - IDP メタデータ

提供された適切なメタデータを構成し、設定を保存します。

idp_cert	このフィールドに IDP 証明書を入力します
スール	このフィールドに SSO URL を入力します
idp_issuer	このフィールドに IDP 発行者を入力します

属性マッピング

アプリケーション属性をアイデンティティプロバイダー (IDP) 属性にマップします。
注意： マッピングされたすべての属性はセッションに保存されるため、アプリケーションでアクセスできるようになります。

統合コード

ユーザー属性にアクセスしたい場所にコードスニペットをコピーして貼り付けるだけです。
注意： マッピングされたすべての属性はセッションに保存されるため、アプリケーションでアクセスできるようになります。

string name="";

        string claimtype="";

        string claimvalue="";

        if(User.Identity.IsAuthenticated) { 

          name= User.Identity.Name;

          foreach( var claim in User.Claims) {
        
    claimtype = claim.Type;
        
    claimValue = claim.Value;
        
  }
}

ASP.NET Core SAML シングルサインオン (SSO)ミドルウェアは、ADFS、Azure AD、Bitium、centrify、G Suite、JBoss Keycloak、Okta、OneLogin、Salesforce、AWS Cognito、OpenAM、Oracle、PingFederate、PingOne、RSA SecureID、Shibboleth-2、Shibboleth-3、SimpleSAML、WSO2 などの任意の ID プロバイダー、または独自のカスタム ID プロバイダーで構成できます。ID プロバイダーの一覧はこちらをご覧ください。

その他のリソース

お困りですか？

IDプロバイダーが見つからない場合は、aspnetsupport@xecurify.comまでメールでお問い合わせください。IDPとのSSO設定をサポートし、お客様の要件に関する迅速なガイダンス（メールまたは会議）を提供いたします。また、お客様の要件に最適なソリューション／プランの選択を弊社のチームがお手伝いいたします。

ASP.NET Core SAML シングル サインオン セットアップ ガイド

シングル サインオン (SSO) を構成する SAML ID プロバイダーを選択してください

IdP が見つかりませんでしたか?

ASP.NET SAML 2.0 コアミドルウェアを構成する手順

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

1.ASP.NET Coreアプリケーションにミドルウェアを追加する

2. ID プロバイダーを構成する

A] SAML メタデータ URL またはメタデータ ファイルを使用する:

B] メタデータを手動でアップロードする:

3. ASP.NET Core SAML ミドルウェアをサービス プロバイダーとして構成する

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

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

4. SAML SSO のテスト

5. 属性マッピング

6. 統合コード

7. ログイン設定

8. ログアウト設定

属性マッピング

統合コード

その他のリソース

お困りですか？

ASP.NET Core SAML シングルサインオンセットアップガイド

シングルサインオン (SSO) を構成する SAML ID プロバイダーを選択してください

A] SAML メタデータ URL またはメタデータファイルを使用する:

3. ASP.NET Core SAML ミドルウェアをサービスプロバイダーとして構成する