View a markdown version of this page

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

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

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

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

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

  1. Ping Identity 製品 (PingFederate または PingOne) に OIDC アプリケーションを作成し、その値を記録します。

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

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

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

注記

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

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

Ping Identity 製品にパブリック OIDC クライアントを登録します。Amazon Quick デスクトップアプリケーションは、このクライアントを使用して、PKCE による認可コードフローを通じてユーザーを認証します。このクライアントにはクライアントシークレットは必要ありません。更新トークン許可タイプを有効にし、offline_accessスコープを付与します。Ping Identity 製品の手順を選択します。

PingFederate

詳細については、PingFederate での OIDC アプリケーションのセットアップ」を参照してください。

PingFederate OIDC クライアントを作成するには

  1. PingFederate 管理コンソールで、Applications → OAuth → Clients に移動し、Add Client を選択します。

  2. クライアント ID フィールドに、このクライアントの一意の識別子を入力します。

  3. [名前] フィールドに Amazon Quick Desktop を入力してください。

  4. クライアント認証で、なしを選択します。

  5. リダイレクト URI セクションで、「追加」と入力http://localhost:18080し、「追加」を選択します。

  6. 許可されたグラントタイプリストで、認可コードと更新トークンを選択します。

  7. コード交換に必要な証明キー (PKCE) チェックボックスをオンにします。

  8. 共通スコープで、、openid、emailprofile、 を付与しますoffline_access。

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

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

OIDC ポリシーを設定するには

  1. PingFederate 管理コンソールで、アプリケーション → OAuth → OpenID Connect ポリシー管理に移動します。

  2. このクライアントに関連付けられた OIDC ポリシーを選択するか、ポリシーの追加を選択して作成します。

  3. 更新時の ID トークンの付与を返すチェックボックスをオンにします。これにより、セッションを更新するときに、デスクトップアプリケーションは現在のクレームを含む新しい ID トークンを受信します。

  4. 属性契約で、emailクレームが含まれ、認証ソースの対応するユーザー属性にマッピングされていることを確認します。email クレームは、最初の認証と更新トークンの付与の両方で発行されたトークンに存在する必要があります。

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

次の OIDC エンドポイントを記録します。これらの値は、ステップ 2 で前に書き留めたクライアント ID とともに入力します。を PingFederate サーバーのホスト名<PINGFEDERATE_HOST>に置き換えます。

フィールド 値
クライアント ID クライアントの作成時に入力したクライアント ID
発行者 URL https://<PINGFEDERATE_HOST>
認可エンドポイント https://<PINGFEDERATE_HOST>/as/authorization.oauth2
トークンエンドポイント https://<PINGFEDERATE_HOST>/as/token.oauth2
JWKS URI https://<PINGFEDERATE_HOST>/pf/JWKS

PingOne

詳細については、Ping Identity ドキュメントの「アプリケーションの編集 – ネイティブ」を参照してください。

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

  1. PingOne 管理者コンソールで、アプリケーション → アプリケーションに移動し、+ アイコンを選択します。

  2. アプリケーション名Amazon Quick Desktopとして を入力します。

  3. アプリケーションタイプセクションで、ネイティブを選択し、保存を選択します。

  4. 設定タブで、編集 を選択し、次の設定を設定します。

    設定 値
    レスポンスタイプ コード
    グラントタイプ 認可コードと更新トークン
    PKCE の適用 S256
    リダイレクト URI http://localhost:18080
    トークンエンドポイント認証方法 なし

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

  6. リソースタブで、、openid、email、 profileのスコープを追加しますoffline_access。

  7. 属性マッピングタブで、email属性がユーザーの E メールアドレスにマッピングされていることを確認します。

  8. アプリケーションを Enabled に切り替えます。

  9. 設定タブのクライアント ID と環境 ID を書き留めます。

注記

PingOne ドメインはリージョンによって異なります。次の例では .com を使用しています。ドメインを環境のドメイン (、、 など) .caに置き換えます.eu.asia。

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

フィールド 値
クライアント ID 設定タブのクライアント ID
発行者 URL https://auth.pingone.com/<ENV_ID>/as
認可エンドポイント https://auth.pingone.com/<ENV_ID>/as/authorize
トークンエンドポイント https://auth.pingone.com/<ENV_ID>/as/token
JWKS URI https://auth.pingone.com/<ENV_ID>/as/jwks

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