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

nopCommerce SAML シングル サインオン (SSO) このプラグインは、nopCommerce アプリケーションの SAML シングル サインオンを有効にする機能を提供します。 シングル サインオンを使用すると、nopCommerce アプリケーションとサービスにアクセスするために XNUMX つのパスワードだけを使用できます。 私たちのプラグインは、SAML 準拠のすべての ID プロバイダーと互換性があります。 ここでは、Keycloak を IdP として考慮して、nopCommerce と Keycloak の間でシングル サインオン (SSO) を構成するためのステップバイステップ ガイドを説明します。 nopCommerce SSO に提供される機能の詳細については、ここをクリックしてください。 こちら.

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

nopCommerce ダッシュボードからダウンロード

• プラグイン zip をダウンロードするには、nopCommerce ストアに管理者としてログインします。 管理者ダッシュボードで、次の場所に移動します。 「構成」タブ > すべてのプラグイン とテーマ、または検索 すべてのプラグインとテーマ 管理者の検索バーにあります。
• 検索 SAML シングル サインオン (SSO) - miniOrange プラグインを選択し、 ダウンロード ボタンを押してジッパーを取得します。


nopCommerce マーケットプレイスから

• プラグインの zip ファイルは nopCommerce ストアからダウンロードできます - nopCommerce SAML シングル サインオン (SSO)
• プラグインをインストールするには、nopCommerce Web サイトに管理者としてログインします。 管理者ダッシュボードで、次の場所に移動します。 設定タブ >> ローカルプラグイン.
• ページの右上隅で、 プラグインまたはテーマをアップロードする ボタンをクリックして、ダウンロードしたプラグイン zip をアップロードします。 さらに指示に従ってプラグインをインストールします。

Keycloakをアイデンティティプロバイダとして使用してnopCommerceシングルサインオン(SSO)を構成する手順

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

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

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

• バージョン18以下
• バージョン19以降

Keycloak 内で コンソールで、使用するレルムを選択します。
ソフトウェアの制限をクリック 取引実績 左側のメニューから をクリックし、 創造する ボタンをクリックして、新しいクライアント/アプリケーションを作成します。

入力します SP-EntityID / 発行者 として 顧客ID 「サービスプロバイダーメタデータ」タブから選択し、 SAML として クライアントプロトコル.

今後はクリック Save.
必要な詳細を指定して Keycloak を構成します。
顧客ID	SP-EntityID / 発行者 プラグインのサービスプロバイダーメタデータタブから
名前	このクライアントの名前を入力してください
説明	説明を入力してください
クライアントの署名が必要です	オフ
POSTバインディングを強制する	オフ
強制名 ID 形式	オフ
名前ID形式	メール
ルートURL	空のままにするか、サービス プロバイダーの [メタデータ] タブからベース URL を指定します
有効なリダイレクト URI	ACS (アサーション コンシューマ サービス) URL プラグインのサービスプロバイダーメタデータタブから

きめ細かい SAML エンドポイント構成, 次の詳細を入力します。
アサーション コンシューマ サービス POST バインディング URL	ACS (アサーション コンシューマ サービス) URL プラグインのサービスプロバイダーメタデータタブから
ログアウトサービスリダイレクトバインドURL （オプション）	シングル ログアウト URL プラグインのサービスプロバイダーメタデータタブから

ソフトウェアの制限をクリック Save.
Keycloak 内で コンソールで、使用するレルムを選択します。
ソフトウェアの制限をクリック 取引実績 左側のメニューから をクリックし、 クライアントの作成 ボタンをクリックして、新しいクライアント/アプリケーションを作成します。

選択 SAML as クライアントタイプ、 入力 SP-EntityID / 発行者 として 顧客ID [サービス プロバイダー メタデータ] タブで、アプリケーションの名前を入力し、説明を入力します。

今後はクリック Save.
必要な詳細を指定して Keycloak を構成します。
顧客ID	SP-EntityID / 発行者 プラグインのサービスプロバイダーメタデータタブから
名前	このクライアントの名前を入力してください
説明	説明を入力してください
クライアントの署名が必要です	オフ
POSTバインディングを強制する	オフ
強制名 ID 形式	オフ
名前ID形式	メール
ルートURL	空のままにするか、サービス プロバイダーの [メタデータ] タブからベース URL を指定します
有効なリダイレクト URI	ACS (アサーション コンシューマ サービス) URLプラグインのサービスプロバイダーメタデータタブから

今後はクリック Save.
In 高機能 タブの下 きめ細かい SAML エンドポイント構成, 次の詳細を入力します。
アサーション コンシューマ サービス POST バインディング URL	ACS (アサーション コンシューマ サービス) URL プラグインのサービスプロバイダーメタデータタブから
ログアウトサービスリダイレクトバインドURL （オプション）	シングル ログアウト URL プラグインのサービスプロバイダーメタデータタブから

ソフトウェアの制限をクリック Save.

Keycloak ログイン / Keycloak SSO / Keycloak シングル サインオン (SSO) を実現するための SAML IdP (アイデンティティ プロバイダー) として Keycloak を正常に設定し、nopCommerce アプリケーションへの安全なログインを確保しました。

2. nopCommerce を SP (SSO プラグイン) として構成する

注： プラグインのインストール後、nopCommerce アプリケーションと Keycloak アカウントの間に信頼を設定する必要があります。 SAML メタデータは Keycloak と共有されるため、シングル サインオンをサポートするように組み込み設定を更新できます。

2.1: SP SAML メタデータを Keycloak と共有する

• ソフトウェアの制限をクリック 新しい IDP を追加 Keycloak を IDP として使用して nopCommerce シングル サインオン (SSO) を設定します。

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

2.2: Keycloak SAML メタデータのインポート

• ID プロバイダーの設定 タブ、選択 キークローク 優先する ID プロバイダーとして。

• nopCommerce をサービス プロバイダーとして構成するには XNUMX つの方法があります。
• IDP のメタデータをアップロードするには、次のいずれかを指定できます。 メタデータ URL or XMLファイルをアップロードする.

• あるいは、 ID プロバイダーの設定 タブでは、次のような必須フィールドを手動で入力できます。 IDP名, IDP エンティティ ID & シングルサインオンURL ヒット Save.

3. SAML SSO のテスト

• テストする前に、次のことを確認してください。
• nopCommerce (SP) SAML メタデータが Keycloak (IDP) にエクスポートされました。
• Keycloak (IDP) SAML メタデータを nopCommerce (SP) にインポートします。
• ホバーオン アクションを選択 とをクリックしてください テスト構成 ボタンをクリックして、プラグインが正しく設定されているかどうかを確認します。

• クリック テスト構成 ボタンをクリックして、プラグインが正しく設定されているかどうかを確認します。
• 構成が成功すると、「テスト構成」ウィンドウに属性名と属性値が表示されます。

4. 属性マッピング

• テスト構成が成功したら、 をクリックします。 設定の編集 そして、「属性マッピング」セクションに移動します。
• 右側には、IDP 応答テーブルが表示され、IDP によって提供された属性名とストア属性がマップされています。 属性/役割のマッピング タブには何も表示されないことに注意してください。
• ソフトウェアの制限をクリック Save

5. nopCommerce ストアで SSO を有効にする

• 以下に示すようにスライダーをドラッグして、nopCommerce ストアの SSO を有効にします。

• 下 リダイレクトと SSO リンク タブで、次のラベルが付いた URL を使用します。 ストアの SSO リンク ストアで SSO を開始します。

その他のリソース

• nopCommerce OAuth シングル サインオン (SSO)
• ASP.NET アプリケーションの Web3 ログイン
• ASP.NET SAML シングル サインオン (SSO)
• ASP.NET OAuth シングル サインオン (SSO)
• DNN SAML シングル サインオン (SSO)
• DNN REST API 認証
• Kentico SAML シングル サインオン (SSO)