Autenticarse en Dataform

En este documento se describe cómo autenticarse en Dataform mediante programación. La forma de autenticarte en Dataform depende de la interfaz que uses para acceder a la API y del entorno en el que se ejecute tu código.

Para obtener más información sobre la autenticación, consulta los métodos de autenticación. Google Cloud

Acceso a la API

Dataform admite el acceso programático. Puedes acceder a la API de las siguientes formas:

Bibliotecas de cliente

Las bibliotecas de cliente de Dataform proporcionan compatibilidad con lenguajes de alto nivel para autenticarte en Dataform de forma programática. Para autenticar las llamadas a las APIs de Google Cloud , las bibliotecas de cliente admiten las credenciales predeterminadas de la aplicación (ADC). Las bibliotecas buscan credenciales en un conjunto de ubicaciones definidas y las usan para autenticar las solicitudes a la API. Con ADC, puede poner credenciales a disposición de su aplicación en diversos entornos, como el desarrollo local o la producción, sin necesidad de modificar el código de la aplicación.

REST

Puedes autenticarte en la API de Dataform con tus credenciales de la CLI de gcloud o con las credenciales de aplicación predeterminadas. Para obtener más información sobre la autenticación de solicitudes REST, consulta el artículo Autenticación para usar REST. Para obtener información sobre los tipos de credenciales, consulta Credenciales de la CLI de gcloud y credenciales de ADC.

Configurar la autenticación para Dataform

La forma de configurar la autenticación depende del entorno en el que se ejecute el código.

Estas son las opciones más habituales para configurar la autenticación. Para obtener más opciones e información sobre la autenticación, consulta Métodos de autenticación.

En un entorno de desarrollo local

Puedes configurar las credenciales de un entorno de desarrollo local de las siguientes formas:

Bibliotecas de cliente o herramientas de terceros

Configura las credenciales predeterminadas de la aplicación (ADC) en tu entorno local:

  1. Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command: 

    gcloud init

    If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. If you're using a local shell, then create local authentication credentials for your user account: 

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Aparecerá una pantalla de inicio de sesión. Después de iniciar sesión, tus credenciales se almacenan en el archivo de credenciales local que usa ADC.

Para obtener más información sobre cómo trabajar con ADC en un entorno local, consulta el artículo Configurar ADC en un entorno de desarrollo local.

Solicitudes REST desde la línea de comandos

Cuando haces una solicitud REST desde la línea de comandos, puedes usar tus credenciales de la CLI de gcloud incluyendo gcloud auth print-access-token como parte del comando que envía la solicitud.

En el siguiente ejemplo se enumeran las cuentas de servicio del proyecto especificado. Puedes usar el mismo patrón para cualquier solicitud REST.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: tu ID de proyecto Google Cloud .

Para enviar tu solicitud, despliega una de estas opciones:

 

Para obtener más información sobre la autenticación mediante REST y gRPC, consulta el artículo Autenticarse para usar REST. Para obtener información sobre la diferencia entre tus credenciales de ADC locales y tus credenciales de la CLI de gcloud, consulta Configuración de la autenticación de la CLI de gcloud y configuración de ADC.

Suplantación de identidad de cuentas de servicio

En la mayoría de los casos, puedes usar tus credenciales de usuario para autenticarte desde un entorno de desarrollo local. Si no es posible o necesitas probar los permisos asignados a una cuenta de servicio, puedes usar la suplantación de identidad de la cuenta de servicio. Debes tener el permiso iam.serviceAccounts.getAccessToken, que está incluido en el rol de gestión de identidades y accesos Creador de tokens de cuenta de servicio (roles/iam.serviceAccountTokenCreator).

Puedes configurar gcloud CLI para que use la suplantación de identidad de la cuenta de servicio con el comando gcloud config set: 

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

En algunos idiomas, puedes usar la suplantación de identidad de la cuenta de servicio para crear un archivo ADC local que puedan usar las bibliotecas de cliente. Este enfoque solo se admite en las bibliotecas de cliente de Go, Java, Node.js y Python. No se admite en otros lenguajes. Para configurar un archivo ADC local con la suplantación de identidad de una cuenta de servicio, usa la marca --impersonate-service-account con el comando gcloud auth application-default login: 

gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

Para obtener más información sobre la suplantación de identidad de cuentas de servicio, consulta el artículo Usar la suplantación de identidad de cuentas de servicio.

Control de acceso de Dataform

Una vez que te hayas autenticado en Dataform, debes tener autorización para acceder a los recursos de Google Cloud . Dataform usa Gestión de Identidades y Accesos (IAM) para la autorización.

Para obtener más información sobre los roles de Dataform, consulta Control de acceso con IAM. Para obtener más información sobre la gestión de identidades y accesos y la autorización, consulta la descripción general de la gestión de identidades y accesos.

Siguientes pasos