Usar credenciais de variáveis de ambiente

O uso de variáveis de ambiente para conter suas credenciais evita que você compartilhe acidentalmente sua chave de acesso secreta da AWS. Recomendamos que você jamais adicione suas chaves de acesso da AWS diretamente ao cliente em quaisquer arquivos de produção. Muitos desenvolvedores tiveram a conta comprometida por chaves vazadas.

Para fazer a autenticação no Amazon Web Services, o SDK verifica primeiro a existência de credenciais nas variáveis de ambiente. O SDK usa a função getenv() para procurar o AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY e as variáveis de ambiente do AWS_SESSION_TOKEN. Essas credenciais são conhecidas como credenciais de ambiente. Para obter instruções sobre como obter esses valores, consulte Autenticar usando credenciais de curto prazo no Guia de referência de SDKs e ferramentas da AWS.

Se estiver hospedando seu aplicativo no AWS Elastic Beanstalk, você pode definir as variáveis de ambiente AWS_ACCESS_KEY_ID, AWS_SECRET_KEY e AWS_SESSION_TOKEN por meio do console do AWS Elastic Beanstalk para que o SDK possa usar essas credenciais automaticamente.

Para obter mais informações sobre como definir variáveis de ambiente, consulte Suporte a variáveis de ambiente no Guia de referência de SDKs e ferramentas da AWS. Além disso, para ver uma lista de todas as variáveis de ambiente suportadas pela maioria dos AWS SDKs, consulte Lista de variáveis de ambiente.

Você também pode definir variáveis de ambiente na linha de comando, como mostrado aqui.

Linux

$ export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
   # The access key for your Conta da AWS.
$ export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   # The secret access key for your Conta da AWS.
$ export AWS_SESSION_TOKEN=AQoDYXdzEJr...<remainder of security token>
   # The temporary session key for your Conta da AWS. 
   # The AWS_SECURITY_TOKEN environment variable can also be used, but is only supported for backward compatibility purposes.
   # AWS_SESSION_TOKEN is supported by multiple AWS SDKs other than PHP.

Windows

C:\> SET  AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
   # The access key for your Conta da AWS.
C:\> SET  AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   # The secret access key for your Conta da AWS.
C:\> SET AWS_SESSION_TOKEN=AQoDYXdzEJr...<remainder of security token>
   # The temporary session key for your Conta da AWS. 
   # The AWS_SECURITY_TOKEN environment variable can also be used, but is only supported for backward compatibility purposes.
   # AWS_SESSION_TOKEN is supported by multiple AWS SDKs besides PHP.