View a markdown version of this page

デスクトップで Google WorkSpace for Amazon Quick を使用してエンタープライズサインインを設定する - Amazon Quick

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

デスクトップで Google WorkSpace for Amazon Quick を使用してエンタープライズサインインを設定する

 適用先: Enterprise Edition 
   対象者: システム管理者 

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

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

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

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

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

注記

開始する前に、「」の前提条件を確認してくださいエンタープライズデプロイ用のデスクトップでの Amazon Quick のセットアップ

ステップ 1: Google Workspace で OIDC アプリケーションを作成する

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

詳細については、Google for Developers ドキュメントのOAuth 2.0 for Mobile & Desktop Apps」を参照してください。

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

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

    設定
    アプリケーションタイプ デスクトップアプリ
    名前 Amazon Quick Desktop
  3. [作成] を選択します。

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

OAuth 同意画面を設定するには
  1. Google クラウドコンソールで、Google 認証プラットフォーム → ブランディングに移動します。

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

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

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

  2. 次のスコープを追加します: openidemailprofile

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

次の 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 管理コンソールに拡張機能アクセスを追加する

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

拡張機能アクセスを追加するには
  1. Amazon Quick 管理コンソールにサインインし、アカウントの管理を選択します。

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

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

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

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

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

    重要

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

ステップ 3: Amazon Quick コンソールで拡張機能を作成する

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

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

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

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

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

重要

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

注記

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

ステップ 4: デスクトップアプリケーションをダウンロード、検証、配布する

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

まず、Amazon Quick コンソールからアプリケーションをダウンロードします。

デスクトップアプリケーションをダウンロードするには
  1. Amazon Quick コンソールの左側のナビゲーションペインで、拡張機能を選択します。拡張機能が表示されない場合は、詳細を選択して検索します。

  2. ステップ 3 で作成したクイックデスクトップ拡張機能を選択します。

  3. 拡張機能のその他のオプションアイコン (...) を選択します。

  4. オペレーティングシステムに応じて、Windows の場合は DownloadMac の場合は Download を選択します。

次に、アプリケーションをインストールします。インストール手順については、「はじめに」を参照してください。

アプリケーションをインストールしたら、エンタープライズサインインが機能することを確認します。

エンタープライズサインインを確認するには
  1. Amazon Quick デスクトップアプリケーションを開きます。

  2. サインイン画面で、「SSO で続行」を選択します。

  3. (オプション) AWS リージョン リストから を選択するか、動的 を選択して、アプリケーションがリージョンを自動的に検出するようにします。

  4. 会社の認証情報を使用して認証します。アプリケーションは ID プロバイダーにリダイレクトされ、認証が成功するとホーム画面に戻ります。

ヒント

サインインに失敗した場合は、ステップ 2 で入力した値をステップ 1 の OIDC エンドポイントとクライアント ID と照合します。値が正しくない場合は、Amazon Quick 管理コンソールのアクセス許可 → 拡張機能アクセスで拡張機能アクセスを削除し、正しい値でステップ 2 を繰り返します。詳細については、「」を参照してくださいデスクトップでの Amazon Quick のエンタープライズサインインのトラブルシューティング

最後に、セットアップを確認したら、アプリケーションをユーザーに配布します。ダウンロード、インストール、サインインの手順はじめにについては、「」を参照してください。ユーザーは SSO で続行を選択し、会社の認証情報を使用してサインインします。ユーザーごとの追加の設定は必要ありません。