翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# デスクトップで Okta for Amazon Quick を使用してエンタープライズサインインを設定する
| |
| --- |
| 適用先: Enterprise Edition |
| |
| --- |
| 対象者: システム管理者 |
このページでは、Okta でエンタープライズサインインを設定する 4 つのステップをすべて説明します。
1. Okta で OIDC アプリケーションを作成し、その値を記録します。
1. Amazon Quick 管理コンソールに拡張機能アクセスを追加します。
1. Amazon Quick コンソールで拡張機能を作成します。
1. デスクトップアプリケーションをダウンロード、検証、配布します。
**注記**
開始する前に、「」の前提条件を確認してください[エンタープライズデプロイ用のデスクトップでの Amazon Quick のセットアップ](desktop-enterprise-setup.md)。
## ステップ 1: Okta で OIDC アプリケーションを作成する
Okta に OIDC ネイティブアプリケーションを登録します。Amazon Quick デスクトップアプリケーションは、このクライアントを使用して、PKCE による認可コードフローを通じてユーザーを認証します。このクライアントにはクライアントシークレットは必要ありません。更新トークン許可タイプを有効にし、アプリケーションが存続期間の長いセッションを維持できるように`offline_access`スコープを付与します。
詳細については、Okta ドキュメントの「Create [ OpenID Connect app integrations](https://help.okta.com/en-us/content/topics/apps/apps_app_integration_wizard_oidc.htm)」を参照してください。
**Okta OIDC ネイティブアプリケーションを作成するには**
1. Okta 管理コンソールで、**アプリケーション → アプリケーション → アプリケーション統合の作成**に移動します。
1. サインイン方法として **OIDC - OpenID Connect** を選択します。
1. アプリケーションタイプとして**ネイティブ**アプリケーションを選択し、次**へ**を選択します。
1. 次の設定を行います。
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/desktop-enterprise-okta.html)
1. **[保存]** を選択します。
1. **全般**タブで、**クライアント ID** を書き留めます。
Okta は、ネイティブアプリケーションに PKCE (S256) を自動的に適用します。
**スコープを設定するには**
1. Okta 管理コンソールで、**Security → API → Authorization Servers** に移動し、認可サーバー (**デフォルト**など) を選択します。
1. **スコープ**タブで、次のスコープが有効になっていることを確認します: `openid`、`email`、`profile`、`offline_access`。
1. **アクセスポリシー**タブで、このアプリケーションに割り当てられたポリシーが `Authorization Code`および `Refresh Token` 許可タイプを許可していることを確認します。
**認証設定を確認するには**
1. アプリ統合で、**全般**タブに移動します。
1. **全般設定**で、アプリケーションタイプが**ネイティブ**、クライアント認証が**なし** (パブリッククライアント）、PKCE **が必要**であることを確認します。
1. **LOGIN** で、 `http://localhost:18080`がリダイレクト URI としてリストされていることを確認します。
1. 変更を加えた場合は**、保存** を選択します。
次の OIDC エンドポイントを記録します。これらの値は、ステップ 2 で前に書き留めた**クライアント ID** とともに入力します。を Okta ドメイン ( など`your-org.okta.com`) ``に置き換えます。
| フィールド | 値 |
| --- | --- |
| クライアント ID | 全般タブのクライアント ID |
| 発行者 URL | https:///oauth2/default |
| 認可エンドポイント | https:///oauth2/default/v1/authorize |
| トークンエンドポイント | https:///oauth2/default/v1/token |
| JWKS URI | https:///oauth2/default/v1/keys |
## ステップ 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-okta.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 で続行**を選択し、会社の認証情報を使用してサインインします。ユーザーごとの追加の設定は必要ありません。