Puedes configurar una Google Cloud cuenta de servicio para que Data Studio pueda acceder a tus datos de BigQuery sin depender de las credenciales de usuarios concretos. Delegar el acceso a una cuenta de servicio puede ayudarte a cumplir los requisitos de seguridad y a que las fuentes de datos sigan funcionando aunque las personas que las hayan creado dejen la organización.
Este documento está dirigido a Google Cloud administradores que quieran configurar una cuenta de servicio para Data Studio. Para usar una cuenta de servicio ya creada en una fuente de datos, consulta Credenciales de acceso a datos.
Conceptos clave
Cuando configuras una cuenta de servicio para Data Studio, es útil que conozcas los siguientes conceptos:
- Cuenta de servicio: una identidad que actúa como usuario no humano para acceder a los datos de BigQuery. Tú creas y gestionas la cuenta de servicio.
- Agente de servicio de Data Studio: un tipo especial de cuenta de servicio que Google Cloud crea y gestiona. 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 suplantar la identidad de tu cuenta de servicio. Tu cuenta de servicio tiene permisos para leer los datos de BigQuery.
Para obtener más información, consulta el artículo Resumen de las cuentas de servicio.
Ventajas de usar una cuenta de servicio con Data Studio
Usar una cuenta de servicio en lugar de las credenciales de un usuario concreto proporciona estas ventajas:
- Continuidad empresarial: las fuentes de datos que usan credenciales de la cuenta de servicio no dejarán de funcionar si su creador deja la empresa.
- Compatibilidad con Controles de Servicio de VPC: las funciones automatizadas, como los correos 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 Controles de Servicio de VPC. Para obtener más información, consulta Notas y límites.
- Compatibilidad con políticas de dispositivos: las credenciales de la cuenta de servicio permiten acceder a los datos que se encuentren dentro de aquellos perímetros de Controles de Servicio de VPC que usen 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 las políticas de la organización: si las políticas de Google Workspace de tu organización restringen las credenciales del propietario para evitar que se compartan datos de forma generalizada, las cuentas de servicio ofrecen una alternativa que controlan los administradores. Puedes delegar el acceso sin exponer las credenciales de cada persona ni conceder permisos excesivos.
- Control de acceso granular: puedes conceder acceso a la cuenta de servicio solo a conjuntos de datos o tablas de BigQuery específicos, lo que se ajusta al principio de mínimos accesos. Después, puedes controlar qué usuarios de Data Studio pueden suplantar o usar esa cuenta de servicio.
Roles obligatorios
En las siguientes secciones se muestran los roles necesarios para configurar una cuenta de servicio para Data Studio.
Para administradores
Para obtener la dirección de correo del agente de servicio de Data Studio, debes ser usuario de Google Workspace o de Cloud Identity.
Para obtener los permisos que necesitas para configurar una cuenta de servicio de Data Studio, pide a tu administrador que te asigne los siguientes roles de gestión de identidades y accesos:
-
Configura una cuenta de servicio:
- Administrador de cuentas de servicio (
roles/iam.serviceAccountAdmin) en tu proyecto - Crear cuentas de servicio (
roles/iam.serviceAccountCreator) en tu proyecto
- Administrador de cuentas de servicio (
-
Configure el acceso a un conjunto de datos o tabla de BigQuery: Propietario de datos de BigQuery (
roles/bigquery.dataOwner) en el conjunto de datos o tabla
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para configurar una cuenta de servicio de Data Studio. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:
Permisos obligatorios
Para configurar una cuenta de servicio para Data Studio, se necesitan los siguientes permisos:
-
Configura una cuenta de servicio:
iam.serviceAccounts.createen tu proyecto -
Configura el acceso a un conjunto de datos o a una tabla de BigQuery:
-
bigquery.datasets.setIamPolicyen el conjunto de datos -
bigquery.tables.setIamPolicyen la mesa
-
También puedes conseguir estos permisos con roles personalizados u otros roles predefinidos.
Para la cuenta de servicio
Para asegurarte de que la cuenta de servicio tenga los permisos necesarios para acceder a los datos de BigQuery en Data Studio, pide a tu administrador que asigne los siguientes roles de gestión de identidades y accesos a la cuenta de servicio:
- Lector de datos de BigQuery (
roles/bigquery.dataViewer) en las tablas o los conjuntos de datos específicos que la cuenta de servicio deba leer - Usuario de tareas de BigQuery (
roles/bigquery.jobUser) en el proyecto de facturación (el Google Cloud proyecto que ejecuta y paga las tareas de consulta)
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para acceder a los datos de BigQuery en Data Studio. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:
Permisos obligatorios
Para acceder a los datos de BigQuery en Data Studio, se necesitan los siguientes permisos:
-
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 conceder estos permisos a la cuenta de servicio con roles personalizados u otros roles predefinidos.
Instrucciones de configuración
Para configurar una cuenta de servicio que proporcione acceso a los datos de BigQuery, sigue estos pasos:
- Obtener el agente de servicio de Data Studio: copia la dirección de correo del agente de servicio para usarla en un paso posterior.
- Crear 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: asigna al agente de servicio el rol necesario en la cuenta de servicio.
- Asignar roles de usuario: asigna a tus usuarios el rol necesario para que puedan crear fuentes de datos que usen credenciales de la cuenta de servicio.
- Habilita la cuenta de servicio para que pueda acceder a tus datos de BigQuery: asigna a la cuenta de servicio el rol necesario para acceder a un conjunto de datos o a una tabla de BigQuery.
Solo tienes que seguir las instrucciones de este documento una vez, a menos que quieras crear distintas cuentas de servicio para diferentes equipos o grupos de usuarios. Para crear varias cuentas de servicio, repite estas instrucciones con cada una de ellas.
Paso 1: Obtener el agente de servicio de Data Studio
Para permitir que la cuenta de servicio acceda a tus datos, necesitas la dirección de correo del agente de servicio de Data Studio de tu organización. Puedes obtener la dirección de correo a través de 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 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 del agente de servicio tiene el siguiente formato, donde ORG_ID es el Google Cloud ID de tu organización:
service-org-ORG_ID@gcp-sa-datastudio.iam.gserviceaccount.com
Paso 2: Crea una cuenta de servicio para Data Studio
Para crear una cuenta de este tipo, puedes usar la Google Cloud consola o la línea de comandos de Cloud Shell.
Consola
- En la consola de Google Cloud , ve a la página Crear cuenta de servicio.
- Selecciona un proyecto.
- Escribe el nombre de la cuenta de servicio, que será el que se muestre en la consola de Google Cloud .
La consola de Google Cloud genera un ID de cuenta de servicio basado en este nombre. Cambia el ID en este momento del proceso si fuera necesario. No podrás cambiarlo más adelante.
- Opcional: Escribe la descripción de la cuenta de servicio.
- Copia la dirección de correo de la cuenta de servicio y guárdala para usarla en el paso 5.
- Haz clic en Crear y continuar.
- En Permisos, asigna a la cuenta de servicio el rol de gestión de identidades y accesos Usuario de tareas 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 tareas de consulta.Si tu proyecto de facturación es diferente del proyecto en el que estás creando la cuenta de servicio, sáltate este paso y asigna el rol Usuario de tareas de BigQuery a la cuenta de servicio en la página de gestión de identidades y accesos del proyecto de facturación.
- Haz clic en Continuar.
- En el campo Rol de usuarios de la cuenta de servicio, añade los usuarios que pueden usar esta cuenta para proporcionar las credenciales de sus fuentes de datos. Si no es el mejor momento para añadirlos, puedes hacerlo más tarde. Para obtener más información, consulta Conceder roles de usuario.
- Haz clic en Hecho para guardar la cuenta de servicio y volver a la página donde se muestra la lista de cuentas de servicio de tu proyecto.
gcloud
Sigue los pasos generales que se indican en la pestaña Cloud Shell del artículo sobre cómo crear y gestionar cuentas de servicio.
- Abre Cloud Shell.
- Selecciona un proyecto si es necesario.
- 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 que quieras para identificar la cuenta.
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 de la cuenta de servicio y guárdala para usarla en el paso 5.
-
Para permitir que la cuenta de servicio ejecute tareas de consulta de BigQuery, dale el permiso
bigquery.jobs.createen tu proyecto de facturación asignándole el rol de gestión de identidades y accesos de usuario de tareas de BigQuery (roles/bigquery.jobUser).Para asignar este rol, ejecuta el comando gcloud projects add-iam-policy-binding. En el siguiente ejemplo, sustituye BILLING_PROJECT_ID por el ID del proyecto de facturación en el que Data Studio ejecuta las tareas de consulta y PROJECT_ID por el ID del proyecto en el que has creado la cuenta de servicio.
Ejemplo: Conceder el rol Usuario de tareas 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 el artículo Crear y gestionar 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 mediante la cuenta de servicio, asigna el rol Creador de tokens de cuenta de servicio (roles/iam.serviceAccountTokenCreator) al agente de servicio.
Consola
- Vuelve a la lista de cuentas de servicio de la consola deGoogle Cloud .
- En la lista, selecciona la cuenta de servicio de Data Studio que has creado.
- Haz clic en Principales con acceso.
- Haz clic en person_add Conceder acceso.
- En la sección Añadir principales, pega la dirección de correo del agente de servicio de Data Studio que has copiado en el paso 1 en el campo Principales nuevas.
- Selecciona un rol que conceda al agente de servicio el permiso
iam.serviceAccounts.getAccessToken. Por ejemplo, puedes usar el rol Creador de tokens de cuenta de servicio o cualquier rol personalizado que conceda este permiso. - Haz clic en Guardar.
gcloud
Ejecuta el comando gcloud iam service-accounts add-iam-policy-binding. En el ejemplo siguiente, sustituye 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: Asigna roles de usuario
Los usuarios de Data Studio que creen o editen fuentes de datos deben tener un rol que incluya el permiso iam.serviceAccounts.actAs, como el rol Usuario de cuenta de servicio (roles/iam.serviceAccountUser). Puedes conceder este rol en el proyecto o en una cuenta de servicio concreta. Para limitar el acceso, concede el rol solo en la cuenta de servicio. Para ver instrucciones al respecto, consulta el artículo sobre cómo gestionar la identidad temporal de cuenta de servicio.
No asignes el rol Creador de tokens de cuenta de servicio a los usuarios de Data Studio. Solo el agente de servicio necesita este rol.
Consola
- 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 Conceder acceso.
- En la sección Añadir principales, escribe las direcciones de correo de tus usuarios en el campo Principales nuevas.
- Selecciona el rol Usuario de cuenta de servicio.
- Opcional: Para permitir que los usuarios busquen proyectos y conjuntos de datos en los menús (en lugar de introducirlos manualmente), selecciona también el rol Lector de metadatos de BigQuery.
- Haz clic en Guardar.
gcloud
Para asignar el rol Usuario de cuenta de servicio, ejecuta el comando gcloud iam service-accounts add-iam-policy-binding. En los ejemplos siguientes, sustituye PROJECT_ID por el ID de tu proyecto y USER_EMAIL por la dirección de correo del usuario. Para añadir varios usuarios, repite el comando con cada uno de ellos.
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 busquen proyectos y conjuntos de datos en los menús (en lugar de introducirlos manualmente), asigna también el rol Lector 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 que pueda acceder a tus datos de BigQuery
Para permitir que Data Studio lea tus datos, asigna el rol Lector de datos de BigQuery (roles/bigquery.dataViewer) a la cuenta de servicio en las tablas o los conjuntos de datos específicos que deba leer. No concedas el rol Lector de datos de BigQuery a nivel de proyecto, ya que eso daría acceso a todas las tablas y conjuntos de datos del proyecto.
Consola
Para dar acceso a una tabla, sigue estos pasos:
- Copia la dirección de correo de la cuenta de servicio de Data Studio (consulta el paso 2: Crear una cuenta de servicio para Data Studio).
- Ve a BigQuery y selecciona un proyecto.
- Haz clic en dataset Conjuntos de datos y, a continuación, selecciona un conjunto de datos.
- Selecciona una tabla.
- En la barra de herramientas, haz clic en el menú Compartir person_add y, a continuación, en Compartir.
- En el panel Permisos para compartir, haz clic en person_add Añadir principal.
- En el campo Nuevos principales, pega la dirección de correo de la cuenta de servicio de Data Studio.
- Selecciona el rol Lector de datos de BigQuery.
- Haz clic en Guardar.
Para dar acceso a un conjunto de datos, sigue estos pasos:
- Copia la dirección de correo de la cuenta de servicio de Data Studio (consulta el paso 2: Crear una cuenta de servicio para Data Studio).
- Ve a BigQuery y selecciona un proyecto.
- Haz clic en dataset Conjuntos de datos y, a continuación, selecciona un conjunto de datos.
- Haz clic en more_vert Acciones chevron_forward Compartir chevron_forward Gestionar permisos.
- En el panel Permisos para compartir, haz clic en person_add Añadir principal.
- En el campo Nuevos principales, pega la dirección de correo de la cuenta de servicio de Data Studio.
- Selecciona el rol Lector de datos de BigQuery.
- Haz clic en Guardar.
gcloud
Sigue las instrucciones de la consola de Google Cloud para dar acceso a los datos. Para dar acceso a los datos con la herramienta de línea de comandos bq, consulta el artículo Dar acceso a un conjunto de datos de la documentación de BigQuery.
Proporcionar la cuenta de servicio de Data Studio a tus usuarios de Data Studio
Los usuarios de Data Studio necesitan saber qué cuenta de servicio usar al crear fuentes de datos. Como no puedes ver la lista de cuentas de servicio disponibles en Data Studio, comparte la dirección de correo de la cuenta de servicio en la documentación o en el sitio web interno de tu organización, o bien por correo electrónico.
Ten en cuenta lo siguiente al compartir los detalles de la cuenta de servicio:
- No tienes que gestionar las claves de las cuentas de servicio de forma manual, ni tampoco descargarlas de la consola de Google Cloud para subirlas a Data Studio.
- El límite de 10 claves por cuenta de servicio no se aplica en Data Studio.
- Solo con saber el nombre del agente del servicio, los usuarios no pueden acceder a los datos. El agente de servicio debe añadirse a una cuenta de servicio y los usuarios finales deben tener permiso para actuar como esa cuenta de servicio.
Crear una fuente de datos que usa credenciales de cuentas 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 acceso a datos:
- Crea o edita una fuente de datos de BigQuery.
- En la barra de herramientas, haz clic en Credenciales de acceso a datos.
- Selecciona Credenciales de la cuenta de servicio.
- Escribe la dirección de correo de tu cuenta de servicio en el cuadro correspondiente.
- Haz clic en Actualizar.
Editar una fuente de datos que usa credenciales de la cuenta de servicio
Cuando un usuario edita una fuente de datos que usa credenciales de la cuenta de servicio, Data Studio comprueba si ese usuario tiene permiso para utilizar esa cuenta de servicio. Si no es así, la fuente de datos pasa a usar las credenciales de ese usuario.
Ver quién está usando la cuenta de servicio para acceder a los datos
Puedes consultar los registros de auditoría de las cuentas de servicio en la Google Cloud consola. Si quieres recibir registros de auditoría de las cuentas de servicio, debes habilitar los registros de auditoría de gestión de identidades y accesos para que recojan la actividad de acceso a los datos.
Ejemplo de uso de cuentas de servicio
Supongamos que quieres asegurarte de que los usuarios de Data Studio de tu empresa solo tengan acceso a los datos de la filial de su país. Para ello, crea una cuenta de servicio para cada país y da permiso para actuar como cuenta de servicio de ese país solo a los usuarios de Data Studio de ese país.
Configuración de ejemplo
En este ejemplo, crearás tres cuentas de servicio: una para el Reino Unido, otra para Francia y otra para Alemania. A continuación, asigna como principales a tu agente de servicio y a los usuarios a los que quieras dar permiso para crear fuentes de datos que usen la cuenta de servicio. También asignarás los roles adecuados a cada uno.
Cuenta de servicio del Reino Unido
service-account-1@example-org-uk-example-project.iam.gserviceaccount.com
Principales del Reino Unido
| Directores | Roles |
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
| Directores | Roles |
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
Principales de Alemania
| Directores | Roles |
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 de una cuenta de servicio no da acceso a los datos ni a la propia cuenta. Aunque el usuario 5 sepa que existe service-account-1@example-org-fr-example-project.iam.gserviceaccount.com, no puede usarla sin que se le asigne el rol de usuario de cuenta de servicio (roles/iam.serviceAccountUser). Tanto el usuario como el agente de servicio deben tener configurados los roles adecuados para que la cuenta de servicio pueda acceder a los recursos.
Solucionar errores de cuentas de servicio
En esta sección se explican los errores que los creadores de fuentes de datos y los lectores de informes de Data Studio pueden recibir al intentar usar una cuenta de servicio. En la mayoría de los casos, estos errores tienen la misma causa principal: la configuración de la cuenta de servicio no es correcta o no está completa.
Falta el rol del agente de servicio
Mensajes
|
CausaEl agente de servicio no tiene el rol Creador de tokens de cuenta de servicio (u otro rol que incluya el permiso |
SoluciónAsigna el rol Creador de tokens de cuenta de servicio al agente de servicio. |
No se puede acceder 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. |
CausaEl usuario no se ha añadido como un principal a la cuenta de servicio con el rol Usuario de cuenta de servicio. |
SoluciónAsigna en la cuenta de servicio el rol Usuario de cuenta de servicio a ese usuario. |
No hay agente de servicio disponible para la cuenta
Mensajes
|
CausaEl usuario está intentando usar una cuenta de Google estándar (es decir, una cuenta de consumidor) para acceder a datos controlados por una cuenta de servicio. |
SoluciónUsa una cuenta de Google Workspace o de Cloud Identity para acceder a los datos. |
No se puede usar el agente de servicio en el cuadro de diálogo de credenciales
MensajeNo se pueden usar agentes de servicio de Data Studio para conectarse directamente a los datos. Usa una cuenta de servicio para ello. |
SoluciónLos agentes de servicio y las cuentas de servicio son diferentes. Especifica una cuenta de servicio en el cuadro de diálogo de credenciales. Puedes usar la consola de Google Cloud o Cloud Shell para consultar la lista de cuentas de servicio disponibles: Consola
gcloud
Ejemplo: |
Notas y límites de las credenciales de la cuenta de servicio
- Las credenciales de la cuenta de servicio solo están disponibles para las fuentes de datos de BigQuery. Las cuentas de servicio están sujetas a los límites de gestión de identidades y accesos.
- Los cambios que se hagan en los permisos de las cuentas de servicio pueden tardar unos minutos en reflejarse en Data Studio.
- Como Data Studio se ejecuta en una infraestructura gestionada por Google con direcciones IP dinámicas y asignaciones de proyectos, no puedes configurar perímetros de Controles de Servicio de VPC mediante listas de IPs permitidas estáticas ni reglas de proyectos. Para permitir que Data Studio acceda a través de un perímetro de Controles de Servicio de VPC, debes añadir una cuenta de servicio como principal en tus niveles de acceso o en tus reglas de entrada y salida.
Recursos relacionados
- Comprender las cuentas de servicio
- Reglas de entrada y salida
- Conectarse a BigQuery: Compatibilidad con Controles de Servicio de VPC
- Iniciar Cloud Shell