翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
for Amazon Quick Ping Identity on Desktop でエンタープライズサインインをセットアップする
| 適用先: Enterprise Edition |
| 対象者: システム管理者 |
このページでは、 でエンタープライズサインインを設定する 4 つのステップをすべて説明しますPing Identity。
-
Ping Identity 製品 (PingFederate または PingOne) に OIDC アプリケーションを作成し、その値を記録します。
-
Amazon Quick 管理コンソールに拡張機能アクセスを追加します。
-
Amazon Quick コンソールで拡張機能を作成します。
-
デスクトップアプリケーションをダウンロード、検証、配布します。
注記
開始する前に、「」の前提条件を確認してくださいエンタープライズデプロイ用のデスクトップでの Amazon Quick のセットアップ。
ステップ 1: で OIDC アプリケーションを作成する Ping Identity
Ping Identity 製品にパブリック OIDC クライアントを登録します。Amazon Quick デスクトップアプリケーションは、このクライアントを使用して、PKCE による認可コードフローを通じてユーザーを認証します。このクライアントにはクライアントシークレットは必要ありません。更新トークン許可タイプを有効にし、offline_accessスコープを付与します。Ping Identity 製品の手順を選択します。
PingFederate
詳細については、 Ping Identityドキュメントの「 での OIDC アプリケーションのセットアップPingFederate
OIDC PingFederate クライアントを作成するには
-
PingFederate 管理コンソールで、アプリケーション → OAuth → クライアントに移動し、クライアントの追加を選択します。
-
クライアント ID フィールドに、このクライアントの一意の識別子を入力します。
-
[名前] フィールドに
Amazon Quick Desktopを入力してください。 -
クライアント認証で、なしを選択します。
-
リダイレクト URI セクションで、「追加」と入力
http://localhost:18080し、「追加」を選択します。 -
許可されたグラントタイプリストで、認可コードと更新トークンを選択します。
-
コード交換に必要な証明キー (PKCE) チェックボックスをオンにします。
-
共通スコープで、、
openid、emailprofile、 を付与しますoffline_access。 -
[保存] を選択します。
-
クライアント ID を書き留めます。この値は、後のステップで必要になります。
OIDC ポリシーを設定するには
-
PingFederate 管理コンソールで、アプリケーション → OAuth → OpenID Connect ポリシー管理に移動します。
-
このクライアントに関連付けられた OIDC ポリシーを選択するか、ポリシーの追加を選択して作成します。
-
「Return ID Token On Refresh Grant」チェックボックスをオンにします。これにより、セッションを更新するときに、デスクトップアプリケーションは現在のクレームを含む新しい ID トークンを受信します。
-
属性契約で、
emailクレームが含まれ、認証ソースの対応するユーザー属性にマッピングされていることを確認します。emailクレームは、最初の認証と更新トークンの付与の両方で発行されたトークンに存在する必要があります。 -
[保存] を選択します。
次の OIDC エンドポイントを記録します。これらの値は、ステップ 2 で前に書き留めたクライアント ID とともに入力します。をPingFederateサーバーのホスト名<PINGFEDERATE_HOST>に置き換えます。
| フィールド | 値 |
|---|---|
| クライアント ID | クライアントの作成時に入力したクライアント ID |
| 発行者 URL | https://<PINGFEDERATE_HOST> |
| 認可エンドポイント | https://<PINGFEDERATE_HOST>/as/authorization.oauth2 |
| トークンエンドポイント | https://<PINGFEDERATE_HOST>/as/token.oauth2 |
| JWKS URI | https://<PINGFEDERATE_HOST>/pf/JWKS |
PingOne
詳細については、 Ping Identityドキュメントの「アプリケーションの編集 – ネイティブ
OIDC PingOne ネイティブアプリケーションを作成するには
-
PingOne 管理コンソールで、アプリケーション → アプリケーションに移動し、+ アイコンを選択します。
-
アプリケーション名
Amazon Quick Desktopとして を入力します。 -
アプリケーションタイプセクションで、ネイティブを選択し、保存を選択します。
-
設定タブで、編集を選択し、次の設定を設定します。
設定 値 レスポンスタイプ コード グラントタイプ 認可コードと更新トークン PKCE の適用 S256 リダイレクト URI http://localhost:18080トークンエンドポイント認証方法 なし -
[保存] を選択します。
-
リソースタブで、、
openid、email、profileのスコープを追加しますoffline_access。設定タブではなく、リソースタブにスコープを追加する
これは設定タブとは別のステップです。 はデフォルトで
openidスコープのみPingOneを付与するため、リソースタブoffline_accessにemail、profile、 を明示的に追加する必要があります。このステップをスキップすると、「ユーザー情報リクエストが失敗 (HTTP 401)」でサインインが失敗します。このエラーは、サインインにこれらのスコープで発行されたトークンが必要であり、このタブに追加しない限り付与PingOneされないために発生します。 -
属性マッピングタブで、
email属性がユーザーの E メールアドレスにマッピングされていることを確認します。 -
アプリケーションを Enabled に切り替えます。
-
設定タブのクライアント ID と環境 ID を書き留めます。
注記
PingOne ドメインはリージョンによって異なります。次の例では .com を使用しています。ドメインを環境のドメイン (、、 など.eu.asia) .caに置き換えます。
次の OIDC エンドポイントを記録します。これらの値は、ステップ 2 で前に書き留めたクライアント ID とともに入力します。をPingOne環境 ID <ENV_ID>に置き換えます。
| フィールド | 値 |
|---|---|
| クライアント ID | 設定タブのクライアント ID |
| 発行者 URL | https://auth.pingone.com/<ENV_ID>/as |
| 認可エンドポイント | https://auth.pingone.com/<ENV_ID>/as/authorize |
| トークンエンドポイント | https://auth.pingone.com/<ENV_ID>/as/token |
| JWKS URI | https://auth.pingone.com/<ENV_ID>/as/jwks |
に正しい JWKS URI パスを使用する PingOne
JSON ウェブキーセット (JWKS) URI の場合は、前の表に示す/as/jwksパスを使用します。一部のPingOne形式でプレースホルダーとして表示される/.well-known/jwks.json可能性がある は使用しないでください。 PingOneはこのパスを使用しないため、サインイントークンの検証を入力すると失敗します。
ステップ 2: Amazon Quick 管理コンソールに拡張機能アクセスを追加する
Amazon Quick 管理コンソールで、ステップ 1 で記録した OIDC エンドポイント値とクライアント ID を使用して拡張機能アクセスを追加します。
拡張機能アクセスを追加するには
-
Amazon Quick 管理コンソールにサインインし、アカウントの管理を選択します。
-
左側のナビゲーションペインのアクセス許可で、拡張機能アクセスを選択します。
-
拡張機能アクセスの追加を選択します。
-
サービスの選択で、Amazon Quick (クイックの場合はデスクトップアプリケーション) を選択し、次へを選択します。
-
ステップ 1 で記録した値を使用して、拡張機能の詳細を入力します。
フィールド 値 名前 この拡張機能アクセスの名前 (例: QuickDesktop-access)。これは内部参照のみであり、IdP では設定されていません。英数字とハイフンのみを使用し、スペースは使用しません。説明 (オプション) 参照のみを目的として、この拡張機能アクセスの説明。 発行者 URL 必要なパスサフィックスを含む、ステップ 1 の正確な OIDC 発行者 URL。 認可エンドポイント ステップ 1 の OIDC 認可エンドポイント URL トークンエンドポイント ステップ 1 の OIDC トークンエンドポイント URL JWKS URI ステップ 1 の JSON ウェブキーセット URI クライアント ID ステップ 1 で記録した OIDC クライアント識別子 (クライアント ID またはアプリケーション (クライアント) ID)。必須。 -
[Add] (追加) を選択します。
重要
追加を選択する前に、すべての値が正しいことを確認します。拡張機能アクセス設定は、作成後に編集することはできません。値が正しくない場合は、拡張機能アクセスを削除して新しい値を作成する必要があります。
ステップ 3: Amazon Quick コンソールで拡張機能を作成する
Amazon Quick 管理コンソールで拡張機能アクセスを追加したら、Amazon Quick コンソールの拡張機能ページで拡張機能を作成します。
拡張機能を作成するには
-
Amazon Quick コンソールの左側のナビゲーションペインで、拡張機能を選択します。拡張機能が表示されない場合は、詳細を選択して検索します。
-
拡張機能の追加 を選択します。
-
ステップ 2 で作成したクイック拡張機能アクセス用のデスクトップアプリケーションを選択し、次へを選択します。
-
[作成] を選択します。
重要
ステップ 2 とステップ 3 の両方が必要です。拡張機能アクセスを追加しても拡張機能を作成しない場合、エンタープライズサインインは使用できず、ユーザーには「クイックデスクトップのエンタープライズサインインはこのアカウントに設定されていません」というエラーが表示されます。
注記
拡張機能の作成は、アカウントレベルの 1 回限りのアクションです。管理者が拡張機能を作成すると、アカウント内のすべてのユーザーがエンタープライズサインインを使用できます。個々のユーザーは、拡張機能を自分で有効にする必要はありません。デスクトップアプリケーションをダウンロードしてサインインするだけで済みます。
ステップ 4: デスクトップアプリケーションをダウンロード、検証、配布する
このステップでは、デスクトップアプリケーションをダウンロードしてインストールし、エンタープライズサインインが機能することを確認し、アプリケーションをユーザーに配布します。
まず、Amazon Quick コンソールからアプリケーションをダウンロードします。
デスクトップアプリケーションをダウンロードするには
-
Amazon Quick コンソールの左側のナビゲーションペインで、拡張機能を選択します。拡張機能が表示されない場合は、詳細を選択して検索します。
-
ステップ 3 で作成したクイックデスクトップ拡張機能を選択します。
-
拡張機能のその他のオプションアイコン (...) を選択します。
-
オペレーティングシステムに応じて、Windows の場合は Download、Mac の場合は Download を選択します。
次に、アプリケーションをインストールします。インストール手順については、「はじめに」を参照してください。
アプリケーションをインストールしたら、エンタープライズサインインが機能することを確認します。
エンタープライズサインインを確認するには
-
Amazon Quick デスクトップアプリケーションを開きます。
-
サインイン画面で、「SSO で続行」を選択します。
-
(オプション) AWS リージョン リストから を選択するか、動的 を選択して、アプリケーションがリージョンを自動的に検出するようにします。
-
会社の認証情報を使用して認証します。アプリケーションは ID プロバイダーにリダイレクトされ、認証が成功するとホーム画面に戻ります。
ヒント
サインインに失敗した場合は、ステップ 2 で入力した値をステップ 1 の OIDC エンドポイントとクライアント ID と照合します。値が正しくない場合は、Amazon Quick 管理コンソールのアクセス許可 → 拡張機能アクセスで拡張機能アクセスを削除し、正しい値でステップ 2 を繰り返します。詳細については、「」を参照してくださいデスクトップでの Amazon Quick のエンタープライズサインインのトラブルシューティング。
最後に、セットアップを確認したら、アプリケーションをユーザーに配布します。ダウンロード、インストール、サインインの手順はじめにについては、「」を参照してください。ユーザーは SSO で続行を選択し、会社の認証情報を使用してサインインします。ユーザーごとの追加の設定は必要ありません。