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

# Credenciais da AWS para seu aplicativo
<a name="sdk-session-credentials"></a>

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](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_StartStreamSession.html). O exemplo a seguir mostra um script de inicialização do Windows (`.bat`arquivo) 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. ](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html#credentialProviderChain)

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, consulte[Forneça credenciais da AWS à aplicação de streaming](session-credentials.md).

**nota**  
Não passe credenciais da AWS por meio de `AdditionalEnvironmentVariables` (como `AWS_ACCESS_KEY_ID` ou`AWS_SECRET_ACCESS_KEY`). Elas têm precedência e impedem que seu aplicativo use as credenciais de função do IAM.