Todos os produtos
Search
Central de documentação

Alibaba Cloud SDK:Configure variáveis de ambiente no Linux, macOS e Windows

Última atualização: Jul 05, 2026

Defina um par de AccessKey do Alibaba Cloud como variáveis de ambiente no Linux, macOS e Windows para que seus aplicativos se autentiquem com segurança, sem credenciais codificadas.

A conta Alibaba Cloud tem acesso total aos recursos e apresenta altos riscos de segurança. Recomendamos usar um usuário RAM com apenas as permissões necessárias. Para obter o par de AccessKey de um usuário RAM, consulte Crie um AccessKey e Gerencie permissões para um usuário RAM. Nunca codifique AccessKeys em texto simples no código. Use variáveis de ambiente ou outros métodos seguros.

Linux e macOS

Os exemplos a seguir usam ALIBABA_CLOUD_ACCESS_KEY_ID e ALIBABA_CLOUD_ACCESS_KEY_SECRET como nomes de variáveis. Se necessário, substitua-os por nomes personalizados, como OSS_ACCESS_KEY_ID e OSS_ACCESS_KEY_SECRET.

Execute os comandos export abaixo para definir as variáveis de ambiente:

Importante

As variáveis definidas com export são temporárias e válidas apenas na sessão atual. Para torná-las persistentes, adicione o comando export ao arquivo de inicialização do shell (como ~/.bashrc ou ~/.zshrc).

  • Defina o AccessKey ID:

    # Replace yourAccessKeyID with your AccessKey ID.
    export ALIBABA_CLOUD_ACCESS_KEY_ID=yourAccessKeyID
  • Defina o AccessKey Secret:

    # Replace yourAccessKeySecret with your AccessKey secret.
    export ALIBABA_CLOUD_ACCESS_KEY_SECRET=yourAccessKeySecret
  • Verifique a configuração.

    Execute echo $ALIBABA_CLOUD_ACCESS_KEY_ID. A configuração será bem-sucedida se o sistema retornar o valor correto.

Windows

Os exemplos a seguir usam ALIBABA_CLOUD_ACCESS_KEY_ID e ALIBABA_CLOUD_ACCESS_KEY_SECRET como nomes de variáveis. Se necessário, substitua-os por nomes personalizados, como OSS_ACCESS_KEY_ID e OSS_ACCESS_KEY_SECRET.

Use GUI

  • Procedimento

    Para configurar variáveis de ambiente pela interface gráfica do Windows 10:

    Clique em com o botão direito em This PC na área de trabalho e selecione Properties. Clique em Advanced system settings. Na guia Advanced, clique em Environment Variables. Clique em New na seção User variables ou System variables e adicione as seguintes variáveis.

    Variável

    Exemplo

    AccessKey ID

    • Nome da variável: ALIBABA_CLOUD_ACCESS_KEY_ID

    • Valor da variável: LTAI

    AccessKey Secret

    • Nome da variável: ALIBABA_CLOUD_ACCESS_KEY_SECRET

    • Valor da variável: yourAccessKeySecret

  • Verifique a configuração.

    Pressione Win+R, insira cmd e pressione Enter. Execute echo %ALIBABA_CLOUD_ACCESS_KEY_ID% e echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%. A configuração será bem-sucedida se o sistema retornar os valores corretos.

Use CMD

  • Procedimento

    Abra o Prompt de Comando como administrador e execute os seguintes comandos:

    setx ALIBABA_CLOUD_ACCESS_KEY_ID yourAccessKeyID /M
    setx ALIBABA_CLOUD_ACCESS_KEY_SECRET XXXXXXX /M

    O parâmetro /M define uma variável de sistema. Omita-o para definir uma variável de usuário.

  • Verifique a configuração.

    Pressione Win+R, insira cmd e pressione Enter. Execute echo %ALIBABA_CLOUD_ACCESS_KEY_ID% e echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%. A configuração será bem-sucedida se o sistema retornar os valores corretos.

Use Windows PowerShell

Defina variáveis de ambiente persistentes para o usuário atual. Elas entram em vigor em todas as novas sessões.

[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'yourAccessKeyID', [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'XXXXXXX', [System.EnvironmentVariableTarget]::User)

Defina variáveis de ambiente para todos os usuários (requer privilégios de administrador):

[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'yourAccessKeyID', [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'XXXXXXX', [System.EnvironmentVariableTarget]::Machine)

Defina variáveis apenas para a sessão atual:

$env:ALIBABA_CLOUD_ACCESS_KEY_ID = "yourAccessKeyID"
$env:ALIBABA_CLOUD_ACCESS_KEY_SECRET = "XXXXXXX"

Execute Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_ID e Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_SECRET. A configuração será bem-sucedida se o sistema retornar os valores corretos.

Importante

Após configurar as variáveis de ambiente, reinicie sua IDE ou serviços relacionados para aplicar as alterações.