View a markdown version of this page

デスクトップで Okta for Amazon Quick を使用してエンタープライズサインインを設定する - Amazon Quick
ステップ 1: Okta で OIDC アプリケーションを作成するステップ 2: Amazon Quick 管理コンソールに拡張機能アクセスを追加するステップ 3: Amazon Quick コンソールで拡張機能を作成するステップ 4: デスクトップアプリケーションをダウンロード、検証、配布する

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

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

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

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

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

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

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

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

注記

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

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

Okta に OIDC ネイティブアプリケーションを登録します。Amazon Quick デスクトップアプリケーションは、このクライアントを使用して、PKCE による認可コードフローを通じてユーザーを認証します。このクライアントにはクライアントシークレットは必要ありません。更新トークン許可タイプを有効にし、アプリケーションが存続期間の長いセッションを維持できるようにoffline_accessスコープを付与します。

詳細については、Okta ドキュメントの「Create OpenID Connect app integrations」を参照してください。

Okta OIDC ネイティブアプリケーションを作成するには

  1. Okta 管理コンソールで、アプリケーション → アプリケーション → アプリケーション統合の作成に移動します。

  2. サインイン方法として OIDC - OpenID Connect を選択します。

  3. アプリケーションタイプとしてネイティブアプリケーションを選択し、次へを選択します。

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

    設定 値
    アプリ統合名 Amazon Quick Desktop
    グラントタイプ 認可コードと更新トークン
    サインインリダイレクト URIs http://localhost:18080
    割り当て 適切なユーザーまたはグループに を割り当てる

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

  6. 全般タブで、クライアント ID を書き留めます。

Okta は、ネイティブアプリケーションに PKCE (S256) を自動的に適用します。

スコープを設定するには

  1. Okta 管理コンソールで、Security → API → Authorization Servers に移動し、認可サーバー (デフォルトなど) を選択します。

  2. スコープタブで、次のスコープが有効になっていることを確認します: openid、email、profile、offline_access。

  3. アクセスポリシータブで、このアプリケーションに割り当てられたポリシーが Authorization Codeおよび Refresh Token 許可タイプを許可していることを確認します。

認証設定を確認するには

  1. アプリ統合で、全般タブに移動します。

  2. 全般設定で、アプリケーションタイプがネイティブ、クライアント認証がなし (パブリッククライアント）、PKCE が必要であることを確認します。

  3. LOGIN で、 http://localhost:18080がリダイレクト URI としてリストされていることを確認します。

  4. 変更を加えた場合は、保存 を選択します。

次の OIDC エンドポイントを記録します。これらの値は、ステップ 2 で前に書き留めたクライアント ID とともに入力します。を Okta ドメイン ( などyour-org.okta.com) <OKTA_DOMAIN>に置き換えます。

フィールド 値
クライアント ID 全般タブのクライアント ID
発行者 URL https://<OKTA_DOMAIN>/oauth2/default
認可エンドポイント https://<OKTA_DOMAIN>/oauth2/default/v1/authorize
トークンエンドポイント https://<OKTA_DOMAIN>/oauth2/default/v1/token
JWKS URI https://<OKTA_DOMAIN>/oauth2/default/v1/keys

ステップ 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 の場合は Download、Mac の場合は Download を選択します。

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

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

エンタープライズサインインを確認するには

  1. Amazon Quick デスクトップアプリケーションを開きます。

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

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

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

ヒント

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

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