Configurar variables de entorno en Linux, macOS y Windows - Alibaba Cloud SDK

Las variables de entorno son parámetros del sistema, específicos del sistema operativo, que tienen nombres y valores determinados. Proporcionan la configuración del entorno de ejecución para las aplicaciones que se ejecutan en el sistema operativo. En este tema se describe cómo establecer un par de AccessKey de Alibaba Cloud en las variables de entorno de Linux, macOS y Windows. De esta forma, sus aplicaciones pueden autenticarse de manera segura sin credenciales codificadas directamente.

Una cuenta de Alibaba Cloud tiene permisos de acceso completos y representa un riesgo de seguridad alto. Para mejorar la seguridad, cree y use un usuario de Resource Access Management (RAM) para acceder o para las tareas diarias de operación y mantenimiento. Antes de llamar a las operaciones de la API, asigne al usuario de RAM los permisos obligatorios para operar sobre los recursos de destino. Para obtener más información sobre cómo conseguir un AccessKey para un usuario de RAM, consulte Create an AccessKey, Manage RAM user permissions y View the AccessKey information of a RAM user. Cuando llame a una API con un AccessKey, no lo incluya como texto plano en su código. Configure variables de entorno o use otro método seguro para evitar exponer su AccessKey.

Establecer un AccessKey de Alibaba Cloud en las variables de entorno de Linux y macOS

En esta sección se usan como ejemplo las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET. Puede cambiar los nombres de las variables según sus necesidades; por ejemplo, OSS_ACCESS_KEY_ID y OSS_ACCESS_KEY_SECRET.

Configure las variables de entorno mediante el comando export:

Importante

Una variable de entorno temporal configurada con el comando export solo es válida para la sesión actual. La variable se elimina cuando termina la sesión. Para conservarla a largo plazo, agregue el comando export al archivo de configuración de inicio de su sistema operativo.

Configure el AccessKey ID y presione Entrar.

# Replace yourAccessKeyID with your AccessKey ID.
export ALIBABA_CLOUD_ACCESS_KEY_ID=yourAccessKeyID

Configure el secreto del AccessKey y presione Entrar.

# Replace yourAccessKeySecret with your AccessKey secret.
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=yourAccessKeySecret

Compruebe la configuración.

Ejecute el comando echo $ALIBABA_CLOUD_ACCESS_KEY_ID. Si el comando devuelve el AccessKey ID correcto, la configuración es exitosa.

Establecer un AccessKey de Alibaba Cloud en las variables de entorno de Windows

Usar la interfaz gráfica de usuario (GUI)

Procedimiento

A continuación se describen los pasos para configurar variables de entorno mediante la GUI en Windows 10.

En el escritorio, haga clic derecho en This PC y elija Properties > Advanced system settings > Environment Variables > New, ya sea en System variables o en User variables. Después, complete la configuración.

Variable	Valor de ejemplo
AccessKey ID	Nombre de la variable: ALIBABA_CLOUD_ACCESS_KEY_ID Valor de la variable: yourAccessKeyID
Secreto del AccessKey	Nombre de la variable: ALIBABA_CLOUD_ACCESS_KEY_SECRET Valor de la variable: yourAccessKeySecret

Comprobar la configuración

Haga clic en Start (o use el atajo de teclado Win+R), haga clic en Run, introduzca cmd y luego haga clic en OK (o presione Entrar) para abrir el símbolo del sistema. Ejecute los comandos echo %ALIBABA_CLOUD_ACCESS_KEY_ID% y echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%. Si los comandos devuelven el AccessKey correcto, la configuración es exitosa.

Usar el símbolo del sistema (CMD)

Procedimiento

Abra el símbolo del sistema como administrador y ejecute los siguientes comandos para agregar nuevas variables de entorno al sistema.
```
setx ALIBABA_CLOUD_ACCESS_KEY_ID yourAccessKeyID /M
setx ALIBABA_CLOUD_ACCESS_KEY_SECRET yourAccessKeySecret /M
```
El parámetro /M indica que se trata de una variable de entorno del sistema. Puede omitir este parámetro cuando configure una variable de entorno de usuario.
Comprobar la configuración

Haga clic en Start (o use el atajo de teclado Win+R), haga clic en Run, introduzca cmd y luego haga clic en OK (o presione Entrar) para abrir el símbolo del sistema. Ejecute los comandos echo %ALIBABA_CLOUD_ACCESS_KEY_ID% y echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%. Si los comandos devuelven el AccessKey correcto, la configuración es exitosa.

Usar Windows PowerShell

En PowerShell, puede configurar nuevas variables de entorno válidas para todas las sesiones nuevas:

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

Para configurar variables de entorno para todos los usuarios, necesita permisos de administrador:

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

También puede configurar variables de entorno temporales que solo sean válidas para la sesión actual:

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

En PowerShell, ejecute los comandos Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_ID y Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_SECRET. Si los comandos devuelven el AccessKey correcto, la configuración es exitosa.

Importante

Después de configurar las variables de entorno, es posible que deba reiniciar sus herramientas de desarrollo, como los entornos de desarrollo integrados (IDE), o los servicios para que la nueva configuración surta efecto.