Contents

IDP として Auth0 を使用した Umbraco SAML シングルサインオン (SSO)

Umbraco SAML シングルサインオン (SSO) プラグインは、UmbracoアプリケーションでSAMLシングルサインオンを有効にする機能を提供します。シングルサインオンを使用すると、Umbracoアプリケーションとサービスにアクセスするために0つのパスワードのみを使用できます。私たちのプラグインは、すべてのSAML準拠のアイデンティティプロバイダーと互換性があります。ここでは、Auth0をIdPとしてUmbracoとAuthXNUMXの間でシングルサインオン（SSO）を構成するためのステップバイステップガイドを紹介します。Umbraco SSOに提供されている機能の詳細については、こちら.

SSO を構成する umbraco バージョンを選択してください:

NuGet パッケージ
.NET CLI

PM> NuGet\Install-Package miniOrange.Umbraco8.SAML.SSO -バージョン 5.4.2

追加 miniorange-saml-sso.dll Umbraco サイトの bin フォルダー (他の DLL ファイルが存在する場所) にあります。
会員登録する ミニオレンジサムルソ umbraco SSOのモジュールを、 統合.md ファイルにソフトウェアを指定する必要があります。
提供された構成ファイルを追加します saml.config umbraco サイトのルートディレクトリにあります。

ダウンロード Umbraco SAML シングルサインオン (SSO) ミドルウェア。
ミドルウェアを設定するには、startup.csファイル（緑色でマークされている）に以下の名前空間、サービス、ミドルウェアを追加する必要があります。以下にサンプル例を示します。

                
            
      
        using miniOrange.saml;
        using System.Reflection;
    
        namespace Application
        {
            public class Startup
            {
    
        // Add services to the container.

        public void ConfigureServices(IServiceCollection services)
        {
          var umbracoBuilder = services.AddUmbraco(_env, _config)
           .AddBackOffice()
           .AddWebsite()
           .AddComposers()

           services.AddminiOrangeServices(Assembly.GetExecutingAssembly());
           umbracoBuilder.Build();
       }

        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {

         if (env.IsDevelopment())
          {
           app.UseDeveloperExceptionPage();
           }
           app.UseUmbraco()
         .WithMiddleware(u =>
        {
          u.UseBackOffice();
          u.UseWebsite();
          u.AppBuilder.UseminiOrangeSAMLSSOMiddleware();
        })

        .WithEndpoints(u =>
        {
          u.UseInstallerEndpoints();
          u.UseBackOfficeEndpoints();
          u.UseWebsiteEndpoints();
        });
      }
    }
   }

構成が完了したら、アプリケーションを実行します。

統合後、ブラウザを開き、以下の URL でプラグインダッシュボードを参照します。 https://<umbraco-middleware-base-url>/?ssoaction=config
登録ページまたはログインページがポップアップ表示されたら、Umbraco アプリケーションに miniOrange Umbraco SAML ミドルウェアが正常に追加されています。

Azure AD を IDP として使用する Umbraco SAML シングルサインオン (SSO) - Umbraco ログインページ

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

ダウンロード Umbraco SAML シングルサインオン (SSO) ミドルウェア。
ミドルウェアを設定するには、program.csファイル（緑色でマークされている）に以下の名前空間、サービス、ミドルウェアを追加する必要があります。以下にサンプル例を示します。

                        
                    
              
                using miniOrange.saml;
                using System.Reflection;
                WebApplicationBuilder builder = WebApplication.CreateBuilder(args);
            
                builder.CreateUmbracoBuilder()
                    .AddBackOffice()
                    .AddWebsite()
                    .AddDeliveryApi()
                    .AddComposers()
                    .Build();
            
                // Add services to the container.
        
                builder.Services.AddminiOrangeServices(Assembly.GetExecutingAssembly());

                WebApplication app = builder.Build();

                await app.BootUmbracoAsync();

                app.UseUmbraco()
                   .WithMiddleware(u =>
                    {
                     u.UseBackOffice();
                     u.UseWebsite();
                     u.AppBuilder.UseminiOrangeSAMLSSOMiddleware();
                     })
        
                     .WithEndpoints(u =>
                     {
                    u.UseBackOfficeEndpoints();
                    u.UseWebsiteEndpoints();
                   });
               await app.RunAsync();

構成が完了したら、アプリケーションを実行します。

統合後、ブラウザを開き、以下の URL でプラグインダッシュボードを参照します。 https://<umbraco-middleware-base-url>/?ssoaction=config
登録ページまたはログインページがポップアップ表示されたら、Umbraco アプリケーションに miniOrange Umbraco SAML ミドルウェアが正常に追加されています。

をクリックしてアカウントに登録またはログインします。 会員登録する プラグインを設定するボタン
登録後、ライセンスキーのアクティベーションページが表示されます。ここで、登録したメールで受け取ったライセンスキーを入力してください。

ライセンスキーを受け取っていない場合はここをクリックしてください

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

Azure AD を IDP として使用する Umbraco SAML シングルサインオン (SSO) - Umbraco SAML 登録

をクリックしてアカウントに登録またはログインします。 会員登録する ボタンを押してモジュールを設定します。

1. Auth0 を IDP として構成する

SAML SP メタデータを取得してアイデンティティプロバイダー側で構成するには、以下の XNUMX つの方法があります。

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

[サービスプロバイダーの設定] セクションで、メタデータ URL と SAML メタデータをダウンロードするオプションを見つけることができます。
メタデータ URL をコピーするか、メタデータファイルをダウンロードして、アイデンティティプロバイダー側で同じ設定を行います。
以下のスクリーンショットを参照してください。

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

[サービスプロバイダーの設定] セクションから、SP エンティティ ID、ACS URL、シングルログアウト URL などのサービスプロバイダーのメタデータを手動でコピーし、それを構成のためにアイデンティティプロバイダーに提供できます。
以下のスクリーンショットを参照してください。

ログイン あなたへ Auth0 ダッシュボード.
ソフトウェアの制限をクリック アプリケーション。

Auth0 を IDP として使用する Umbraco シングルサインオン (SSO) - アプリケーションに移動

ソフトウェアの制限をクリック アプリケーションを作成します。

Auth0 を IDP として使用する Umbraco シングルサインオン (SSO) - アプリケーションの追加または作成

新しいウィンドウがポップアップ表示されます。アプリケーションの名前を入力し、選択します 通常のウェブアプリ。をクリックしてください CREATE

Auth0 を IDP として使用する Umbraco シングルサインオン (SSO) - 通常の Web アプリを選択します

まず アドオン タブには何も表示されないことに注意してください。

Auth0 を IDP として使用する Umbraco シングルサインオン (SSO) - SAML SSO アドオンの選択

有効にする SAML2 アドオンのオプション。「構成」ウィンドウが開きます。

Auth0 を IDP として使用する Umbraco シングルサインオン (SSO) - SAML 2.0 アドオン Web アプリを有効にする

Enter アプリケーションコールバック URL、対象者、受信者 およびその他の設定を使用して SPエンティティID の三脚と ACSのURL 以下に示すようにプラグインからコピーされました。

Auth0 を IDP として使用する Umbraco シングルサインオン (SSO) - プラグインから SP エンティティ ID と URL を追加

下にスクロールしてクリック Save.

Auth0 を IDP として使用する Umbraco シングルサインオン (SSO) - エンティティ ID の保存

に行きます 使用法 タブをクリックして ID プロバイダーのメタデータ ダウンロードリンク。 SAML プラグインのセットアップに必要なメタデータ XML ファイルがダウンロードされます。

Auth0 を IDP として使用する Umbraco シングルサインオン (SSO) - IDP メタデータのダウンロード

Umbraco アプリケーションへの Auth0 SSO ログインを実現するために、Auth0 を SAML IdP (アイデンティティプロバイダー) として正常に構成しました。

2. Umbraco を SP として構成する

モジュールで SAML ID プロバイダーのメタデータを構成するには、以下の XNUMX つの方法があります。

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

アイデンティティプロバイダがメタデータURLまたはメタデータファイル（.xml形式のみ）を提供している場合は、モジュール内でアイデンティティプロバイダメタデータを設定するだけです。 IdPメタデータのアップロード オプションを選択します。
以下のスクリーンショットを参照してください
使用可能なメタデータ形式に応じて、いずれかのオプションを選択できます。

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

を構成した後 ID プロバイダー、それはあなたに提供します IDPエンティティID、IDPシングルサインオンURL の三脚と x.509証明書。これらの値を以下で設定します IDP エンティティ ID、シングルサインオン URL の三脚と SAML X509証明書 それぞれフィールド。
詳しくはこちら Save IDP の詳細を保存します。

Auth0 を IDP として使用する Umbraco シングルサインオン (SSO) - テスト構成

3. SAML SSO のテスト

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

Azure AD を IDP として使用する Umbraco SAML シングルサインオン (SSO) - SAML SSO をテストします

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

Azure AD を IDP として使用する Umbraco SAML シングルサインオン (SSO) - エラーウィンドウ

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

トラブルシューティング タブで、プラグインログを受信するためのトグルを有効にします。

Azure AD を IDP として使用する Umbraco SAML シングルサインオン (SSO) - デバッグログを有効にする

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

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

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

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

トラブルシューティング タブで、プラグインログを受信するためのトグルを有効にします。

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

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

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

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

トラブルシューティング タブで、プラグインログを受信するためのトグルを有効にします。

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

4. ログイン設定

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

Azure AD を IDP として使用する Umbraco SAML シングルサインオン (SSO) - SSO リンクのコピー

SSO を実行するアプリケーション内のコピーしたリンクを使用します。
たとえば、次のように使用できます。
<a href="copied-sso-link”>Login</a>"

SSO を実行するアプリケーション内のリンクとして次の URL を使用します。 https://<umbraco-middleware-base-url>/?ssoaction=login

SSO を実行するアプリケーション内のリンクとして次の URL を使用します。 https://<umbraco-middleware-base-url>/?ssoaction=login

5. ログアウト設定

SLO を実行する Umbraco のリンクとして次の URL を使用します。
https://umbraco-middleware-base-url/?ssoaction=logout
たとえば、次のように使用できます。
<a href="https://umbraco-middleware-base-url/?ssoaction=logout”>Logout</a>"

Umbraco SAML 2.0シングルサインオン（SSO）モジュールは、次のような任意のアイデンティティプロバイダで設定できます。 ADFS、Azure AD、Bitium、Centrify、WordPress、G Suite、JBoss Keycloak、Okta、OneLogin、Salesforce、AWS Cognito、OpenAM、Oracle、PingFederate、PingOne、RSA SecureID、Shibboleth-2、Shibboleth-3、SimpleSAML、WSO2 または独自のカスタム ID プロバイダーを使用することもできます。身分証明書のリストを確認するプロバイダーこちら.

その他のリソース

お困りですか？

ID プロバイダーが見つからない場合は、メールでお問い合わせください umbracosupport@xecurify.com また、お客様の IDP による SSO のセットアップをお手伝いし、お客様の要件に関する迅速なガイダンス (電子メール/会議経由) を提供します。また、当社のチームがお客様の要件に応じて最適なソリューション/プランを選択するお手伝いをします。

Contents

IDP として Auth0 を使用した Umbraco SAML シングル サインオン (SSO)