Configuring Single Sign-On
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

OpenID Connectを使用してOktaでLiferay認証を設定する

このチュートリアルでは、OpenID Connectを使用して、IDプロバイダー(IdP)であるOktaを環境に統合するために必要な基本的な手順を説明します。

前提条件

  • Okta Dev アカウント
  • Liferay DXP環境
  • Okta管理コンソールへの管理者アクセス権を持つユーザー
  • Liferayのコントロールパネルへの管理者権限を持つユーザー

Oktaの設定

  1. Okta Dev にログインし、 アプリケーション → アプリケーションの追加 → アプリ統合の作成 に移動します。

  2. サインイン方法の下にある OIDC - OpenID Connectを選択し、アプリケーションの種類の下にある Web アプリケーションを選択します。

    新しいOIDCアプリ統合を作成する

  3. アプリ統合名として Liferay DXP - OIDC と入力します。

  4. グラントタイプについては、 認証コード と リフレッシュトークン を選択してください。

  5. サインインのリダイレクトURIには、 https://[your_instance_url]/c/portal/login/openidconnect を入力してください。

  6. サインアウトのリダイレクトURIには、 https://[your_instance_url] を入力してください。

  7. 割り当ての下で、 グループ割り当てを今はスキップする を選択します。

  8. をクリックして保存します。

  9. 「割り当て」タブで、このアプリケーションにユーザーを割り当てます。

    注記

    Liferay管理者としてログインできるように、必ずご自身にユーザーアカウントを割り当て、プロビジョニングしてください。

エンドポイントURLの取得

  1. Okta Dev アカウントで、サイド パネルに移動し、 セキュリティ → API に移動します。

  2. 「認証サーバー」タブで、 default という名前のサーバーを見つけてクリックし、その設定を編集します。

    メタデータURIを見つけるために、デフォルトの認証サーバーを編集します。

  3. 通常、次のような「メタデータURI」リンクをクリックしてください:https://dev-123456.okta.com/oauth2/default/.well-known/oauth-authorization-server

        issuer: "https://dev-123456.okta.com/oauth2/default"
        authorization_endpoint: "https://dev-123456.okta.com/oauth2/default/v1/authorize"
        token_endpoint: "https://dev-123456.okta.com/oauth2/default/v1/token"
        registration_endpoint: "https://dev-123456.okta.com/oauth2/v1/clients"
        jwks_uri: "https://dev-123456.okta.com/oauth2/default/v1/keys"
    
  4. これにより、 /userinfo エンドポイントを除く、必要な URL が取得されます。ベースURLと認証サーバー名を組み合わせることで、そのエンドポイントを構築できます。例えば: https://dev-123456.okta.com/oauth2/default/v1/userinfo。

Liferay OIDC の設定

注記

メール通知を送信するには、インストール環境においてメールサーバーへの接続設定が完了している必要があります。または、この機能を無効にすることもできます 見知らぬ人にメールアドレスの確認を要求する。詳細については、 ヒントとトラブルシューティング を参照してください。

  1. DXP インスタンスで、 グローバル メニュー → コントロール パネル → インスタンス設定 → セキュリティ → SSO に移動します。

  2. OpenID Connect プロバイダー接続 タブに移動し、新しい接続エントリを追加します。

  3. 以下の表に示すように、 エンドポイントURLで見つけたデータで各フィールドを埋めてください。

    分野データ
    プロバイダー名Okta OIDC
    スコープscopes_supported
    認証エンドポイント認証エンドポイント URL
    発行者URL発行者 URL
    JWKS URIjwks_uri URL
    科目タイプsubject_types_supported
    トークンエンドポイントトークンエンドポイント URL
    ユーザー情報エンドポイントからエンドポイント URL を取得する手順 の手順 4 に従ってください。
    OpenID ConnectクライアントIDOkta のアプリケーションの 一般 タブで確認してください。
    OpenID ConnectクライアントシークレットOkta のアプリケーションの 一般 タブで確認してください。

それが完了したら、OpenID Connectを有効にする必要があります。 OpenID Connectを有効にするには:

  1. グローバルメニュー → コントロールパネル → インスタンス設定 に移動します。

  2. セキュリティセクションの SSO をクリックしてください。

  3. OpenID Connect タブに移動し、 有効 チェックボックスをクリックして、 保存 をクリックします。

    OpenID接続を有効にするには、「有効」チェックボックスをクリックしてください。

検証

  1. Liferay DXPインスタンスを起動します

  2. サインイン ボタンをクリックし、 OpenID Connect を選択します。

    「サインイン」ボタンをクリックして、「OpenID Connect」を選択してください。

  3. リストから Okta OIDC へのクライアントを選択します。

    リストからOkta OIDCへのクライアントを選択してください。

  4. Oktaアカウントでログインしてください。

    Oktaアカウントでサインインしてください

結論

 このソリューションチュートリアルは正常に完了しました。

ヒントとトラブルシューティング

サインインおよびサインアウトのリダイレクトURI

下図のようなエラーが発生した場合は、OktaでサインインおよびサインアウトのリダイレクトURIが適切なパスとハイパーテキスト転送プロトコル(HTTPまたはHTTPS)を使用して正しく設定されていることを確認してください。 Dev Okta アカウントで、作成したアプリケーションに移動すると、それらを見つけることができます → 一般 タブ → 一般設定 → ログイン セクション。

リダイレクトURIでhttpsを使用すると400エラーが発生する

メールアドレスを確認してください

デフォルトでは、新規ユーザーは初回ログイン時にメールアドレスの認証を行う必要があります。この要件を無効にするには、Liferay DXPで「見知らぬ人にメールアドレスの確認を求める」チェックボックスの選択を解除してください。コントロール パネル → インスタンス設定 → プラットフォーム → ユーザー認証 に移動し、チェックボックスの選択を解除します。ただし、電子メールのバリデーションを有効にしておきたい場合は、インストール時にメールサーバーへの接続設定が必要です。

メールアドレスを確認してください