As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Contexto da sessão em WorkSpaces aplicativos da Amazon
Você pode enviar parâmetros para a aplicação de streaming utilizando um dos seguintes métodos:
+ Especifique o conteúdo da sessão na operação da API de WorkSpaces aplicativos de CreateStreaming URL. Para obter mais informações, consulte [CreateStreamingURL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html).
+ Adicione a TagSession permissão sts: à política de confiança da sua função do IAM e especifique o contexto da sessão como uma declaração SAML na resposta de autenticação do seu provedor de identidade SAML 2.0. Para obter mais informações, consulte [Etapa 5: criar declarações para a resposta de autenticação de SAML](external-identity-providers-setting-up-saml.md#external-identity-providers-create-assertions) e [Etapa 5: criar declarações para a resposta de autenticação de SAML](external-identity-providers-setting-up-saml.md#external-identity-providers-create-assertions).
Se sua imagem usa uma versão do agente de WorkSpaces aplicativos lançada em ou após 30 de outubro de 2018, o contexto da sessão é armazenado na imagem como uma variável de ambiente Windows ou Linux. Para obter informações sobre variáveis de ambiente específicas, consulte “Metadados de usuário e instância para frotas de WorkSpaces aplicativos” em. [Personalize uma frota de WorkSpaces aplicativos da Amazon para otimizar a experiência de streaming de aplicativos de seus usuários](customize-fleets.md)
**nota**
O parâmetro de contexto da sessão é visível para o usuário na URL de streaming dos WorkSpaces aplicativos. É altamente recomendável que você nunca coloque informações confidenciais ou sigilosas no parâmetro de contexto da sessão. Como é possível que os usuários modifiquem o URL de streaming, recomendamos realizar uma validação adicional para determinar se o contexto da sessão é válido para o usuário final. Por exemplo, você pode comparar o contexto da sessão com outras informações da sessão, como metadados de usuário e instância para frotas de WorkSpaces aplicativos.
WorkSpaces Os aplicativos não realizam a validação no parâmetro de contexto da sessão.
## Uso do contexto da sessão para passar parâmetros para um aplicativo de streaming
Nas etapas a seguir, você usará o contexto da sessão para iniciar um navegador da web e abrir automaticamente um site específico. Para instâncias que executam o Windows, você usará o Firefox. Para instâncias que executam o Linux, você usará o Chromium.
**Para usar o contexto de sessão para iniciar um site**
1. No painel de navegação esquerdo, selecione **Images (Imagens)**, **Image Builder (Criador de imagens)**.
1. Selecione o criador de imagens a ser usado, verifique se está no estado **Running (Em execução)** e selecione **Connect (Conectar)**.
1. Faça login no criador de imagens escolhendo **Administrator (Administrator)** na guia **Local User (Usuário local)**.
1. Crie uma pasta filho de `C:\`. Neste exemplo, use `C:\Scripts`.
1. Crie um arquivo em lotes do Windows na nova pasta. Para este exemplo, crie `C:\Scripts\session-context-test.bat` e adicione um script que inicie o Firefox com o URL do contexto de sessão.
Use o seguinte script:
```
CD "C:\Program Files (x86)\Mozilla Firefox"
Start firefox.exe %APPSTREAM_SESSION_CONTEXT%
```
1. No Image Assistant, adicione `session-context-test.bat` e altere o nome para **Firefox**.
Você não precisa adicionar o Firefox. Esta etapa exige que você adicione apenas o arquivo em lote.
1. Crie uma imagem, uma frota e uma pilha. Para este exemplo, use um nome de frota **session-context-test-fleet** e um nome de pilha **session-context-test-stack**.
1. Depois que a frota estiver em execução, você poderá chamar [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html)com o `session-context` parâmetro, conforme mostrado neste exemplo.
```
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. Abra a URL de streaming em um navegador. O arquivo do script inicializa o Firefox e carrega o site `http://www.amazon.com`.
De modo semelhante, execute as etapas a seguir para enviar parâmetros à sua aplicação de streaming do Linux.
**Como enviar parâmetros a uma aplicação de streaming do Linux**
1. No painel de navegação esquerdo, selecione **Images (Imagens)**, **Image Builder (Criador de imagens)**.
1. Selecione o criador de imagens a ser usado, verifique se está no estado **Running (Em execução)** e selecione **Connect (Conectar)**.
1. Faça login no construtor de imagens por padrão como **ImageBuilderAdmin**.
1. Crie um arquivo de script (por exemplo, launch-chromium.sh) executando o seguinte comando:
**sudo vim /usr/bin/launch-chromium.sh**
1. Escreva o script e defina permissões executáveis, como as seguintes:
**nota**
\$1\$1 /bin/bash and source /etc/profilesão sempre obrigatórios no script.
```
#!/bin/bash
source /etc/profile
/usr/bin/chromium-browser $APPSTREAM_SESSION_CONTEXT
```
1. Use a CLI do Assistente de Imagens para adicionar launch-chromium.sh:
```
sudo AppStreamImageAssistant add-application \
--name chromium \
--absolute-app-path /usr/bin/launch-chromium.sh
```
1. Crie uma imagem, uma frota e uma pilha. Para este exemplo, use um nome de frota **session-context-test-fleet** e um nome de pilha **session-context-test-stack**.
1. Depois que a frota estiver em execução, você poderá chamar [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html)com o `session-context` parâmetro, conforme mostrado neste exemplo.
```
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. Abra a URL de streaming em um navegador. O arquivo em lotes inicializa o Chromium e carrega o site `http://www.amazon.com`.