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

# Amazon WorkSpaces アプリケーションのセッションコンテキスト
<a name="managing-stacks-fleets-session-context"></a>

次のメソッドのいずれかを実行することによって、ストリーミングアプリケーションにパラメータを渡すことができます。
+ CreateStreamingURL WorkSpaces Applications API オペレーションでセッションコンテンツを指定します。詳細については、「[CreateStreamingURL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html)」を参照してください。
+ sts:TagSession アクセス許可を IAM ロールの信頼ポリシーに追加し、セッションコンテキストを SAML 2.0 ID プロバイダーの認証レスポンスで SAML アサーションとして指定します。詳細については、「[ステップ 5: SAML 認証レスポンスのアサーションを作成する](external-identity-providers-setting-up-saml.md#external-identity-providers-create-assertions)」および「[ステップ 5: SAML 認証レスポンスのアサーションを作成する](external-identity-providers-setting-up-saml.md#external-identity-providers-create-assertions)」を参照してください。

イメージが 2018 年 10 月 30 日以降にリリースされたバージョンの WorkSpaces Applications エージェントを使用している場合、セッションコンテキストは Windows または Linux 環境変数としてイメージ内に保存されます。特定の環境変数の詳細については、 のWorkSpaces アプリケーションフリートのユーザーおよびインスタンスメタデータ」を参照してください[Amazon WorkSpaces アプリケーションフリートをカスタマイズしてユーザーのアプリケーションストリーミングエクスペリエンスを最適化する](customize-fleets.md)。

**注記**  
セッションコンテキストパラメータは、WorkSpaces アプリケーションストリーミング URL でユーザーに表示されます。セッションコンテキストパラメータに機密情報や機微情報を入れないことを強くお勧めします。ユーザーがストリーミング URL を変更できるので、セッションコンテキストがエンドユーザーに対して有効であることを確認するために、追加の検証を実行することをお勧めします。たとえば、セッションコンテキストを WorkSpaces アプリケーションフリートのユーザーやインスタンスのメタデータなど、他のセッション情報と比較できます。  
WorkSpaces Applications は、セッションコンテキストパラメータの検証を実行しません。

## セッションコンテキストを使用してストリーミングアプリケーションにパラメータを渡す
<a name="managing-stacks-fleets-parameters"></a>

次の手順では、セッションコンテキストを使用してウェブブラウザをスタートし、特定のウェブサイトを自動的に開きます。Windows を実行しているインスタンスでは、Firefox を使用します。Linux を実行しているインスタンスでは Chromium を使用します。

**セッションコンテキストを使用してウェブサイトを起動するには**

1. 左側のナビゲーションペインで、**[Images]** (イメージ)、**[Image Builder]** の順に選択します。

1. 使用する Image Builder を選択し、**[Running]** (実行中) 状態であることを確認してから、**[Connect]** (接続) を選択します。

1. [**Local User**] (ローカルユーザー) タブで [**管理者**] を選択して、Image Builder にログインします。

1. 子フォルダ `C:\` を作成します。この例では `C:\Scripts` を使用します。

1. 新しいフォルダに Windows バッチファイルを作成します。この例では、`C:\Scripts\session-context-test.bat` を作成し、セッションコンテキストからの URL で Firefox を起動するスクリプトを追加します。

   次のスクリプトを実行します。

   ```
   CD "C:\Program Files (x86)\Mozilla Firefox"
   Start firefox.exe %APPSTREAM_SESSION_CONTEXT%
   ```

1. Image Assistant で `session-context-test.bat` を追加し、名前を **Firefox** に変更します。

   Firefox を追加する必要はありません。この手順では、バッチファイルのみを追加する必要があります。

1. イメージ、フリート、およびスタックを作成します。この例では、**session-context-test-fleet** のフリート名と **session-context-test-stack** のスタック名を使用します。

1. フリートが実行された後で、この例にあるように､`session-context` パラメータで [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html) を呼び出すことができます｡

   ```
   aws appstream create-streaming-url --stack-name session-context-test-stack \ 
   --fleet-name session-context-test-fleet \
   --user-id username –-validity 10000 \
   --application-id firefox --session-context "www.amazon.com"
   ```

1. ブラウザでストリーミング URL を開きます。スクリプトファイルが Firefox を起動し、`http://www.amazon.com` をロードします。

同様に、以下の手順を実行して Linux ストリーミングアプリケーションにパラメータを渡すことができます。

**Linux ストリーミングアプリケーションにパラメータを渡す**

1. 左側のナビゲーションペインで、**[Images]** (イメージ)、**[Image Builder]** の順に選択します。

1. 使用する Image Builder を選択し、**[Running]** (実行中) 状態であることを確認してから、**[Connect]** (接続) を選択します。

1. デフォルトで、**ImageBuilderAdmin** として Image Builder にログインします。

1. 以下のコマンドを実行して、スクリプトファイル (launch-chromium.sh など) を作成します。

   **sudo vim /usr/bin/launch-chromium.sh**

1. 以下の例にあるように、スクリプトを記述して、実行可能な許可を設定します。
**注記**  
スクリプトでは、常に \$1\$1/bin/bash と source /etc/profile が必要です。

   ```
   #!/bin/bash
   source /etc/profile
   /usr/bin/chromium-browser $APPSTREAM_SESSION_CONTEXT
   ```

1. Image Assistant CLI を使用して、launch-chromium.sh を追加します。

   ```
   sudo AppStreamImageAssistant add-application \ 
   --name chromium \
   --absolute-app-path /usr/bin/launch-chromium.sh
   ```

1. イメージ、フリート、およびスタックを作成します。この例では、**session-context-test-fleet** のフリート名と **session-context-test-stack** のスタック名を使用します。

1. フリートが実行された後で、この例にあるように､`session-context` パラメータで [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html) を呼び出すことができます｡

   ```
   aws appstream create-streaming-url --stack-name session-context-test-stack \ 
   --fleet-name session-context-test-fleet \
   --user-id username \
   --application-id chromium --session-context "www.amazon.com"
   ```

1. ブラウザでストリーミング URL を開きます。バッチファイルが Chromium を起動し、`http://www.amazon.com` をロードします｡