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