Credenciais da AWS para seu aplicativo

Para dar ao seu aplicativo acesso aos recursos da AWS em sua conta — como seus buckets do Amazon S3, tabelas do DynamoDB ou outros serviços da AWS — forneça um ARN de função do IAM ao iniciar uma sessão de stream. O Amazon GameLift Streams assume a função e disponibiliza as credenciais para seu aplicativo automaticamente.

Para configurar as credenciais da sessão, passe o --role-arn parâmetro ao chamar StartStreamSession. O exemplo a seguir mostra um script de inicialização do Windows (.batarquivo) que baixa um arquivo de configuração do Amazon S3 e, em seguida, inicia o aplicativo:

REM --- Configuration ---
SET "S3_CONFIG_PATH=s3://my-app-bucket/configs/app-config.json"
SET "LOCAL_CONFIG_DIR=%TEMP%\my-app-config"
SET "LOCAL_CONFIG_FILE=%LOCAL_CONFIG_DIR%\app-config.json"

REM --- Add AWS CLI to PATH (required for Proton runtime) ---
SET "PATH=%PATH%;C:\Program Files\Amazon\AWSCLIV2"

REM --- Create local directory if it doesn't exist ---
IF NOT EXIST "%LOCAL_CONFIG_DIR%" (mkdir "%LOCAL_CONFIG_DIR%")

REM --- Download configuration file from S3 ---
echo Downloading configuration from %S3_CONFIG_PATH%...
aws s3 cp "%S3_CONFIG_PATH%" "%LOCAL_CONFIG_FILE%"
IF %ERRORLEVEL% NEQ 0 (
    echo ERROR: Failed to download configuration file from S3.
    exit /b 1
)
echo Configuration downloaded to %LOCAL_CONFIG_FILE%.

REM --- Launch the application with config file ---
echo Starting application...
my-app.exe --config "%LOCAL_CONFIG_FILE%" %*
exit /b %ERRORLEVEL%

Não é necessário alterar o código da aplicação. A AWS CLI e todos os SDKs da AWS descobrem e usam automaticamente as credenciais por meio da cadeia de provedores de credenciais do AWS SDK.

A CLI da AWS versão 2.35.11 está disponível em todos os ambientes de execução do Amazon GameLift Streams (Windows, Ubuntu e Proton). O AWS CLI e todos os SDKs da AWS atualizam automaticamente as credenciais durante a vida útil da sessão.

Para ver o guia de configuração completo, incluindo criação de funções do IAM, políticas de confiança e solução de problemas, consulteForneça credenciais da AWS à aplicação de streaming.