Configurar ADC para un entorno on-premise u otro proveedor de servicios en la nube

Si ejecutas tu aplicación fuera de Google Cloud, debes proporcionar credenciales que Google Cloud reconozca para usar los servicios de Google Cloud .

Federación de identidades de cargas de trabajo

La forma preferida de autenticarse con Google Cloud usando credenciales de un proveedor de identidades externo es usar Workload Identity Federation. Para ello, debes crear un archivo de configuración de credenciales y asignar a la variable de entorno GOOGLE_APPLICATION_CREDENTIALS la ruta a ese archivo. Este método es más seguro que crear una clave de cuenta de servicio.

Para obtener ayuda sobre cómo configurar la federación de identidades de cargas de trabajo para ADC, consulta Federación de identidades de cargas de trabajo con otras nubes.

Clave de cuenta de servicio

Si no puedes configurar la federación de identidades de carga de trabajo, debes crear una cuenta de servicio, concederle los roles de gestión de identidades y accesos que necesite tu aplicación y crear una clave para la cuenta de servicio.

Nota: Las claves de las cuentas de servicio suponen un riesgo para la seguridad si no se gestionan adecuadamente. Siempre que sea posible, deberías elegir una alternativa más segura a las claves de cuentas de servicio. Si debes autenticarte con una clave de cuenta de servicio, eres responsable de la seguridad de la clave privada y de otras operaciones descritas en las prácticas recomendadas para gestionar las claves de cuentas de servicio. Si no puedes crear una clave de cuenta de servicio, es posible que la creación de claves de cuenta de servicio esté inhabilitada en tu organización. Para obtener más información, consulta el artículo sobre gestionar recursos de organización seguros de forma predeterminada.

Si has obtenido la clave de cuenta de servicio de una fuente externa, debes validarla antes de usarla. Para obtener más información, consulta los requisitos de seguridad de las credenciales de fuentes externas.

Para crear una clave de cuenta de servicio y que esté disponible para ADC, sigue estos pasos:

1. Crea una cuenta de servicio con los roles que necesite tu aplicación y una clave para esa cuenta de servicio. Para ello, sigue las instrucciones que se indican en el artículo Crear una clave de cuenta de servicio.

2. Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.

   Example: Linux or macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Replace KEY_PATH with the path of the JSON file that contains your credentials.

   For example:

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   Example: Windows

   For PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Replace KEY_PATH with the path of the JSON file that contains your credentials.

   For example:

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

   For command prompt:

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Replace KEY_PATH with the path of the JSON file that contains your credentials.

Nota: Cuando defines la variable de entorno GOOGLE_APPLICATION_CREDENTIALS, ADC comprueba primero esta ubicación y, a continuación, comprueba otras ubicaciones solo si es necesario.

Siguientes pasos

• Consulta información sobre la federación de identidades de cargas de trabajo.
• Consulta las prácticas recomendadas para usar las claves de cuentas de servicio.
• Más información sobre cómo encuentra las credenciales ADC
• Consulta los métodos de autenticación.