Puedes configurar una cuenta de servicio de Google Cloud para que Data Studio pueda acceder a tus datos de BigQuery sin depender de las credenciales de usuarios individuales. Delegar el acceso a una cuenta de servicio puede ayudarte a cumplir con los requisitos de seguridad y mantener las fuentes de datos en funcionamiento, incluso si la persona que las creó abandona tu organización.
Este documento está dirigido a los administradores de Google Cloud que desean configurar una cuenta de servicio para Data Studio. Para usar una cuenta de servicio existente en una fuente de datos, consulta Credenciales de datos.
Conceptos clave
Cuando configuras una cuenta de servicio para Data Studio, es útil comprender los siguientes conceptos:
- Cuenta de servicio: Es una identidad que actúa como un usuario no humano para acceder a los datos de BigQuery. Tú creas y administras la cuenta de servicio.
- Agente de servicio de Data Studio: Es un tipo especial de cuenta de servicio que Google Cloud crea y administra. El agente de servicio permite que Data Studio acceda a los recursos en tu nombre.
- Cómo funcionan juntos el agente de servicio y la cuenta de servicio: Data Studio usa el agente de servicio para actuar en nombre de tu cuenta de servicio. Tu cuenta de servicio tiene los permisos para leer los datos de BigQuery.
Para obtener más información, consulta Descripción general de cuentas de servicio.
Beneficios de usar una cuenta de servicio con Data Studio
Usar una cuenta de servicio en lugar de las credenciales de un usuario individual proporciona los siguientes beneficios:
- Continuidad empresarial: Las fuentes de datos que usan credenciales de cuentas de servicio no dejarán de funcionar si el creador abandona la empresa.
- Compatibilidad con los Controles del servicio de VPC: Las funciones automatizadas, como los correos electrónicos programados, las alertas por correo electrónico y las extracciones de datos programadas, funcionan con fuentes de datos que se encuentran dentro de un perímetro de los Controles del servicio de VPC. Para obtener más información, consulta Notas y límites.
- Compatibilidad con políticas de dispositivos: Las credenciales de cuenta de servicio admiten el acceso a los datos que se encuentran detrás de los perímetros de los Controles del servicio de VPC que usan políticas de dispositivos.
- Reglas de entrada y salida: Puedes crear reglas de entrada y salida para permitir que la cuenta de servicio acceda a los recursos y clientes protegidos por los perímetros de servicio, y viceversa.
- Cumplimiento de la política de la organización: Si las políticas de Google Workspace de tu organización restringen las credenciales del propietario para evitar el uso compartido de datos de forma generalizada, las cuentas de servicio proporcionan una alternativa que los administradores controlan. Puedes delegar el acceso sin exponer las credenciales humanas individuales ni otorgar permisos excesivos.
- Control de acceso detallado: Puedes otorgar a la cuenta de servicio acceso solo a conjuntos de datos o tablas específicos de BigQuery, lo que respalda el principio de privilegio mínimo. Luego, puedes controlar qué usuarios de Data Studio pueden actuar en nombre de esa cuenta de servicio o usarla.
Roles obligatorios
En las siguientes secciones, se muestran los roles que se necesitan para configurar una cuenta de servicio para Data Studio.
Para administradores
Para obtener la dirección de correo electrónico del agente de servicio de Data Studio, debes ser usuario de Google Workspace o Cloud Identity.
Si deseas obtener los permisos que necesitas para configurar una cuenta de servicio para Data Studio, pídele a tu administrador que te otorgue los siguientes roles de IAM:
-
Configura una cuenta de servicio:
- Administrador de cuentas de servicio (
roles/iam.serviceAccountAdmin) en tu proyecto - Crea cuentas de servicio (
roles/iam.serviceAccountCreator) en tu proyecto
- Administrador de cuentas de servicio (
-
Configura el acceso a un conjunto de datos o una tabla de BigQuery:
Propietario de datos de BigQuery (
roles/bigquery.dataOwner) en el conjunto de datos o la tabla
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para configurar una cuenta de servicio para Data Studio. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para configurar una cuenta de servicio para Data Studio:
-
Configura una cuenta de servicio:
iam.serviceAccounts.createen tu proyecto -
Configura el acceso a un conjunto de datos o una tabla de BigQuery:
-
bigquery.datasets.setIamPolicyen el conjunto de datos -
bigquery.tables.setIamPolicyen la tabla
-
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Para la cuenta de servicio
Para garantizar que la cuenta de servicio tenga los permisos necesarios para acceder a los datos de BigQuery para Data Studio, pídele a tu administrador que otorgue los siguientes roles de IAM a la cuenta de servicio:
- Visualizador de datos de BigQuery (
roles/bigquery.dataViewer) en las tablas o los conjuntos de datos específicos que la cuenta de servicio necesita leer - Usuario de trabajo de BigQuery (
roles/bigquery.jobUser) en el proyecto de facturación (el proyecto de Google Cloud que ejecuta y paga los trabajos de consulta)
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para acceder a los datos de BigQuery para Data Studio. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para acceder a los datos de BigQuery en Data Studio:
-
bigquery.tables.getDataen las tablas o los conjuntos de datos específicos que la cuenta de servicio necesita leer -
bigquery.jobs.createen el proyecto de facturación
Es posible que tu administrador también pueda otorgar estos permisos a la cuenta de servicio con roles personalizados o con otros roles predefinidos.
Instrucciones de configuración
Para configurar una cuenta de servicio que proporcione acceso a los datos de BigQuery, completa los siguientes pasos:
- Obtén el agente de servicio de Data Studio: Copia la dirección de correo electrónico del agente de servicio para usarla en un paso posterior.
- Crea una cuenta de servicio para Data Studio: Crea la identidad de usuario no humano que accede a los datos.
- Permite que el agente de servicio de Data Studio acceda a tu cuenta de servicio: Otorga al agente de servicio el rol necesario en la cuenta de servicio.
- Otorga roles de usuario: Otorga a tus usuarios el rol necesario para que puedan crear fuentes de datos que usen credenciales de cuentas de servicio.
- Habilita la cuenta de servicio para que acceda a tus datos de BigQuery: Otorga a la cuenta de servicio el rol necesario para acceder a un conjunto de datos o una tabla de BigQuery.
Solo debes seguir las instrucciones de este documento una vez, a menos que quieras crear cuentas de servicio diferentes para distintos equipos o grupos de usuarios. Para crear varias cuentas de servicio, repite estas instrucciones para cada cuenta de servicio adicional.
Paso 1: Obtén el agente de servicio de Data Studio
Para permitir que la cuenta de servicio acceda a tus datos, necesitas la dirección de correo electrónico del agente de servicio de Data Studio de tu organización. Puedes obtener la dirección de correo electrónico en una página de ayuda de Data Studio:
- Ve a la página de ayuda del agente de servicio de Data Studio.
- Copia la dirección de correo electrónico del agente de servicio que se muestra en esa página y guárdala para usarla en el paso 3.
La dirección de correo electrónico del agente de servicio usa el siguiente formato, en el que ORG_ID es el ID de organización de tu Google Cloud :
service-org-ORG_ID@gcp-sa-datastudio.iam.gserviceaccount.com
Paso 2: Crea una cuenta de servicio para Data Studio
Para crear la cuenta de servicio, puedes usar la consola de Google Cloud o la línea de comandos de Cloud Shell.
Console
- En la consola de Google Cloud , ve a la página Crear cuenta de servicio.
- Selecciona un proyecto.
- Ingresa un nombre de cuenta de servicio para mostrar en la consola de Google Cloud .
La consola de Google Cloud genera un ID de cuenta de servicio que se basa en este nombre. Si es necesario, edita el ID ahora. No podrás cambiar el ID más adelante.
- Opcional: Ingresa una descripción para la cuenta de servicio.
- Copia la dirección de correo electrónico de la cuenta de servicio y guárdala para usarla en el paso 5.
- Haz clic en Crear y continuar.
- En Permisos, otorga a la cuenta de servicio el rol de IAM de usuario de trabajos de BigQuery (
roles/bigquery.jobUser) o un rol personalizado que incluya el permisobigquery.jobs.createen el proyecto de facturación en el que Data Studio ejecuta trabajos de consulta.Si tu proyecto de facturación es diferente del proyecto en el que creas la cuenta de servicio, omite este paso y, en su lugar, otorga el rol de usuario de trabajos de BigQuery a la cuenta de servicio en la página de IAM del proyecto de facturación.
- Haz clic en Continuar.
- En el campo Rol de los usuarios de la cuenta de servicio, agrega los usuarios que pueden usar esta cuenta de servicio para proporcionar credenciales para sus fuentes de datos. Si no tienes todo listo para agregar usuarios ahora, puedes hacerlo más adelante. Para obtener más información, consulta Otorga roles de usuario.
- Haz clic en Listo para guardar la cuenta de servicio y volver a la página de la lista de cuentas de servicio de tu proyecto.
gcloud
Sigue los pasos generales que se indican en Cloud Shell en Crea y administra cuentas de servicio.
- Abre Cloud Shell.
- Si es necesario, selecciona un proyecto.
- Para crear la cuenta de servicio, ejecuta el comando gcloud iam service-accounts create. Puedes usar el nombre, la descripción y el nombre visible de la cuenta que elijas.
Ejemplo:
gcloud iam service-accounts create data-studio-service-account \ --description="Use for Data Studio access to BigQuery" \ --display-name="DS_BQ"
Copia la dirección de correo electrónico de la cuenta de servicio y guárdala para usarla en el paso 5.
-
Para permitir que la cuenta de servicio ejecute trabajos de consulta de BigQuery, asígnale el permiso
bigquery.jobs.createen tu proyecto de facturación otorgándole el rol de IAM de usuario de trabajos de BigQuery (roles/bigquery.jobUser).Para otorgar este rol, ejecuta el comando gcloud projects add-iam-policy-binding. En el siguiente ejemplo, reemplaza BILLING_PROJECT_ID por el ID del proyecto de facturación en el que Data Studio ejecuta trabajos de consulta y reemplaza PROJECT_ID por el ID del proyecto en el que creaste la cuenta de servicio.
Ejemplo: Otorga el rol de usuario de trabajo de BigQuery
gcloud projects add-iam-policy-binding BILLING_PROJECT_ID \ --member="serviceAccount:data-studio-service-account@PROJECT_ID.iam.gserviceaccount.com" \ --role="roles/bigquery.jobUser"
Para obtener más información, consulta Crea y administra cuentas de servicio.
Paso 3: Permite que el agente de servicio de Data Studio acceda a tu cuenta de servicio
Para permitir que el agente de servicio de Data Studio acceda a los datos con la
cuenta de servicio, otórgale el rol de creador de tokens de cuenta de servicio
(roles/iam.serviceAccountTokenCreator) al agente de servicio.
Console
- Regresa a la lista de cuentas de servicio de la consola deGoogle Cloud .
- En la lista, selecciona la cuenta de servicio de Data Studio que creaste.
- Haz clic en Principales con acceso.
- Haz clic en person_add Otorgar acceso.
- En la sección Agregar principales, pega la dirección de correo electrónico del agente de servicio de Data Studio que copiaste en el paso 1 en el campo Principales nuevas.
- Selecciona un rol que otorgue al agente de servicio el
permiso
iam.serviceAccounts.getAccessToken. Por ejemplo, puedes usar el rol de creador de tokens de cuenta de servicio o cualquier rol personalizado que otorgue este permiso. - Haz clic en Guardar.
gcloud
Ejecuta el comando gcloud iam service-accounts add-iam-policy-binding. En el siguiente ejemplo, reemplaza ORG_ID por el ID de tu organización.
Ejemplo:
gcloud iam service-accounts add-iam-policy-binding data-studio-service-account@PROJECT_ID.iam.gserviceaccount.com \ --member="serviceAccount:service-org-ORG_ID@gcp-sa-datastudio.iam.gserviceaccount.com" \ --role="roles/iam.serviceAccountTokenCreator"
Paso 4: Otorga roles de usuario
A los usuarios de Data Studio que crean o editan fuentes de datos se les debe otorgar un rol que incluya el permiso iam.serviceAccounts.actAs, como el rol de usuario de cuenta de servicio (roles/iam.serviceAccountUser). Puedes otorgar este rol en el proyecto o en una cuenta de servicio individual. Para limitar el acceso, otorga el rol solo en la cuenta de servicio. Para obtener instrucciones, consulta Administra la identidad temporal como cuenta de servicio.
No otorgues el rol de creador de tokens de cuenta de servicio a los usuarios de Data Studio. Solo el agente de servicio necesita este rol.
Console
- Ve a la lista de cuentas de servicio de la consola deGoogle Cloud .
- En la lista, selecciona tu cuenta de servicio de Data Studio.
- Haz clic en Principales con acceso.
- Haz clic en person_add Otorgar acceso.
- En la sección Agregar principales, ingresa las direcciones de correo electrónico de tus usuarios en el campo Principales nuevas.
- Selecciona el rol Usuario de cuenta de servicio.
- Opcional: Para permitir que los usuarios exploren proyectos y conjuntos de datos en los menús (en lugar de ingresarlos de forma manual), selecciona también el rol Visualizador de metadatos de BigQuery.
- Haz clic en Guardar.
gcloud
Para otorgar el rol de usuario de cuenta de servicio, ejecuta el comando gcloud iam service-accounts add-iam-policy-binding. En los siguientes ejemplos, reemplaza PROJECT_ID por el ID del proyecto y USER_EMAIL por la dirección de correo electrónico del usuario. Para agregar varios usuarios, repite el comando para cada usuario.
Ejemplo:
gcloud iam service-accounts add-iam-policy-binding data-studio-service-account@PROJECT_ID.iam.gserviceaccount.com \ --member="user:USER_EMAIL" \ --role="roles/iam.serviceAccountUser"
Opcional: Para permitir que los usuarios exploren proyectos y conjuntos de datos en los menús (en lugar de ingresarlos de forma manual), también otorga el rol de Visualizador de metadatos de BigQuery.
Ejemplo:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member="user:USER_EMAIL" \ --role="roles/bigquery.metadataViewer"
Paso 5: Habilita la cuenta de servicio para acceder a tus datos de BigQuery
Para permitir que Data Studio lea tus datos, otorga el rol de visualizador de datos de BigQuery (roles/bigquery.dataViewer) a la cuenta de servicio en las tablas o los conjuntos de datos específicos que necesita leer. No otorgues el rol de visualizador de datos de BigQuery a nivel del proyecto, ya que eso otorga acceso a todas las tablas y conjuntos de datos del proyecto.
Console
Para otorgar acceso a una tabla, sigue estos pasos:
- Copia la dirección de correo electrónico de la cuenta de servicio de Data Studio (consulta el paso 2: Crea una cuenta de servicio para Data Studio).
- Ve a BigQuery y, luego, selecciona un proyecto.
- Haz clic en Conjuntos de datos Conjuntos de datos y, luego, selecciona un conjunto de datos.
- Selecciona una tabla.
- En la barra de herramientas, haz clic en el menú Compartir person_add y, luego, en Compartir.
- En el panel Permisos de uso compartido, haz clic en person_add Agregar principal.
- En el campo Principales nuevas, pega la dirección de correo electrónico de la cuenta de servicio de Data Studio.
- Selecciona el rol de visualizador de datos de BigQuery.
- Haz clic en Guardar.
Para otorgar acceso a un conjunto de datos, sigue estos pasos:
- Copia la dirección de correo electrónico de la cuenta de servicio de Data Studio (consulta el paso 2: Crea una cuenta de servicio para Data Studio).
- Ve a BigQuery y, luego, selecciona un proyecto.
- Haz clic en Conjuntos de datos Conjuntos de datos y, luego, selecciona un conjunto de datos.
- Haz clic en more_vert Acciones chevron_forward Compartir chevron_forward Administrar permisos.
- En el panel Permisos de uso compartido, haz clic en person_add Agregar principal.
- En el campo Principales nuevas, pega la dirección de correo electrónico de la cuenta de servicio de Data Studio.
- Selecciona el rol de visualizador de datos de BigQuery.
- Haz clic en Guardar.
gcloud
Usa las instrucciones de la consola de Google Cloud para otorgar acceso a los datos. Para otorgar acceso a los datos con la herramienta de línea de comandos de bq, consulta Otorga acceso a un conjunto de datos en la documentación de BigQuery.
Proporciona la cuenta de servicio de Data Studio a tus usuarios de Data Studio
Los usuarios de Data Studio deben saber qué cuenta de servicio usar cuando crean fuentes de datos. Como no puedes ver la lista de cuentas de servicio disponibles en Data Studio, comparte la dirección de correo electrónico de la cuenta de servicio a través de la documentación de tu organización, el sitio web interno o el correo electrónico.
Ten en cuenta los siguientes puntos cuando compartas los detalles de la cuenta de servicio:
- No necesitas administrar las claves de las cuentas de servicio de forma manual, y los usuarios no necesitan descargar las claves de las cuentas de servicio desde la consola de Google Cloud ni subirlas a Data Studio.
- El límite de 10 claves de cuenta de servicio por cuenta de servicio no se aplica a Data Studio.
- Conocer solo el nombre del agente de servicio no permite que un usuario acceda a los datos. El agente de servicio se debe agregar a una cuenta de servicio, y los usuarios finales deben tener permiso para actuar como esa cuenta de servicio.
Crea una fuente de datos que use credenciales de cuenta de servicio
Para crear fuentes de datos que usen credenciales de cuentas de servicio, los usuarios de Data Studio pueden seguir los mismos pasos que para otros tipos de credenciales de datos:
- Crea o edita una fuente de datos de BigQuery.
- En la barra de herramientas, haz clic en Credenciales de datos.
- Selecciona Credenciales de cuenta de servicio.
- Ingresa la dirección de correo electrónico de tu cuenta de servicio en el cuadro.
- Haz clic en Actualizar.
Edita una fuente de datos que use credenciales de cuenta de servicio
Cuando alguien edita una fuente de datos que usa credenciales de cuenta de servicio, Data Studio verifica si tiene permiso para usar la cuenta de servicio. Si no lo hace, la fuente de datos cambiará para usar las credenciales de esa persona.
Consulta quién usa la cuenta de servicio para acceder a los datos
Puedes verificar los registros de auditoría de las cuentas de servicio en la consola de Google Cloud . Para recibir registros de auditoría de las cuentas de servicio, debes habilitar los registros de auditoría de IAM para la actividad de acceso a los datos.
Situación de ejemplo de una cuenta de servicio
Supongamos que quieres asegurarte de que los usuarios de Data Studio de tu empresa solo tengan acceso a los datos de la subsidiaria de su país. Para ello, crea una cuenta de servicio para cada país y otorga solo a los usuarios de Data Studio de cada país el permiso para actuar como la cuenta de servicio de ese país.
Configuración de ejemplo
En este ejemplo, crearás tres cuentas de servicio: una para el Reino Unido, una para Francia y otra para Alemania. Luego, asignarás como principales a tu agente de servicio y a los usuarios que quieras que puedan crear fuentes de datos que usen la cuenta de servicio. También asignarás los roles adecuados a cada uno.
Cuenta de servicio de Reino Unido
service-account-1@example-org-uk-example-project.iam.gserviceaccount.com
Principales del Reino Unido
| Principales | Funciones |
service-org-ORG_ID@gcp-sa-datastudio.iam.gserviceaccount.com Este es el agente de servicio. |
Service Account Token Creator |
| Usuario 1 | Service Account User |
| Usuario 2 | Service Account User |
Cuenta de servicio de Francia
service-account-1@example-org-fr-example-project.iam.gserviceaccount.com
Principales de Francia
| Principales | Funciones |
Este es el agente de servicio. |
Service Account Token Creator |
| Usuario 3 | Service Account User |
| Usuario 4 | Service Account User |
Cuenta de servicio de Alemania
service-account-1@example-org-de-example-project.iam.gserviceaccount.com
Principios de Alemania
| Principales | Funciones |
service-org-ORG_ID@gcp-sa-datastudio.iam.gserviceaccount.com Este es el agente de servicio. |
Service Account Token Creator |
| Usuario 5 | Service Account User |
| Usuario 6 | Service Account User |
Conocer la dirección de correo electrónico de una cuenta de servicio no otorga acceso a los datos ni a la cuenta en sí. Incluso si el usuario 5 sabe que service-account-1@example-org-fr-example-project.iam.gserviceaccount.com existe, no puede usarla sin que se le otorgue el rol de usuario de cuenta de servicio (roles/iam.serviceAccountUser). Tanto el usuario como el agente de servicio deben tener los roles adecuados configurados para que la cuenta de servicio acceda a los recursos.
Soluciona problemas relacionados con los errores de las cuentas de servicio
En esta sección, se explican los errores que pueden ver los creadores de fuentes de datos y los visualizadores de informes de Data Studio cuando intentan usar una cuenta de servicio. En la mayoría de los casos, estos errores tienen la misma causa raíz: una configuración incorrecta o incompleta de la cuenta de servicio.
Falta el rol del agente de servicio
Mensajes
|
CausaNo se otorgó al agente de servicio el rol de creador de tokens de cuenta de servicio (ni otro rol que incluya el permiso |
SoluciónOtorga el rol de creador de tokens de cuenta de servicio al agente de servicio. |
No tienes acceso a los datos
MensajeEsta cuenta de servicio no puede acceder al conjunto de datos subyacente. |
Causas
|
Solución
|
Falta el rol del usuario
MensajeNo tienes permiso para usar esta cuenta de servicio. |
CausaNo se agregó al usuario como principal a la cuenta de servicio con el rol de usuario de cuenta de servicio. |
SoluciónOtorga el rol de usuario de cuenta de servicio al usuario en la cuenta de servicio. |
El agente de servicio no está disponible para la cuenta
Mensajes
|
CausaEl usuario intenta usar una Cuenta de Google estándar (usuario consumidor) para acceder a los datos que controla una cuenta de servicio. |
SoluciónUsa una cuenta de Google Workspace o Cloud Identity para acceder a los datos. |
No se puede usar el agente de servicio en el diálogo de credenciales
MensajeLos agentes de servicio de Data Studio no se pueden usar para establecer una conexión con los datos directamente. En su lugar, usa una cuenta de servicio. |
SoluciónLos agentes de servicio y las cuentas de servicio son diferentes. Ingresa una cuenta de servicio en el cuadro de diálogo de credenciales. Puedes encontrar la lista de cuentas de servicio disponibles con la consola de Google Cloud o Cloud Shell: Console
gcloud
Ejemplo: |
Notas y límites de las credenciales de cuentas de servicio
- Las credenciales de cuenta de servicio solo están disponibles para las fuentes de datos de BigQuery. Los límites de IAM se aplican a las cuentas de servicio.
- Es posible que los cambios en los permisos de la cuenta de servicio tarden unos minutos en reflejarse en Data Studio.
- Debido a que Data Studio se ejecuta en una infraestructura administrada por Google con direcciones IP dinámicas y asignaciones de proyectos, no puedes configurar perímetros de Controles del servicio de VPC con listas de entidades permitidas de IP estáticas ni reglas de proyectos. Para permitir el acceso de Data Studio a través de un perímetro de Controles del servicio de VPC, debes agregar una cuenta de servicio como principal en tus niveles de acceso o reglas de entrada y salida.
Recursos relacionados
- Comprende las cuentas de servicio
- Reglas de entrada y salida
- Conéctate a BigQuery: Compatibilidad con los Controles del servicio de VPC
- Inicia Cloud Shell