Soluciona problemas de control de acceso

Usa este documento para solucionar problemas de seguridad y permisos de BigQuery, incluidos los permisos de Identity and Access Management (IAM), el control de acceso a nivel de columna, las claves de encriptación administradas por el cliente (CMEK) y los incumplimientos de políticas. Por lo general, las fallas en el control de acceso producen errores Access Denied o 403 Forbidden cuando las principales ejecutan trabajos o acceden a recursos.

Errores comunes de acceso denegado

Los siguientes son ejemplos de errores comunes de acceso denegado:

  • Access Denied: Project PROJECT_ID: User does not have bigquery.jobs.create permission in project PROJECT_ID.
  • Access Denied: Project PROJECT_ID: User does not have bigquery.datasets.get permission on dataset DATASET.
  • User does not have permission to query table PROJECT_ID:DATASET.TABLE.
  • Access Denied: Table PROJECT_ID:DATASET.TABLE: User does not have permission to query table PROJECT_ID:DATASET.TABLE, or perhaps it does not exist.
  • Access Denied: User PRINCIPAL does not have permission to perform bigquery.tables.getData on resource 'projects/PROJECT_ID/datasets/DATASET/tables/TABLE'.

Antes de comenzar

  • Para solucionar problemas de acceso de una principal a un recurso de BigQuery, asegúrate de tener los permisos de IAM necesarios.

Recopila información sobre el problema

El primer paso para solucionar problemas de acceso a un recurso es determinar el permiso que falta, la entidad de IAM a la que se le denegó el acceso y el recurso al que la entidad intentaba acceder.

Obtén información del historial de errores o trabajos

Para obtener información sobre el principal, el recurso y los permisos, examina el resultado de la herramienta de línea de comandos de bq, la respuesta de la API o BigQuery en la consola de Google Cloud .

Por ejemplo, si intentas ejecutar una consulta con permisos insuficientes, verás un error como el siguiente en la pestaña Información del trabajo en la sección Resultados de la consulta de la consola de Google Cloud .

Un error de acceso denegado en la pestaña Información del trabajo de la sección Resultados de la consulta

Examina el error para determinar el principal, el recurso y los permisos.

En algunos casos, es posible que puedas solicitar los permisos faltantes directamente desde el mensaje de error. Para obtener más información, consulta Mensajes de error de permisos en la documentación de IAM.

Obtén información de los Registros de auditoría de Cloud

Si el mensaje de error es genérico, falta información o si la acción falló en un proceso en segundo plano, usa el Explorador de registros de los Registros de auditoría de Cloud para obtener información sobre el error.

  1. En la consola de Google Cloud , accede a la página Explorador de registros.

    Ve al Explorador de registros

    Como alternativa, en el menú de navegación, elige Monitoring > Explorador de registros.

  2. En el Explorador de registros, en el ámbito de registros, elige Registros del proyecto.

  3. En la ventana de consulta, ingresa la siguiente consulta para obtener errores relacionados con los permisos de los registros de acceso a los datos de BigQuery:

    resource.type=("bigquery_resource" OR "bigquery_project" OR "bigquery_dataset") AND
    logName=("projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access" OR
      "projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity") AND
    (protoPayload.status.message:"Access Denied" OR
      protoPayload.status.message:"Permission denied" OR
      protoPayload.status.code=7)

    Reemplaza PROJECT_ID con el ID del proyecto.

  4. En los resultados de la consulta, expande la entrada de registro que corresponda a la operación con errores.

  5. En la sección protoPayload, expande el array authorizationInfo y, luego, cada nodo del array authorizationInfo.

    El array authorizationInfo muestra cada verificación de permisos que se realizó durante la llamada a la API.

  6. Para ver la causa del error, busca la entrada granted: false. La entrada granted: false muestra la siguiente información:

    • permission: Es la cadena de permiso de IAM que se verificó. Por ejemplo, bigquery.tables.getData
    • resource: Es el nombre completamente calificado del recurso al que el principal intentó acceder. Por ejemplo, projects/myproject/datasets/mydataset/tables/mytable.
    • principalEmail (si está disponible): Se hace referencia en protoPayload.authenticationInfo, esta es la principal que intentó la acción.

    La sección authorizationInfo del protoPayload que muestra el permiso, el recurso y el principalEmail.

Usa el Analizador de políticas para las políticas de permisos

El Analizador de políticas para las políticas de permisos te permite descubrir qué principales de IAM tienen qué tipo de acceso a cuáles recursos de BigQuery en función de tus políticas de permisos de IAM.

Después de recopilar información sobre el error de permisos, puedes usar el Analizador de políticas para comprender por qué la principal no tiene el acceso necesario. Esta herramienta analiza todas las políticas relevantes, las membresías en Grupos de Google y la herencia de recursos superiores, como un proyecto, una carpeta y tu organización.

Para usar el Analizador de políticas para las políticas de permisos, crea una consulta de análisis, especifica un permiso para el análisis y, luego, ejecuta la consulta.

  1. En la consola de Google Cloud , ve a la página Analizador de políticas.

    Ir al Analizador de políticas

    Como alternativa, en el menú de navegación, elige IAM y administración >Analizador de políticas.

  2. Haz clic en Crear consulta personalizada.

  3. En la página Configura tu consulta, ingresa la información que recopilaste anteriormente:

    1. En la sección Selecciona el alcance, en el campo Selecciona el alcance de la consulta, verifica que aparezca tu proyecto actual o haz clic en Explorar para elegir otro recurso.

    2. En la sección Configura los parámetros de consulta, en Parámetro 1, elige Principal y, en el campo Principal, ingresa el correo electrónico del usuario, grupo o cuenta de servicio.

    3. Haz clic en Agregar parámetro.

    4. En Parámetro 2, elige Permiso y, en el campo Permiso, haz clic en Seleccionar, elige el permiso de BigQuery y, luego, haz clic en Agregar. Por ejemplo, selecciona bigquery.tables.getData.

    5. Haz clic en Agregar parámetro.

    6. En Parámetro 3, elige Recurso y, en el campo Recurso, ingresa el nombre del recurso completamente calificado. El nombre del recurso debe incluir el prefijo del servicio, como en los siguientes ejemplos:

      • Proyecto de BigQuery: //cloudresourcemanager.googleapis.com/projects/PROJECT_ID
      • Conjunto de datos de BigQuery: //bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET
      • Tabla de BigQuery: //bigquery.googleapis.com/projects/PROJECT/datasets/DATASET/tables/TABLE
  4. En el panel Consulta personalizada, haz clic en Analizar > Ejecutar consulta.

  5. Examina los resultados de la consulta. El resultado puede ser uno de los siguientes:

    • Una lista vacía. Si no hay resultados, se confirma que la principal no tiene el permiso requerido. Deberás otorgarle a la principal un rol que proporcione los permisos correctos.
    • Uno o más resultados. Si el analizador encuentra una política de permisos, existe alguna forma de acceso. Haz clic en Ver vinculación en cada resultado para ver los roles que proporcionan acceso al recurso del que es miembro la principal. La vinculación de la política muestra si el acceso se otorga a través de la pertenencia a un grupo o la herencia, o si una condición de IAM o una política de denegación de IAM rechazan el acceso.

Encuentra el rol de IAM correcto que otorga los permisos necesarios

Después de confirmar que la principal no tiene acceso suficiente, el siguiente paso es encontrar el rol de IAM predefinido o personalizado adecuado que otorgue los permisos necesarios. El rol que elijas debe cumplir con el principio de privilegio mínimo.

Si tu organización usa roles personalizados, puedes encontrar el rol correcto enumerando todos los roles personalizados creados en tu proyecto u organización. Por ejemplo, en la consola de Google Cloud , en la página Roles, puedes filtrar la lista por Tipo:Personalizado para ver solo los roles personalizados.

Para encontrar el rol de IAM predefinido correcto, sigue estos pasos.

  1. Abre la sección de permisos de BigQuery de la página Roles y permisos de IAM de BigQuery.

  2. En la barra de búsqueda Ingresa un permiso, ingresa el permiso que recuperaste del mensaje de error, el historial de trabajos o los registros de auditoría. Por ejemplo, bigquery.tables.getData.

    En los resultados de la búsqueda, se muestran todos los roles predefinidos de BigQuery que otorgan el permiso.

  3. Aplica el principio de privilegio mínimo: en la lista de roles, elige el rol menos permisivo que otorgue los permisos necesarios. Por ejemplo, si buscaste bigquery.tables.getData para otorgar la capacidad de consultar datos de tablas, Visualizador de datos de BigQuery es el rol menos permisivo que otorga ese permiso.

  4. Otorga a la principal el rol adecuado. Para obtener información sobre cómo otorgar un rol de IAM a un recurso de BigQuery, consulta Controla el acceso a los recursos con la IAM.

Soluciona problemas comunes de acceso denegado

Cuando una operación falla con 403 accessDenied (Access Denied: RESOURCE_TYPE RESOURCE_ID: DETAILS), verifica las siguientes situaciones comunes, además de los pasos generales de IAM anteriores:

  • Recurso inexistente o discrepancia de ubicación (or perhaps it does not exist). Cuando un mensaje de error termina con or perhaps it does not exist, BigQuery enmascara si la tabla, la vista o la rutina existen porque la principal carece de permisos de metadatos del conjunto de datos o del proyecto (bigquery.tables.get o bigquery.datasets.get). Verifica que el ID del proyecto, el ID del conjunto de datos y el nombre de la tabla estén escritos correctamente, y confirma que tu consulta se ejecute en la misma ubicación que el conjunto de datos.
  • Vistas y rutinas autorizadas Cuando un usuario consulta una vista autorizada o una rutina autorizada, necesita permiso para consultar la vista o la rutina, y la vista o la rutina en sí deben estar autorizadas en la lista de control de acceso (LCA) del conjunto de datos de origen. Si la consulta falla con Access Denied en la tabla base subyacente, agrega la vista o rutina (o todo su conjunto de datos como un conjunto de datos autorizado) a la lista de acceso autorizado del conjunto de datos de origen. Si una vista consulta otra vista, cada vista de la cadena debe estar autorizada en el conjunto de datos del que lee.

    Si se borró una vista o un conjunto de datos autorizados y se creó otra vista o conjunto de datos con el mismo nombre, las consultas pueden fallar con Access Denied. Este error puede ocurrir incluso si el nombre aún aparece en la lista de acceso autorizado del conjunto de datos de origen, en la que las entradas borradas pueden permanecer hasta 24 horas. Verifica los Registros de auditoría de Cloud para ver si se borró y reemplazó una vista autorizada o un conjunto de datos autorizado en la cadena desde que la consulta se realizó correctamente por última vez. Para restablecer el acceso, primero quita la entrada existente de la lista de acceso autorizado del conjunto de datos de origen y, luego, vuelve a agregar la vista o el conjunto de datos nuevos. Si agregas la vista nueva antes de quitar la entrada anterior, puede producirse un error Duplicate authorized views.

    Para modificar una vista sin interrumpir la autorización, actualiza la consulta en SQL de la vista en lugar de borrarla y volver a crearla. Sin embargo, si modificas una rutina autorizada con una sentencia CREATE OR REPLACE o el método routines.update, debes volver a autorizar la rutina.

  • Controles del servicio de VPC Si tu organización usa Controles del servicio de VPC, las solicitudes que cruzan un límite del perímetro de servicio fallan con 403 accessDenied o policyViolation. Busca en los Registros de auditoría de Cloud en el momento de la falla el valor vpcServiceControlsUniqueIdentifier del mensaje de error y usa el Analizador de incumplimientos para inspeccionar las reglas de entrada y salida. Para ver la consulta del Explorador de registros que se usará, consulta La política de la organización prohíbe la solicitud.

  • Roles básicos (roles/owner, roles/editor, roles/viewer). Los roles básicos del proyecto no incluyen los permisos a nivel de la organización necesarios para las vistas, como INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION, ni los permisos especializados, como bigquery.rowAccessPolicies.overrideTimeTravelRestrictions, que se requieren para acceder a los datos históricos de una tabla que tiene o tenía políticas de acceso a nivel de fila (consulta Viaje en el tiempo y acceso a nivel de fila). Otorga roles de IAM de BigQuery predefinidos en lugar de depender de roles básicos.

  • Reemplazos de políticas de IAM transitorios (SetIamPolicy). Si los permisos funcionan de forma intermitente y, luego, fallan, busca protoPayload.methodName=~"SetIamPolicy" en los registros de auditoría de actividad del administrador para verificar si una secuencia de comandos automatizada o una canalización de infraestructura como código está reemplazando las vinculaciones de políticas existentes en lugar de combinarlas.

  • Fuentes de datos externas (Google Drive, Cloud Storage y BigLake):

    • Google Drive (Permission denied while getting Drive credentials). Otorga al usuario o a la cuenta de servicio acceso de lectura al archivo de Google Drive o a la hoja de cálculo de Google, asegúrate de que el emisor proporcione el permiso de OAuth https://www.googleapis.com/auth/drive o actualiza las credenciales de consulta programada.
    • Tablas de Cloud Storage y BigLake Otorga roles/storage.objectViewer en el bucket de Cloud Storage al usuario (para tablas externas estándar) o a la cuenta de servicio de conexión de BigLake (para tablas de BigLake).
  • Claves de encriptación administradas por el cliente (CMEK). Si la consulta hace referencia a una tabla protegida por CMEK, asegúrate de que la clave de Cloud KMS correspondiente exista y esté habilitada. Si un trabajo de consulta o carga falla con Cloud KMS Error: Permission 'cloudkms.cryptoKeyVersions.useToEncrypt' denied (o useToDecrypt), otorga al agente de servicio de encriptación de BigQuery (bq-PROJECT_NUMBER@bigquery-encryption.) el rol roles/cloudkms.cryptoKeyEncrypterDecrypter en la clave de Cloud Key Management Service. Consulta Otorga permisos de encriptación y desencriptación. Para ver otros errores de CMEK, consulta Soluciona problemas de claves de encriptación administradas por el cliente.

  • Identidad temporal como cuenta de servicio Si una solicitud que usa la identidad temporal como cuenta de servicio falla con Permission 'iam.serviceAccounts.getAccessToken' denied, otorga al principal que realiza la llamada roles/iam.serviceAccountTokenCreator en la cuenta de servicio de destino.

  • Seguridad a nivel de la columna (etiquetas de política) y seguridad a nivel de la fila Si una consulta o declaración DML falla con Requires fineGrainedGet permission on the read columns o User does not have permission to access data protected by policy tag, otorga a la principal el rol de lector detallado (roles/datacatalog.categoryFineGrainedReader) de Data Catalog en la etiqueta de política o excluye las columnas protegidas de tu lista SELECT. Consulta Permisos insuficientes de control de acceso a nivel de columna. Si la tabla usa la seguridad a nivel de fila, revisa sus políticas de acceso a nivel de fila activas en la consola de Google Cloud o ejecutando bq ls --row_access_policies. Consulta Enumera las políticas de acceso a nivel de las filas de la tabla.

  • Retrasos en la propagación de IAM y metadatos. Las actualizaciones de las ACL del conjunto de datos y los roles de IAM otorgados recientemente son coherentes de forma eventual y, por lo general, tardan unos minutos en propagarse por las cachés. Si se acaba de otorgar un permiso, espera unos minutos y vuelve a intentar la solicitud.

No se aceptaron las Condiciones del Servicio de BigQuery

Cadena del error: BigQuery Terms of Service have not been accepted

Este error de HTTP 403 Forbidden (reason: termsOfServiceNotAccepted) se produce cuando no se aceptaron las Condiciones del Servicio de BigQuery. El error no se debe a la falta de permisos de IAM. Se puede mostrar para solicitudes como la creación de un conjunto de datos o la carga de datos.

Para solucionar este problema, haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página BigQuery.

    Ir a BigQuery

  2. Si aparece la página de bienvenida, selecciona tu país, selecciona la casilla de verificación Condiciones del Servicio y, luego, haz clic en Aceptar y continuar. Para obtener más información, consulta Habilita la zona de pruebas de BigQuery.

Después de aceptar las Condiciones del Servicio, vuelve a intentar la solicitud.

Soluciona problemas relacionados con los errores de incumplimiento de política

Cuando recibes un error de HTTP 403 PERMISSION_DENIED en BigQuery con el motivo de error policyViolation, indica una falla impulsada por políticas de la organización, perímetros de datos o Controles del servicio de VPC.

En las siguientes secciones, se describen los mensajes de error más comunes asociados con este motivo de error, qué los causa y cómo resolverlos.

La política de la organización prohíbe la solicitud

Cadena del error: VPC Service Controls: Request is prohibited by organization's policy. vpcServiceControlsUniqueIdentifier: VPC_SERVICE_CONTROLS_UNIQUE_IDENTIFIER

Diagnóstico

Tu solicitud se originó en una dirección de red o un cliente que está fuera del perímetro designado de los Controles del servicio de VPC, o bien la solicitud infringió las reglas de entrada y salida definidas para tu espacio de trabajo. Esto suele ocurrir cuando tu consulta abarca varios proyectos. Por ejemplo, el proyecto de facturación de la consulta está fuera del perímetro seguro del proyecto de datos.

Solución

  1. Busca el ID único. Recupera el vpcServiceControlsUniqueIdentifier incluido en el mensaje de error. Usa este ID para filtrar el Explorador de registros de Google Cloud y encontrar el registro de los Controles del servicio de VPC correspondiente con los detalles del motivo:

    protoPayload.metadata.@type="type.googleapis.com/google.cloud.audit.VpcServiceControlAuditMetadata"
    protoPayload.metadata.vpcServiceControlsUniqueId="VPC_SERVICE_CONTROLS_UNIQUE_IDENTIFIER"
    

    Busca el valor violationReason en protoPayload.metadata.violationReason. Una vez identificados, estudia los detalles adicionales en la entrada de registro y sigue la guía de solución de problemas de los Controles del servicio de VPC existente. Además, considera usar el analizador de incumplimientos.

  2. Para ello, sigue estos pasos: Para las consultas entre proyectos, asegúrate de que el proyecto de facturación que ejecuta la consulta resida en el mismo perímetro que los datos consultados dentro del perímetro. Si es necesario, especifica un proyecto de facturación que cumpla con los requisitos de forma manual con el selector de proyectos de la consola de Google Cloud , la marca --project_id en la herramienta de línea de comandos de bq o tu solicitud de API o biblioteca cliente.

  3. Verifica los niveles de acceso. Asegúrate de que tu red de cliente, IP o cuenta de usuario estén permitidas con Access Context Manager. La consola deGoogle Cloud requiere reglas de entrada configuradas específicamente para permitir el acceso de los usuarios a los entornos protegidos.

La exportación a Google Drive está bloqueada para los proyectos que tienen habilitados los Controles del servicio de VPC

Cadena del error: Export to Google Drive is blocked for projects with VPC-SC enabled

Diagnóstico

Google Drive no admite los Controles del servicio de VPC. Debido a que Google Drive no puede aplicar de manera forzosa el perímetro de seguridad, BigQuery inhabilita automáticamente la exportación de extractos de la API a Google Drive para cualquier solicitud que se origine dentro de un límite de los Controles del servicio de VPC para evitar el robo de datos.

Solución

En lugar de exportar directamente a Google Drive, extrae los resultados de tu consulta a un bucket de Cloud Storage ubicado dentro del mismo perímetro de los Controles del servicio de VPC o guarda los resultados como un archivo local.

Las tablas externas de Google Drive están bloqueadas para los proyectos que tienen habilitados los Controles del servicio de VPC

Cadena del error: Google Drive external tables are blocked for projects with VPC-SC enabled

Diagnóstico

De forma predeterminada, los Controles del servicio de VPC no bloquean las consultas de tablas externas de Google Drive (como las hojas conectadas). Sin embargo, este error aparece porque tu organización de Google Cloud solicitó de forma explícita que Google Cloud aplique una configuración de bloqueo estricta para tu proyecto que anule el comportamiento permisivo predeterminado, lo que evita cualquier consulta entrante a los datos de Google Drive desde un perímetro de Controles del servicio de VPC.

Solución

Importa los datos de la hoja de cálculo de Google o del archivo de Google Drive directamente a una tabla estándar de BigQuery dentro del perímetro de los Controles del servicio de VPC, en lugar de consultarlos de forma dinámica como una tabla federada externa. Como alternativa, comunícate con tu administrador de Cloud interno para analizar los límites de exportación de datos de tu organización.

La exportación a Google Drive está bloqueada para tu proyecto

Cadena del error: Export to Google Drive is blocked for your project.

Diagnóstico

Incluso sin un perímetro de Controles del servicio de VPC, tus administradores de Google Cloud solicitaron que se aplique una configuración organizacional específica y estricta a tu proyecto, que rechace todas las capacidades de extracción de datos a Google Drive.

Solución

Elige un destino de extracción alternativo, como un bucket de Cloud Storage o un archivo local, o comunícate con tu administrador de Cloud interno para analizar los límites de exportación de datos de tu organización.

La ubicación incumple la restricción de la política de la organización

Cadena del error: LOCATION violates constraint CONSTRAINT_NAME on the resource projects/PROJECT_ID o LOCATION violates constraint CONSTRAINT_NAME on the resource projects/PROJECT_ID/datasets/DATASET_ID

Diagnóstico

Tu administrador de Cloud configuró una restricción de la política de la organización para restringir exactamente dónde se pueden crear o analizar los recursos. Este error suele aparecer en los siguientes casos:

  • Crear un conjunto de datos en una región geográfica no autorizada (por ejemplo, restringida por constraints/gcp.resourceLocations)
  • Intentar usar BigQuery Omni en nubes externas cuando no está permitido (por ejemplo, bloqueado por constraints/bigquery.disableBQOmniAWS o constraints/bigquery.disableBQOmniAzure).

Solución

  1. Verifica el CONSTRAINT_NAME exacto que se proporciona en el mensaje de error para comprender qué acción se está bloqueando.
  2. Selecciona una región diferente y desbloqueada para tus datos o trabaja con el Google Cloud administrador de tu organización para revisar la política de la organización a nivel de la carpeta o de la organización. Consulta Estructura y define las ubicaciones de los recursos para obtener más detalles.

Soluciona problemas de errores de falta de autenticación

Cuando recibes un error HTTP 401 Unauthorized (gRPC UNAUTHENTICATED) en BigQuery con el motivo de error unauthenticated, la solicitud carece de credenciales de autenticación válidas, el token de acceso de OAuth 2.0 venció o el emisor no puede autenticarse como la identidad especificada.

En las siguientes secciones, se describen las situaciones más comunes de unauthenticated, qué las causa y cómo resolverlas.

Credenciales no válidas o vencidas

Cadenas de error:

  • Invalid credential
  • User credential was invalid.
  • Credentials expired
  • Credentials missing required scope.
  • Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential.

Diagnóstico

El token de acceso, la clave de la cuenta de servicio o las credenciales predeterminadas de la aplicación (ADC) proporcionadas con la solicitud vencieron, se revocaron o no tienen los permisos de OAuth 2.0 necesarios. Este error también se produce cuando la solicitud se firma con un reloj del sistema que se desvió de la hora del protocolo NTP.

Solución

  • Actualiza tus credenciales. Si te autenticas desde un entorno de desarrollo local, ejecuta gcloud auth application-default login (para ADC) o gcloud auth login para obtener un token nuevo.
  • Verifica las claves de cuenta de servicio y los permisos de OAuth. Si tu aplicación usa GOOGLE_APPLICATION_CREDENTIALS, verifica que la variable apunte a un archivo de claves JSON válido y no revocado, que la cuenta de servicio esté habilitada en la consola deGoogle Cloud y que la credencial incluya el permiso https://www.googleapis.com/auth/bigquery o https://www.googleapis.com/auth/cloud-platform requerido.
  • Usa las bibliotecas cliente actuales y sincroniza los relojes del sistema. Actualiza tu biblioteca cliente de BigQuery o el controlador ODBC o JDBC a la versión más reciente para que las actualizaciones de tokens de OAuth 2.0 y las credenciales federadas se controlen de forma automática. También asegúrate de que el reloj del sistema de la máquina anfitrión esté sincronizado con NTP.

Faltan las credenciales de usuario de la Cuenta de Google o el permiso de identidad temporal como cuenta de servicio

Cadenas de error:

  • Current user can not act as user for service account SERVICE_ACCOUNT_EMAIL
  • No end user credentials found when accessing PROJECT_ID:DATASET_ID.TABLE_ID. Please use end user credentials to call BigQuery APIs.

Diagnóstico

El trabajo o la consulta continua se configuran para ejecutarse como una cuenta de servicio personalizada en la que el emisor no tiene permiso para actuar, o la tabla de destino o la política de seguridad requieren credenciales de usuario de la Cuenta de Google para que BigQuery pueda evaluar el acceso con una identidad de usuario interactiva.

Solución

  • Otorga permisos de identidad temporal como cuenta de servicio. Cuando ejecutes una consulta continua o un trabajo configurado con una cuenta de servicio personalizada, otorga al emisor el rol de usuario de cuenta de servicio (roles/iam.serviceAccountUser, que incluye el permiso iam.serviceAccounts.actAs) en esa cuenta de servicio. Cuando actúes en nombre de una cuenta de servicio o intercambies credenciales federadas por un token de corta duración, otorga al emisor el rol de creador de tokens de cuenta de servicio (roles/iam.serviceAccountTokenCreator) en la cuenta de servicio de destino.
  • Autenticar con las credenciales de usuario de la Cuenta de Google Cuando el recurso objetivo requiera credenciales de usuario de la Cuenta de Google, autentica la solicitud con las credenciales de OAuth 2.0 de un usuario interactivo (por ejemplo, ejecutando gcloud auth application-default login o configurando OAuth de usuario en tu herramienta de IE) en lugar de credenciales de cuenta de servicio independientes.
  • Verifica las reglas de entrada y salida de los Controles del servicio de VPC. Si la solicitud cruza un límite de los Controles del servicio de VPC, verifica que las reglas de entrada y salida del perímetro permitan la identidad del emisor y el recurso objetivo.

Cuenta restringida, suspendida o borrada

Cadenas de error:

  • The account was restricted due to REASON
  • Account deleted

Diagnóstico

Un administrador o una política de seguridad de la cuenta suspendió, inhabilitó, restringió o borró la Cuenta de Google o la cuenta de Google Workspace que emitió la solicitud.

Solución

Comunícate con tu administrador de Google Workspace o Cloud Identity para revisar el estado de la cuenta en la Consola del administrador de Google y restablecer o reactivar la cuenta de usuario, o actualizar la carga de trabajo para autenticarte con una cuenta de servicio activa.

La facturación no está habilitada para el proyecto

Cadena del error: Billing has not been enabled for this project. Enable billing at https://console.cloud.google.com/billing. DETAILS

Este error de HTTP 403 Forbidden (reason: billingNotEnabled) se produce cuando no se habilita la facturación para el proyecto o cuando el proyecto se ejecuta en la zona de pruebas de BigQuery y se intenta realizar una operación que supera los límites de la zona de pruebas.

Para resolver este error, haz lo siguiente:

  • Habilita la facturación para el proyecto. Vincula una cuenta de Facturación de Cloud activa al proyecto en la consola de Google Cloud . Para obtener instrucciones paso a paso, consulta Habilita la facturación para un proyecto.

    Ir a Facturación

  • Actualiza desde la zona de pruebas de BigQuery (expiration time must be less than 60 days). En la zona de pruebas de BigQuery, las tablas, las vistas y las particiones vencen automáticamente después de 60 días. Habilita la facturación para actualizar desde la zona de pruebas de BigQuery y, luego, actualiza los tiempos de vencimiento predeterminados de tus conjuntos de datos, tablas, vistas y particiones.

Se bloqueó la solicitud para proteger el funcionamiento del sistema

Cadena del error: Request was blocked to protect the system's operation. Please contact support at https://cloud.google.com/support.

Este error de HTTP 403 Forbidden (reason: blocked) se produce cuando BigQuery agrega temporalmente una operación a una lista de bloqueo, por lo general, para evitar una interrupción del servicio más amplia.

Para resolver este error, comunícate con Atención al cliente de Cloud e incluye la marca de tiempo exacta, el ID del proyecto y el ID del trabajo de BigQuery para que Atención al cliente de Cloud pueda investigar la regla de mitigación administrativa.

Soluciona problemas del control de acceso a nivel de columna

En las siguientes secciones, se explica cómo solucionar problemas con el control de acceso a nivel de columna y las etiquetas de política de Data Catalog.

No puedo ver los roles de Data Catalog

Si no puedes ver roles como Lector detallado de Data Catalog, es posible que no hayas habilitado la API de Data Catalog en tu proyecto. Para obtener información sobre cómo habilitar la API de Data Catalog, consulta Antes de comenzar. Los roles de Data Catalog aparecen varios minutos después de que habilitas la API de Data Catalog.

No puedo ver la página Taxonomías

Necesitas permisos adicionales para ver la página Taxonomías de etiquetas de política en la consola deGoogle Cloud . Por ejemplo, el rol de administrador de etiquetas de política de Data Catalog tiene acceso a la página Taxonomías.

Apliqué las etiquetas de política, pero no funcionan.

Si sigues recibiendo resultados de consultas para una cuenta que no debería tener acceso, es posible que la cuenta esté recibiendo resultados almacenados en caché. En particular, si antes ejecutaste la consulta de forma correcta y, luego, aplicaste etiquetas de política, es posible que obtengas resultados de la caché de resultados de la consulta. De forma predeterminada, los resultados de las consultas se almacenan en caché durante 24 horas. La consulta falla de inmediato si inhabilitas la caché de resultados. Para obtener más detalles sobre el almacenamiento en caché, consulta Impacto del control de acceso a nivel de columna.

En general, las actualizaciones de IAM tardan unos 30 segundos en propagarse. Los cambios en la jerarquía de etiquetas de política pueden demorar hasta 30 minutos en propagarse.

No tengo permiso para leer desde una tabla con seguridad a nivel de columnas

Necesitas el rol de lector detallado o el rol de lector enmascarado en diferentes niveles, como la organización, la carpeta, el proyecto y la etiqueta de política. El rol de lector detallado otorga acceso a los datos sin procesar, mientras que el rol de lector enmascarado otorga acceso a los datos enmascarados. Puedes usar el Solucionador de problemas de políticas de IAM para verificar este permiso a nivel de proyecto.

Configuré el control de acceso detallado en la taxonomía de etiqueta de política, pero los usuarios ven datos protegidos

Para solucionar este problema, confirma los siguientes detalles:

  • En la página Taxonomías de etiquetas de política del Centro de seguridad de BigQuery, confirma que el botón de activación Aplicar control de acceso esté en la posición Activado.
  • Asegúrate de que tus consultas no usen resultados de consultas almacenados en caché. Si usas la herramienta de línea de comandos de bq para probar tus consultas, usa la marca --nouse_cache para inhabilitar la caché de consultas. Por ejemplo:

    bq query --nouse_cache --use_legacy_sql=false "SELECT * EXCEPT (customer_pii) FROM my_table;"

Consideraciones sobre la migración de proyectos

Las etiquetas de política y las taxonomías se alojan en una organización de Google Cloud específica y no se vuelven a asociar automáticamente cuando se migra un proyecto a una organización nueva. Si migras un proyecto que usa etiquetas de política para el control de acceso a nivel de columna a una organización diferente, se producen los siguientes problemas:

  • Las etiquetas de política ya no se pueden administrar en la consola de Google Cloud dentro del proyecto migrado.
  • No puedes aplicar estas etiquetas de política a las columnas nuevas del proyecto migrado.
  • Es posible que los controles de acceso a nivel de columna existentes sigan vigentes, pero el vínculo a la taxonomía de origen en la organización original se rompe con fines de administración.

Para resolver este problema, se requiere la intervención manual del equipo de asistencia de Google Cloud para volver a asociar la taxonomía con la organización nueva. Si migraste un proyecto con etiquetas de política y tienes estos problemas, comunícate con Atención al cliente de Cloud.

Soluciona problemas de las etiquetas de administración de datos

En las siguientes secciones, se describe cómo solucionar problemas habituales cuando se controla el acceso a las columnas con etiquetas de administración de datos.

Nombres de etiquetas con formato incorrecto

Cuando creas etiquetas, defines un nombre corto (por ejemplo, ssn). Sin embargo, cuando adjuntas etiquetas a columnas en tu esquema o las usas en condiciones, la clave de etiqueta debe usar el formato de espacio de nombres (PROJECT_ID/TAG_KEY o ORGANIZATION_ID/TAG_KEY), mientras que el valor de la etiqueta sigue usando el nombre corto. Si solo proporcionas el nombre corto de la clave de etiqueta, se producirá un error Invalid tagKey o Invalid tagValue.

Aplicación de políticas entre proyectos

De forma predeterminada, solo se evalúan las políticas de datos del proyecto de la tabla. Las políticas de otros proyectos no se aplican, a menos que se configure un proyecto de política de datos predeterminado a nivel de la organización. Para obtener más información sobre cómo configurar y evaluar las políticas entre proyectos, consulta Configura un proyecto de política de datos predeterminado.

Soluciona problemas de claves de encriptación administradas por el cliente

En la siguiente lista, se describen los errores comunes y las soluciones recomendadas cuando usas claves de encriptación administradas por el cliente (CMEK) con Cloud Key Management Service:

Error: Please grant Cloud KMS CryptoKey Encrypter/Decrypter role
Resolución: La cuenta de servicio de BigQuery asociada con tu proyecto no tiene suficientes permisos de IAM para operar en la clave de Cloud KMS especificada. Para otorgar el permiso de IAM necesario, sigue las instrucciones del mensaje de error o las de Otorga permisos de encriptación y desencriptación.
Error: Existing table encryption settings don't match encryption settings specified in the request
Resolución: Este error puede ocurrir cuando la tabla de destino tiene una configuración de encriptación que no coincide con la configuración de encriptación en tu solicitud. Para resolver este problema, usa la disposición de escritura TRUNCATE para reemplazar la tabla o especifica una tabla de destino diferente.
Error: This region is not supported
Resolución: La región de la clave de Cloud KMS no coincide con la región del conjunto de datos de BigQuery para la tabla de destino. Para resolver este problema, selecciona una clave en una región que coincida con tu conjunto de datos o carga datos en un conjunto de datos que coincida con la región de la clave.
Error: Your administrator requires that you specify an encryption key for queries in project PROJECT_ID.
Resolución: Una política de la organización impidió crear un recurso o ejecutar una consulta. Para obtener más información sobre esta política, consulta Requerir CMEK para todos los recursos.
Error: Your administrator prevents using KMS keys from project KMS_PROJECT_ID to protect resources in project PROJECT_ID.
Resolución: Una política de la organización impidió crear un recurso o ejecutar una consulta. Para obtener más información sobre esta política, consulta Restringe las claves de Cloud KMS de un proyecto de BigQuery.

¿Qué sigue?