翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# デスクトップで Google WorkSpace for Amazon Quick を使用してエンタープライズサインインを設定する
<a name="desktop-enterprise-google-workspace"></a>


|  | 
| --- |
|  適用先: Enterprise Edition  | 


|  | 
| --- |
|    対象者: システム管理者  | 

このページでは、Google Workspace でエンタープライズサインインを設定する 4 つのステップをすべて説明します。

1. Google Workspace で OIDC アプリケーションを作成し、その値を記録します。

1. Amazon Quick 管理コンソールに拡張機能アクセスを追加します。

1. Amazon Quick コンソールで拡張機能を作成します。

1. デスクトップアプリケーションをダウンロード、検証、配布します。

**注記**  
開始する前に、「」の前提条件を確認してください[エンタープライズデプロイ用のデスクトップでの Amazon Quick のセットアップ](desktop-enterprise-setup.md)。

## ステップ 1: Google Workspace で OIDC アプリケーションを作成する
<a name="desktop-enterprise-google-workspace-step1"></a>

Google クラウドコンソールに OAuth クライアントを登録します。Amazon Quick デスクトップアプリケーションは、このクライアントを使用して、PKCE による認可コードフローを通じてユーザーを認証します。認可リクエストに `access_type=offline`パラメータが含まれている場合、Google は更新トークンを自動的に発行します。Quick には、このパラメータが自動的に含まれます。追加のスコープまたはグラントタイプの設定は必要ありません。

詳細については、Google [for Developers ドキュメントのOAuth 2.0 for Mobile & Desktop Apps](https://developers.google.com/identity/protocols/oauth2/native-app)」を参照してください。

**Google OAuth クライアントを作成するには**

1. Google クラウドコンソールで、**APIsとサービス → 認証情報 → 認証情報の作成 → OAuth クライアント ID **に移動します。

1. 次の設定を行います。


<table>
<thead>
  <tr><th>設定</th><th>値</th></tr>
</thead>
<tbody>
  <tr><td>アプリケーションタイプ</td><td>デスクトップアプリ</td></tr>
  <tr><td>名前</td><td><code>Amazon Quick Desktop</code></td></tr>
</tbody>
</table>


1. **[作成]** を選択します。

1. **クライアント ID** と**クライアントシークレット**を書き留めます。これらの値は、後のステップで必要になります。

**OAuth 同意画面を設定するには**

1. Google クラウドコンソールで、**Google 認証プラットフォーム → ブランディング**に移動します。

1. **ユーザータイプ**を**内部**に設定します。これにより、Google Workspace 組織のユーザーへのサインインが制限されます。

1. 必要なアプリ情報を入力し、**保存**を選択します。

**スコープを設定するには**

1. Google クラウドコンソールで、**Google 認証プラットフォーム → データアクセス**に移動します。

1. 次のスコープを追加します: `openid`、`email`、`profile`。

1. **[保存]** を選択します。

次の OIDC エンドポイントを記録します。これらの値は、ステップ 2 で前に書き留めた**クライアント ID** とともに入力します。


| フィールド | 値 | 
| --- | --- | 
| クライアント ID | OAuth クライアントのクライアント ID  | 
| 発行者 URL | https://accounts.google.com | 
| 認可エンドポイント | https://accounts.google.com/o/oauth2/v2/auth | 
| トークンエンドポイント | https://oauth2.googleapis.com/token?client\_secret=<CLIENT\_SECRET> | 
| JWKS URI | https://www.googleapis.com/oauth2/v3/certs | 

**注記**  
トークン交換が成功するように、クライアントシークレットを`client_secret`クエリパラメータとしてトークンエンドポイントに追加します`https://oauth2.googleapis.com/token?client_secret=<CLIENT_SECRET>`。たとえば、。を OAuth クライアント用に生成されたクライアントシークレット`<CLIENT_SECRET>`に置き換えます。

## ステップ 2: Amazon Quick 管理コンソールに拡張機能アクセスを追加する
<a name="w2aac51c11c21c15"></a>

Amazon Quick 管理コンソールで、ステップ 1 で記録した OIDC エンドポイント値とクライアント ID を使用して拡張機能アクセスを追加します。

**拡張機能アクセスを追加するには**

1. Amazon Quick 管理コンソールにサインインし、**アカウントの管理**を選択します。

1. 左側のナビゲーションペインのアクセス**許可**で、**拡張機能アクセス**を選択します。

1. **拡張機能アクセスの追加** を選択します。

1. **サービスの選択**で、**Amazon Quick (クイックの場合はデスクトップアプリケーション)** を選択し、次**へ**を選択します。

1. ステップ 1 で記録した値を使用して、拡張機能の詳細を入力します。


<table>
<thead>
  <tr><th>フィールド</th><th>値</th></tr>
</thead>
<tbody>
  <tr><td>名前</td><td>この拡張機能アクセスの名前 (例: <code>QuickDesktop-access</code>)。これは内部参照のみであり、IdP では設定されていません。英数字とハイフンのみを使用し、スペースは使用しません。</td></tr>
  <tr><td>説明</td><td>(オプション) 参照のみを目的として、この拡張機能アクセスの説明。</td></tr>
  <tr><td>発行者 URL</td><td>必要なパスサフィックスを含む、ステップ 1 の正確な OIDC 発行者 URL。</td></tr>
  <tr><td>認可エンドポイント</td><td>ステップ 1 の OIDC 認可エンドポイント URL</td></tr>
  <tr><td>トークンエンドポイント</td><td>ステップ 1 の OIDC トークンエンドポイント URL</td></tr>
  <tr><td>JWKS URI</td><td>ステップ 1 の JSON ウェブキーセット URI</td></tr>
  <tr><td>クライアント ID</td><td>ステップ 1 で記録した OIDC クライアント識別子 (クライアント ID またはアプリケーション (クライアント) ID)。必須。</td></tr>
</tbody>
</table>


1. **[Add]** (追加) を選択します。
**重要**  
**追加**を選択する前に、すべての値が正しいことを確認します。拡張機能アクセス設定は、作成後に編集することはできません。値が正しくない場合は、拡張機能アクセスを削除して新しい値を作成する必要があります。

## ステップ 3: Amazon Quick コンソールで拡張機能を作成する
<a name="w2aac51c11c21c17"></a>

Amazon Quick 管理コンソールで拡張機能アクセスを追加したら、Amazon Quick コンソールの拡張機能ページで**拡張機能**を作成します。

**拡張機能を作成するには**

1. Amazon Quick コンソールの左側のナビゲーションペインで、**拡張機能**を選択します。**拡張機能**が表示されない場合は、**詳細**を選択して検索します。

1. **拡張機能の追加** を選択します。

1. ステップ 2 で作成した**クイック拡張機能アクセス用のデスクトップアプリケーション**を選択し、次**へ**を選択します。

1. **[作成]** を選択します。

**重要**  
ステップ 2 とステップ 3 の両方が必要です。拡張機能アクセスを追加しても拡張機能を作成しない場合、エンタープライズサインインは使用できず、ユーザーには「クイックデスクトップのエンタープライズサインインはこのアカウントに設定されていません」というエラーが表示されます。

**注記**  
拡張機能の作成は、アカウントレベルの 1 回限りのアクションです。管理者が拡張機能を作成すると、アカウント内のすべてのユーザーがエンタープライズサインインを使用できます。個々のユーザーは、拡張機能を自分で有効にする必要はありません。デスクトップアプリケーションをダウンロードしてサインインするだけで済みます。

## ステップ 4: デスクトップアプリケーションをダウンロード、検証、配布する
<a name="w2aac51c11c21c19"></a>

このステップでは、デスクトップアプリケーションをダウンロードしてインストールし、エンタープライズサインインが機能することを確認し、アプリケーションをユーザーに配布します。

まず、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 で続行**を選択し、会社の認証情報を使用してサインインします。ユーザーごとの追加の設定は必要ありません。