Contexto da sessão no Amazon AppStream 2.0 - WorkSpaces Aplicativos da Amazon
Uso do contexto da sessão para passar parâmetros para um aplicativo de streaming

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 no Amazon AppStream 2.0

Você pode enviar parâmetros para a aplicação de streaming utilizando um dos seguintes métodos:

Se a imagem usar uma versão do agente do AppStream 2.0 que foi lançada a partir de 30 de outubro de 2018, o contexto da sessão será armazenado na imagem como uma variável de ambiente do Windows ou Linux. Para obter informações sobre variáveis de ambiente específicas, consulte “User and Instance Metadata for AppStream 2.0 Fleets” em Personalize uma frota de WorkSpaces aplicativos da Amazon para otimizar a experiência de streaming de aplicativos de seus usuários .

nota

O parâmetro de contexto da sessão é visível para o usuário no URL de streaming do AppStream 2.0. É 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 do AppStream 2.0.

O AppStream 2.0 não executa 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).

  2. Selecione o criador de imagens a ser usado, verifique se está no estado Running (Em execução) e selecione Connect (Conectar).

  3. Faça login no criador de imagens escolhendo Administrator (Administrator) na guia Local User (Usuário local).

  4. Crie uma pasta filho de C:\. Neste exemplo, use C:\Scripts.

  5. 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%

  6. 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.

  7. 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.

  8. Quando a frota estiver em execução, você poderá chamar create-streaming-url com o parâmetro session-context 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"

  9. 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).

  2. Selecione o criador de imagens a ser usado, verifique se está no estado Running (Em execução) e selecione Connect (Conectar).

  3. Faça login padrão no construtor de imagens como ImageBuilderAdmin.

  4. Crie um arquivo de script (por exemplo, launch-chromium.sh) executando o seguinte comando:

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

  5. Escreva o script e defina permissões executáveis, como as seguintes:

    nota

    #!/bin/bash e source /etc/profile são sempre necessárias no script.

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

  6. 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

  7. 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.

  8. Quando a frota estiver em execução, você poderá chamar create-streaming-url com o parâmetro session-context 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"

  9. Abra a URL de streaming em um navegador. O arquivo em lotes inicializa o Chromium e carrega o site http://www.amazon.com.