Keycloakとは何ですか？また、WordPressのSAML SSOとどのように連携するのですか？

KeycloakはオープンソースのIDおよびアクセス管理ツールです。miniOrange SAML SSOプラグインを使用すると、Keycloakがアイデンティティプロバイダー（IdP）として機能し、WordPressがサービスプロバイダー（SP）として機能し、ユーザーはKeycloakの認証情報でログインできるようになります。

ログインリダイレクトループが発生するのはなぜですか?

リダイレクトループは通常、KeycloakのコールバックURLがアプリの設定と一致しない場合、またはCookie/セッションの問題が原因で発生します。リダイレクトURIの確認、Cookieの消去、プロキシ/ロードバランサーの設定確認などにより修正してください。

ユーザーに SSO タイムアウトエラーが発生するのはなぜですか?

SSOタイムアウトエラーは、タイムアウト値が低すぎる、サーバーの過負荷、またはネットワークの遅延が原因で発生します。Keycloakとクライアントアプリのタイムアウト設定を調整するか、サーバーリソースを拡張してください。

ロールまたはグループのマッピングの問題を解決するにはどうすればよいですか?

ロールまたはグループのマッピングに関する問題は、マッパーの設定ミスが原因で発生します。Keycloakのロールとアプリケーションマッパーが正しく連携していることを確認し、ロール名の重複や競合を避けてください。

OIDC/OAuth SSO で「無効な redirect_uri」エラーが発生する原因は何ですか?

このエラーは、アプリのリダイレクトURIがKeycloakに登録されていない場合に発生します。プロトコル、ドメイン、パスが一致することを確認し、Keycloakに正確なリダイレクトURIを追加してください。

複数の Keycloak レルムまたはクライアントはサポートされていますか?

はい、プラグインは複数の Keycloak レルムまたはクライアントを含む複数の SAML IdP をサポートしており、マルチテナント環境に役立ちます。

KeycloakへのSAMLシングルサインオンによるログイン | KeycloakをSAML IDPとして使用したSSO

概要

WordPress の Keycloak シングルサインオン (SSO) ログイン 私たちのを使用することで達成できます SAML シングルサインオン (SSO) プラグイン当社のプラグインは、すべてのSAML準拠のアイデンティティプロバイダー。ここでは、WordPressサイトとKeycloak間のSSOログインを設定するためのステップバイステップガイドを説明します。 IDP としての Keycloak (アイデンティティプロバイダー) および SPとしてのWordPress (サービスプロバイダー)。
あなたは私たちを訪問することができます SSO WordPress用プラグインで、当社が提供するその他の機能について詳しく知ることができます。

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

KeycloakをWordPressでSAML IDPとして構成するには、 miniOrange SAML SP SSO プラグイン。

使用しているKeycloakのバージョンを選択してください

構成手順

ステップ1：KeycloakをIDP（アイデンティティプロバイダー）として設定する

KeycloakをIDPとして設定するには、以下の手順に従ってください。

KeycloakをIDPとして構成する

WordPress (WP) 用の Keycloak SSO / Keycloak ログインを設定するには、以下の手順に従ってください。ビデオのセットアップ.

miniOrange SAML SP SSOプラグインで、「SP（サービスプロバイダー）メタデータ」タブに移動します。ここには、KeycloakをIDP（アイデンティティプロバイダー）として構成するために必要な、SPエンティティIDやACS（AssertionConsumerService）URLなどのSPメタデータが表示されます。

Keycloakログイン | WordPress Samlアップロードメタデータ

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

Enter 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.

miniOrange SAML SP SSOプラグインで、「SP（サービスプロバイダー）メタデータ」タブに移動します。ここには、KeycloakをIDP（アイデンティティプロバイダー）として構成するために必要な、SPエンティティIDやACS（AssertionConsumerService）URLなどのSPメタデータが表示されます。

Keycloak SSO | WordPress Saml メタデータアップロード

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.

miniOrange SAML SP SSOプラグインで、「SP（サービスプロバイダー）メタデータ」タブに移動します。ここには、KeycloakをIDP（アイデンティティプロバイダー）として構成するために必要な、SPエンティティIDやACS（AssertionConsumerService）URLなどのSPメタデータが表示されます。

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

選択 SAML as クライアントタイプ, SP-EntityID / 発行者を入力してください として 顧客ID サービスプロバイダーのメタデータ タブ、入力名前申請書に記入し、 詳細説明 .

以下を行うには、次へ
以下の詳細を入力してください。

ルートURL	空白のままにするか、入力してください Base URL サービスプロバイダーの「メタデータ」タブから
有効なリダイレクト URI	その ACS (アサーションコンシューマサービス) URL プラグインのサービスプロバイダーメタデータタブから

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

Keycloak シングルサインオン | Keycloak IDP で詳細を入力する

設定下のタブ SAML機能 セクションで、必要な詳細を指定して Keycloak を設定します。

POSTバインディングを強制する	オフ
強制名 ID 形式	オフ
名前ID形式	メールアドレス

キーズ タブで、 クライアントの署名が必要 トグル。

以下を行うには、 Save
In 高機能 タブ、下 きめ細かい SAML エンドポイント構成、次の詳細を入力します。

アサーションコンシューマサービス POST バインディング URL	その ACS (アサーションコンシューマサービス) URL プラグインのサービスプロバイダーメタデータタブから
ログアウトサービスリダイレクトバインドURL （オプション）	そのシングルログアウト URL プラグインのサービスプロバイダーメタデータタブから

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

マッパーの追加

MFAデバイスに移動する マッパータブ をクリックします。入力したコードが正しければ、MFAの設定は正常に完了します ビルトインの追加

Keycloak SSO | マッパータブ - SAML / OAuth を使用した Salesforce SSO ログイン - SAML メタデータのアップロード

のチェックボックスをオンにします X500 指定された名前, X500姓 (NAIST) と X500メール 属性を指定します。

ソフトウェアの制限をクリック 選択したものを追加 ボタン。以下に追加されたマッピングが表示されます。

In クライアントスコープ タブでアプリケーションをクリックします。

ソフトウェアの制限をクリック 事前定義されたマッパーを追加する.

のチェックボックスをオンにします X500 指定された名前, X500姓 (NAIST) と X500メール 属性を指定します。

ソフトウェアの制限をクリック追加
以下に追加されたマッピングが表示されます。

クライアントスコープ タブで、アプリケーションをクリックします。

ソフトウェアの制限をクリック 事前定義されたマッパーを追加する.

のチェックボックスをオンにします X500 指定された名前, X500姓 (NAIST) と X500メール 属性を指定します。

以下を行うには、追加
以下に追加されたマッピングが表示されます。

セットアップファイルをダウンロードする

MFAデバイスに移動する レルム設定、 をクリックしてください SAML 2.0 ID プロバイダーのメタデータ でエンドポイントとして言及されている 「一般設定」タブ.

URL をメモして手元に保管してください。それはあなたに提供します Endpoints プラグインを設定するために必要です。

MFAデバイスに移動する レルム設定、 をクリックしてください SAML 2.0 ID プロバイダーのメタデータ でエンドポイントとして言及されている 「一般設定」タブ.

URL をメモして手元に保管してください。それはあなたに提供します Endpoints プラグインを設定するために必要です。

MFAデバイスに移動する レルム設定 SAML 2.0 ID プロバイダーのメタデータ でエンドポイントとして言及されている全般タブには何も表示されないことに注意してください。

URL をメモして手元に保管してください。それはあなたに提供します Endpoints プラグインを設定するために必要です。

KeycloakをSAML IDP（アイデンティティプロバイダー）として正常に設定し、WordPress（WP）サイトへのKeycloak SSOログインを実現しました。

注意： ID プロバイダー側で属性マッピング、ロールマッピング、その他の構成をセットアップする場合は、リンクされている提供されているセットアップガイドで詳細な手順を見つけることができます。こちら.

ステップ2：WordPressをSP（サービスプロバイダー）として設定する

Free
スタンダード
プレミアムサーマルバッグ

WordPress 用 SAML SSO プラグインで、プラグインの IDP 設定タブに移動します。WordPress 用 SSO プラグインを設定する方法は 2 つあります。

A. IDP メタデータをアップロードすることにより、次のようになります。

ソフトウェアの制限をクリック IDPメタデータをアップロードする
入力する ID プロバイダー 名前
あなたがいずれかを行うことができ メタデータファイルをアップロードする をクリックします。入力したコードが正しければ、MFAの設定は正常に完了します アップロード ボタンまたは メタデータ URL をクリックします。入力したコードが正しければ、MFAの設定は正常に完了します メタデータのフェッチ.

WordPress 用 SAML SSO | ログインしてメタデータをアップロード

B. 手動設定:

アイデンティティプロバイダから提供された必要な設定（アイデンティティプロバイダ名、IDPエンティティIDまたは発行者、SAMLログインURL、X.509証明書など）を入力し、 Save
ソフトウェアの制限をクリック 構成のテスト IDP によって送信された属性と値を確認します。

ステップ 3: 属性マッピング

注意： 複数のIDプロバイダーの属性マッピングを設定するには、セットアップガイドに従ってください。こちらこの機能はエンタープライズプランでご利用いただけます。

無料プラグインでは、 名前ID WordPress ユーザーのメールとユーザー名の属性がサポートされています。
ユーザーが SSO を実行すると、IDP によって送信された NameID 値が WordPress ユーザーのメールアドレスとユーザー名にマッピングされます。

WordPress 用 SAML SSO プラグインで、プラグインの「サービスプロバイダー設定」タブに移動します。WordPress 用 SSO プラグインを設定する方法は 2 つあります。

A. IDP メタデータをアップロードすることにより、次のようになります。

ソフトウェアの制限をクリック IDPメタデータをアップロードする
入力する ID プロバイダー 名前
あなたがいずれかを行うことができ メタデータファイルをアップロードする をクリックします。入力したコードが正しければ、MFAの設定は正常に完了します アップロード ボタンまたは メタデータ URL をクリックします。入力したコードが正しければ、MFAの設定は正常に完了します メタデータのフェッチ.

B. 手動設定:

アイデンティティプロバイダから提供された必要な設定（アイデンティティプロバイダ名、IDPエンティティIDまたは発行者、SAMLログインURL、X.509証明書など）を入力し、 Save
ソフトウェアの制限をクリック 構成のテスト IDP によって送信された属性と値を確認します。

ステップ 3: 属性マッピング

属性マッピング 機能を使用すると、 ユーザー属性 SSO 中に IDP によって WordPress のユーザー属性に送信されます。
WordPress 用 SAML プラグインでは、 属性/役割のマッピング タブをクリックして次のフィールドに入力します 属性マッピング のセクションから無料でダウンロードできます。

注: サービスプロバイダー設定タブのテスト構成ボタンをクリックし、IDP で認証すると、属性/ロールマッピングタブに IDP によって送信された属性のリストが表示されます。この情報を使用して、上記のマッピングを提供できます。

A. IDP メタデータをアップロードすることにより、次のようになります。

ソフトウェアの制限をクリック IDPメタデータをアップロードする
入力する アイデンティティプロバイダー名
あなたがいずれかを行うことができ メタデータファイルをアップロードする をクリックします。入力したコードが正しければ、MFAの設定は正常に完了します アップロード ボタンまたは メタデータ URL をクリックします。入力したコードが正しければ、MFAの設定は正常に完了します メタデータのフェッチ.
プレミアムプラグイン、することができます 自動同期を有効にする メタデータ URL 設定された時間間隔後にIDPメタデータに従ってプラグイン設定を自動更新します。

WordPress 用 SAML SSO | ログイン時に自動スキャンを有効にする

B. 手動設定:

必要な設定（IDプロバイダー名、IDPエンティティIDまたは発行者、SAMLログインURL、X.509証明書など）を、 ID プロバイダー とをクリックしてください Save
ソフトウェアの制限をクリック 構成のテスト IDP によって送信された属性と値を確認します。

プレミアムプラグインでは、SAML ログアウト URL を提供して、WordPress サイトでシングルログアウトを実現できます。

ステップ 3: 属性マッピング

属性マッピング 機能を使用すると、 ユーザー属性 SSO 中に IDP によって WordPress のユーザー属性に送信されます。
WordPress 用 SAML プラグインでは、 属性/役割のマッピング タブをクリックして次のフィールドに入力します 属性マッピング のセクションから無料でダウンロードできます。

カスタム属性マッピング: この機能により、IDPから送信された属性を ユーザーメタ WordPressのテーブル。

ステップ 4: 役割のマッピング

注意： 複数のIDプロバイダーのロールマッピングを設定するには、セットアップガイドに従ってください。こちらこの機能はエンタープライズプランでご利用いただけます。

無料のプラグインでは、 デフォルトの役割 SSO を実行するときに、管理者以外のすべてのユーザーに割り当てられます。
に行く 属性/役割のマッピング タブをクリックして移動します 役割のマッピング のセクションから無料でダウンロードできます。
まず デフォルトの役割 とをクリックしてください更新

ステップ 4: 役割のマッピング

標準プラグインでは、管理者以外のユーザーが SSO を実行するときに割り当てられるデフォルトのロールを選択できます。

に行く 属性/役割のマッピング タブをクリックして移動します 役割のマッピング のセクションから無料でダウンロードできます。
まず デフォルトの役割 とをクリックしてください Save

ステップ4：役割マッピング

この機能を使用すると、ユーザーがシングルサインオン（SSO）を実行する際に、ユーザーの役割を割り当てて管理できます。WordPressのデフォルトの役割に加え、カスタム役割にも対応しています。

ノーザンダイバー社の 属性マッピング プラグインのセクションで、という名前のフィールドのマッピングを指定します。 グループ/役割この属性には、IDPから送信される役割関連情報が含まれており、役割マッピングに使用されます。
ロールマッピングセクションに移動し、強調表示されたロールのマッピングを指定します。

たとえば、次のようなユーザーが必要な場合、 グループ/役割 属性の値が wp-editor であれば、WordPress のエディターとして割り当てられます。マッピングを wp-editor として指定するだけで済みます。 エディター ロールマッピングセクションのフィールド。

ステップ 5: SSO 設定

無料のプラグインでは、有効にすることでシングルサインオンボタンを追加できます。 WordPressログインページにシングルサインオンボタンを追加する トグルイン オプション1.

WordPress テーマがログインウィジェットをサポートしている場合は、ログインウィジェットを追加して、サイトで SP 開始 SSO を有効にすることができます。
[リダイレクトと SSO リンク] タブに移動し、以下に示されている手順に従います。 オプション2: ウィジェットを使用する サイトにログインウィジェットを追加します。

ステップ 5: SSO 設定

標準プラグインでは、次のオプションを使用して SP によって開始される SSO を有効にすることができます。

サイトからの自動リダイレクト: このオプションを有効にすると、サイトにアクセスしようとする認証されていないユーザーは IDP ログインページにリダイレクトされ、認証が成功すると、アクセスしようとしていたサイト上の同じページにリダイレクトされます。

ステップ：

プラグインの [リダイレクトと SSO リンク] タブに移動し、次の場所に移動します。 オプション 1: 自動 - サイトからのリダイレクト.
有効にする ユーザーがログインしていない場合は IDP にリダイレクトします [サイト全体を保護]オプションを選択します。

WordPress ログインからの自動リダイレクト: このオプションを有効にすると、デフォルトの WordPress ログインページにアクセスしようとする認証されていないユーザーは、認証のために IDP ログインページにリダイレクトされます。認証が成功すると、WordPress サイトにリダイレクトされます。

ステップ：

プラグインの [リダイレクトと SSO リンク] タブに移動し、次の場所に移動します。 オプション2: WordPressログインからの自動リダイレクト.
有効にする WordPress ログインページから IDP にリダイレクトする オプションを選択します。

注: バックドアログインを有効にして、バックドア URL を書き留めてください。これにより、IDP からロックアウトされた場合でも WordPress ログインページにアクセスできるようになります。

SSO リンク: 提供されているショートコードとウィジェットを使用して、サイトのどこにでもSSOリンクを追加できます。 [リダイレクトと SSO リンク] タブ > オプション 3: SSO リンク プラグインのセクション

ステップ5：SSO設定

Premium プラグインでは、次のオプションを使用して SP によって開始される SSO を有効にすることができます。

サイトからの自動リダイレクト: このオプションを有効にすると、認証されていないユーザーがサイトにアクセスしようとした場合、IDPのログインページにリダイレクトされ、認証が成功すると、アクセスしようとしていたサイト上の同じページにリダイレクトされます。

ステップ：

プラグインの [リダイレクトと SSO リンク] タブに移動し、次の場所に移動します。 オプション1：サイトからの自動リダイレクト.
有効にする ユーザーがログインしていない場合は IDP にリダイレクトします [サイト全体を保護] オプションを選択します。

WordPress ログインからの自動リダイレクト: このオプションを有効にすると、デフォルトの WordPress ログインページにアクセスしようとする認証されていないユーザーは、認証のために IDP ログインページにリダイレクトされます。認証が成功すると、WordPress サイトにリダイレクトされます。

ステップ：

プラグインの [リダイレクトと SSO リンク] タブに移動し、次の場所に移動します。 オプション2：WordPressログインからの自動リダイレクト.
有効にする WordPress ログインページから IDP にリダイレクトする オプションを選択します。

注: バックドアログインを有効にして、バックドアのURLをメモしておいてください。これにより、IDPログインから締め出された場合でも、WordPressログインページにアクセスできます。

ログインボタン: サイトまたはWordPressログインページの任意の場所にカスタムログインボタンを追加するには、次の場所に移動してください。 オプション 3: ログインボタン 「リダイレクトとSSOリンク」タブの該当セクション。

SSO リンク: 提供されているショートコードとウィジェットを使用して、サイトのどこにでもSSOリンクを追加できます。 オプション 4: SSO リンク [リダイレクトと SSO リンク] タブのセクション。

Keycloakシングルサインオンを実現するためのSAML SPとしてWordPress（WP）の設定が正常に完了しました。

このガイドでは、正常に構成されています Keycloak SAML シングルサインオン (Keycloak SSO / Keycloak ログイン) 選択する IDP としての Keycloak (NAIST) と SPとしてのWordPress miniOrange プラグインの SAML シングルサインオン – SSO ログインを使用します。このソリューションにより、WordPress (WP) サイトへの安全なアクセスを展開する準備が整います。 Keycloakログイン 数分以内に資格情報を取得します。

よくある質問

よくある質問をもっと見る

Keycloak認証後、ユーザーがログインしてもWordPressにリダイレクトされないのはなぜですか？

「SAMLアサーションに必要な属性がありません」というエラーメッセージが表示されたり、ユーザーがWordPressアカウントに一致しないのはなぜですか？

Keycloak SSOのテスト設定で、証明書または署名の検証エラーが発生するのはなぜですか？

なぜWordPressで作成されたKeycloak SSOユーザーには、誤った役割が割り当てられたり、役割が全く割り当てられなかったりするのでしょうか？

見つからないものをお探しの場合は、メールでお問い合わせください。 samlsupport@xecurify.com

ご返答ありがとうございます。すぐにご連絡させていただきます。

何か問題が発生しました。もう一度質問を送信してください

Contents

KeycloakへのSAMLシングルサインオンによるログイン | KeycloakをSAML IDPとして使用したSSO