Résoudre les problèmes de contrôle des accès
Ce document vous aide à résoudre les problèmes de sécurité et d'autorisation BigQuery, y compris les autorisations Identity and Access Management (IAM), le contrôle des accès au niveau des colonnes, les clés de chiffrement gérées par le client (CMEK) et les cas de non-respect des règles. Les échecs de contrôle des accès génèrent généralement des erreurs Access Denied ou 403 Forbidden lorsque les comptes principaux exécutent des jobs ou accèdent à des ressources.
Erreurs courantes d'accès refusé
Voici des exemples d'erreurs d'accès refusé courantes :
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'.
Avant de commencer
- Pour résoudre les problèmes d'accès d'un compte principal à une ressource BigQuery, assurez-vous de disposer des autorisations IAM requises.
Recueillir des informations sur le problème
La première étape du dépannage d'un problème d'accès aux ressources consiste à déterminer l'autorisation manquante, le compte principal IAM dont l'accès a été refusé et la ressource à laquelle le compte principal tentait d'accéder.
Obtenir des informations à partir de l'historique des erreurs ou des jobs
Pour obtenir des informations sur le principal, la ressource et les autorisations, examinez le résultat de l'outil de ligne de commande bq, la réponse de l'API ou BigQuery dans la console Google Cloud .
Par exemple, si vous tentez d'exécuter une requête avec des autorisations insuffisantes, une erreur semblable à celle-ci s'affiche dans l'onglet Informations sur le job de la section Résultats de la requête de la console Google Cloud .
Examinez l'erreur pour déterminer le compte principal, la ressource et les autorisations.
Dans certains cas, vous pouvez demander les autorisations manquantes directement à partir du message d'erreur. Pour en savoir plus, consultez Messages d'erreur d'autorisation dans la documentation IAM.
Obtenir des informations à partir de Cloud Audit Logs
Si le message d'erreur est générique, s'il manque des informations ou si l'action a échoué dans un processus en arrière-plan, utilisez l'explorateur de journaux Cloud Audit Logs pour obtenir des informations sur l'erreur.
Dans la console Google Cloud , accédez à la page Explorateur de journaux.
Accéder à l'explorateur de journaux
Vous pouvez également accéder au menu de navigation, puis sélectionner Surveillance > Explorateur de journaux.
Dans l'explorateur de journaux, sélectionnez Journaux de projet pour le champ d'application des journaux.
Dans la fenêtre de requête, saisissez la requête suivante pour obtenir les erreurs liées aux autorisations à partir des journaux d'accès aux données 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)
Remplacez PROJECT_ID par l'ID du projet.
Dans les résultats de la requête, développez l'entrée de journal correspondant à l'échec de l'opération.
Dans la section
protoPayload, développez le tableauauthorizationInfo, puis chaque nœud du tableauauthorizationInfo.Le tableau
authorizationInfoaffiche chaque vérification d'autorisation effectuée lors de l'appel d'API.Pour connaître la cause de l'erreur, recherchez l'entrée
granted: false. L'entréegranted: falseaffiche les informations suivantes :permission: chaîne d'autorisation IAM qui a été vérifiée. Exemple :bigquery.tables.getDataresource: nom complet de la ressource à laquelle le compte principal a tenté d'accéder. Exemple :projects/myproject/datasets/mydataset/tables/mytable.principalEmail(si disponible) : référencé dansprotoPayload.authenticationInfo, il s'agit du compte principal qui a tenté d'effectuer l'action.
Utiliser Policy Analyzer pour les stratégies d'autorisation
Policy Analyzer pour les stratégies d'autorisation vous permet d'identifier quels comptes principaux IAM disposent de quel accès à quelles ressources BigQuery selon vos stratégies d'autorisation IAM.
Après avoir collecté des informations sur l'erreur d'autorisation, vous pouvez utiliser Policy Analyzer pour comprendre pourquoi le compte principal ne dispose pas de l'accès requis. Cet outil analyse toutes les stratégies pertinentes, les appartenances à des groupes Google et l'héritage des ressources parentes telles qu'un projet, un dossier et votre organisation.
Pour utiliser Policy Analyzer pour les stratégies d'autorisation, vous devez créer une requête d'analyse, spécifier un champ d'application pour l'analyse, puis exécuter la requête.
Dans la console Google Cloud , accédez à la page Policy Analyzer.
Vous pouvez également accéder au menu de navigation, puis sélectionner IAM et administration > Policy Analyzer.
Cliquez sur Créer une requête personnalisée.
Sur la page Configurer votre requête, saisissez les informations que vous avez recueillies précédemment :
Dans la section Sélectionner le champ d'application, dans le champ Sélectionner le champ d'application de la requête, vérifiez que votre projet actuel s'affiche ou cliquez sur Parcourir pour choisir une autre ressource.
Dans la section Définir les paramètres de requête, pour le Paramètre 1, sélectionnez Compte principal, puis saisissez l'adresse e-mail de l'utilisateur, du groupe ou du compte de service dans le champ Compte principal.
Cliquez sur Ajouter un paramètre.
Pour le Paramètre 2, sélectionnez Autorisation. Dans le champ Autorisation, cliquez sur Sélectionner, choisissez l'autorisation BigQuery, puis cliquez sur Ajouter. Par exemple, sélectionnez
bigquery.tables.getData.Cliquez sur Ajouter un paramètre.
Pour le paramètre 3, sélectionnez Ressource, puis saisissez le nom complet de la ressource dans le champ Ressource. Le nom de la ressource doit inclure le préfixe du service, comme dans les exemples suivants :
- Projet BigQuery :
//cloudresourcemanager.googleapis.com/projects/PROJECT_ID - Ensemble de données BigQuery :
//bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET - Table BigQuery :
//bigquery.googleapis.com/projects/PROJECT/datasets/DATASET/tables/TABLE
- Projet BigQuery :
Dans le volet Requête personnalisée, cliquez sur Analyser > Exécuter la requête.
Examinez les résultats de la requête. Le résultat peut être l'un des suivants :
- Une liste vide. L'absence de résultat confirme que le compte principal ne dispose pas de l'autorisation requise. Vous devez attribuer au compte principal un rôle qui fournit les autorisations appropriées.
- Un ou plusieurs résultats. Si l'analyseur trouve une stratégie d'autorisation, cela signifie qu'un accès existe. Cliquez sur Afficher la liaison pour chaque résultat afin d'afficher les rôles qui fournissent l'accès à la ressource dont le compte principal est membre. La liaison de stratégie indique si l'accès est accordé par l'appartenance à un groupe ou par héritage, ou si l'accès est refusé par une condition IAM ou une stratégie de refus IAM.
Trouver le rôle IAM approprié qui accorde les autorisations requises
Après avoir vérifié que le compte principal ne dispose pas d'un accès suffisant, l'étape suivante consiste à trouver le rôle IAM prédéfini ou personnalisé approprié qui accorde les autorisations requises. Le rôle que vous choisissez doit respecter le principe du moindre privilège.
Si votre organisation utilise des rôles personnalisés, vous pouvez trouver le rôle approprié en répertoriant tous les rôles personnalisés créés dans votre projet ou votre organisation. Par exemple, dans la console Google Cloud , sur la page Rôles, vous pouvez filtrer la liste par Type : Personnalisé pour n'afficher que les rôles personnalisés.
Pour trouver le rôle IAM prédéfini approprié, procédez comme suit :
Ouvrez la section "Autorisations BigQuery" de la page "Rôles et autorisations IAM BigQuery".
Dans la barre de recherche Saisir une autorisation, saisissez l'autorisation que vous avez récupérée à partir du message d'erreur, de l'historique des jobs ou des journaux d'audit. Exemple :
bigquery.tables.getData.Les résultats de recherche affichent tous les rôles BigQuery prédéfinis qui accordent l'autorisation.
Appliquez le principe du moindre privilège : dans la liste des rôles, choisissez le rôle le moins permissif qui accorde les autorisations requises. Par exemple, si vous avez recherché
bigquery.tables.getDatapour accorder la possibilité d'interroger les données d'une table, Lecteur de données BigQuery est le rôle le moins permissif qui accorde cette autorisation.Attribuez le rôle approprié au compte principal. Pour savoir comment attribuer un rôle IAM à une ressource BigQuery, consultez Contrôler l'accès aux ressources avec IAM.
Résoudre les problèmes courants d'accès refusé
Lorsqu'une opération échoue avec l'erreur 403 accessDenied (Access Denied:
RESOURCE_TYPE RESOURCE_ID: DETAILS), vérifiez les scénarios courants suivants en plus des étapes IAM générales précédentes :
- Ressource inexistante ou non-concordance d'emplacement (
or perhaps it does not exist). Lorsqu'un message d'erreur se termine paror perhaps it does not exist, BigQuery masque l'existence de la table, de la vue ou de la routine, car le compte principal ne dispose pas des autorisations de métadonnées d'ensemble de données ou de projet (bigquery.tables.getoubigquery.datasets.get). Vérifiez que l'ID du projet, l'ID de l'ensemble de données et le nom de la table sont correctement orthographiés, et vérifiez que votre requête s'exécute au même emplacement que l'ensemble de données. Vues et routines autorisées Lorsqu'un utilisateur interroge une vue autorisée ou une routine autorisée, il doit disposer de l'autorisation d'interroger la vue ou la routine, et la vue ou la routine elle-même doit être autorisée dans la liste de contrôle d'accès (LCA) de l'ensemble de données source. Si la requête échoue avec l'erreur
Access Deniedsur la table de base sous-jacente, ajoutez la vue ou la routine (ou l'ensemble de données complet en tant qu'ensemble de données autorisé) à la liste d'accès autorisé de l'ensemble de données source. Si une vue interroge une autre vue, chaque vue de la chaîne doit être autorisée sur l'ensemble de données à partir duquel elle lit.Si une vue autorisée ou un ensemble de données autorisé a été supprimé et qu'une autre vue ou un autre ensemble de données a été créé avec le même nom, les requêtes peuvent échouer avec l'erreur
Access Denied. Cette erreur peut se produire même si le nom apparaît toujours dans la liste d'accès autorisé de l'ensemble de données source, où les entrées supprimées peuvent rester jusqu'à 24 heures. Vérifiez Cloud Audit Logs pour voir si une vue autorisée ou un ensemble de données autorisé de la chaîne a été supprimé et remplacé depuis la dernière exécution réussie de la requête. Pour rétablir l'accès, supprimez d'abord l'entrée existante de la liste d'accès autorisée de l'ensemble de données source, puis ajoutez à nouveau la vue ou l'ensemble de données. L'ajout de la nouvelle vue avant la suppression de l'ancienne entrée peut échouer avec une erreurDuplicate authorized views.Pour modifier une vue sans interrompre l'autorisation, mettez à jour la requête SQL de la vue au lieu de la supprimer et de la recréer. Toutefois, si vous modifiez une routine autorisée avec une instruction
CREATE OR REPLACEou la méthoderoutines.update, vous devez autoriser à nouveau la routine.VPC Service Controls Si votre organisation utilise VPC Service Controls, les requêtes qui franchissent une limite de périmètre de service échouent avec
403 accessDeniedoupolicyViolation. Recherchez la valeurvpcServiceControlsUniqueIdentifierdu message d'erreur dans Cloud Audit Logs au moment de l'échec, puis utilisez l'analyseur de non-conformité pour inspecter les règles d'entrée et de sortie. Pour connaître la requête de l'explorateur de journaux à utiliser, consultez La requête est interdite par une règle d'administration.Rôles de base (
roles/owner,roles/editor,roles/viewer). Les rôles de projet de base n'incluent pas les autorisations au niveau de l'organisation requises pour les vues telles queINFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION, ni les autorisations spécialisées telles quebigquery.rowAccessPolicies.overrideTimeTravelRestrictions, qui est requise pour accéder aux données historiques d'une table qui possède ou possédait des règles d'accès au niveau des lignes (voir Voyage temporel et accès au niveau des lignes). Attribuez des rôles IAM BigQuery prédéfinis au lieu de vous appuyer sur des rôles de base.Écrasements temporaires de la stratégie IAM (
SetIamPolicy) : si les autorisations fonctionnent par intermittence, puis échouent, recherchezprotoPayload.methodName=~"SetIamPolicy"dans les journaux d'audit des activités d'administration pour vérifier si un script automatisé ou un pipeline d'infrastructure as code écrase les liaisons de stratégie existantes au lieu de les fusionner.Sources de données externes (Google Drive, Cloud Storage, BigLake) :
- Google Drive (
Permission denied while getting Drive credentials). Accordez à l'utilisateur ou au compte de service un accès en lecture au fichier Google Drive ou à la Google Sheet, assurez-vous que l'appelant fournit le champ d'application OAuthhttps://www.googleapis.com/auth/driveou mettez à jour les identifiants de requête programmée. - Tables Cloud Storage et BigLake Accordez
roles/storage.objectViewersur le bucket Cloud Storage à l'utilisateur (pour les tables externes standards) ou au compte de service de connexion BigLake (pour les tables BigLake).
- Google Drive (
Clés de chiffrement gérées par le client (CMEK) : Si la requête fait référence à une table protégée par une CMEK, assurez-vous que la clé Cloud KMS correspondante existe et est activée. Si une tâche de requête ou de chargement échoue avec
Cloud KMS Error: Permission 'cloudkms.cryptoKeyVersions.useToEncrypt' denied(ouuseToDecrypt), attribuez à l'agent de service de chiffrement BigQuery (bq-PROJECT_NUMBER@bigquery-encryption.) le rôleroles/cloudkms.cryptoKeyEncrypterDecryptersur la clé Cloud Key Management Service. Consultez Accorder une autorisation de chiffrement et de déchiffrement. Pour les autres erreurs CMEK, consultez Résoudre les problèmes liés aux clés de chiffrement gérées par le client.Emprunt d'identité d'un compte de service Si une requête utilisant l'emprunt d'identité d'un compte de service échoue avec l'erreur
Permission 'iam.serviceAccounts.getAccessToken' denied, accordez au compte principal appelant le rôleroles/iam.serviceAccountTokenCreatorsur le compte de service cible.Sécurité au niveau des colonnes (tags avec stratégie) et sécurité au niveau des lignes. Si une requête ou une instruction LMD échoue avec
Requires fineGrainedGet permission on the read columnsouUser does not have permission to access data protected by policy tag, accordez au compte principal le rôle Lecteur détaillé Data Catalog (roles/datacatalog.categoryFineGrainedReader) sur le tag avec stratégie, ou excluez les colonnes protégées de votre listeSELECT. Consultez Autorisations de contrôle des accès insuffisantes au niveau des colonnes. Si la table utilise la sécurité au niveau des lignes, examinez ses règles d'accès au niveau des lignes actives dans la console Google Cloud ou en exécutantbq ls --row_access_policies. Consultez Répertorier les règles d'accès au niveau des lignes d'une table.Délais de propagation IAM et des métadonnées Les nouveaux rôles IAM et les mises à jour des LCA d'ensemble de données sont cohérents à terme et prennent généralement quelques minutes pour se propager dans les caches. Si une autorisation vient d'être accordée, attendez quelques minutes, puis relancez la requête.
Conditions d'utilisation de BigQuery non acceptées
Chaîne d'erreur : BigQuery Terms of Service have not been accepted
Cette erreur HTTP 403 Forbidden (reason: termsOfServiceNotAccepted) se produit lorsque les conditions d'utilisation de BigQuery n'ont pas été acceptées. L'erreur n'est pas due à des autorisations IAM manquantes. Il peut être renvoyé pour des requêtes telles que la création d'un ensemble de données ou le chargement de données.
Pour résoudre ce problème, procédez comme suit :
Dans la console Google Cloud , accédez à la page BigQuery.
Si la page de bienvenue s'affiche, sélectionnez votre pays, cochez la case Conditions d'utilisation, puis cliquez sur Accepter et continuer. Pour en savoir plus, consultez la page Activer le bac à sable BigQuery.
Une fois les conditions d'utilisation acceptées, relancez la requête.
Résoudre les erreurs de non-respect des règles
Lorsque vous recevez une erreur HTTP 403 PERMISSION_DENIED dans BigQuery avec le motif d'erreur policyViolation, cela indique un échec dû à des règles d'administration, des périmètres de données ou VPC Service Controls.
Les sections suivantes décrivent les messages d'erreur les plus courants associés à ce motif d'erreur, leurs causes et comment les résoudre.
La requête est interdite par une règle de l'organisation
Chaîne d'erreur :
VPC Service Controls: Request is prohibited by organization's policy.
vpcServiceControlsUniqueIdentifier:
VPC_SERVICE_CONTROLS_UNIQUE_IDENTIFIER
Diagnostic
Votre requête provient d'une adresse réseau ou d'un client situé en dehors du périmètre VPC Service Controls désigné, ou elle ne respecte pas les règles d'entrée et de sortie définies pour votre espace de travail. Cela se produit fréquemment lorsque votre requête s'étend sur plusieurs projets. Par exemple, le projet de facturation de la requête se trouve en dehors du périmètre sécurisé du projet de données.
Solution
Trouvez l'identifiant unique. Récupérez le
vpcServiceControlsUniqueIdentifierinclus dans le message d'erreur. Utilisez cet ID pour filtrer l'explorateur de journaux Google Cloudafin de trouver le journal VPC Service Controls correspondant avec les détails du motif :protoPayload.metadata.@type="type.googleapis.com/google.cloud.audit.VpcServiceControlAuditMetadata" protoPayload.metadata.vpcServiceControlsUniqueId="VPC_SERVICE_CONTROLS_UNIQUE_IDENTIFIER"
Recherchez la valeur
violationReasonsousprotoPayload.metadata.violationReason. Une fois identifié, étudiez les détails supplémentaires de l'entrée de journal et suivez le guide de dépannage de VPC Service Controls existant. Envisagez également d'utiliser l'analyseur de cas de non-conformité.Corrigez la facturation multiprojets. Pour les requêtes interprojets, assurez-vous que le projet de facturation qui exécute la requête se trouve dans le même périmètre que les données interrogées. Si nécessaire, spécifiez manuellement un projet de facturation conforme à l'aide du sélecteur de projet de la console Google Cloud , de l'option
--project_iddans l'outil de ligne de commande bq, ou de votre requête d'API ou de bibliothèque cliente.Vérifiez les niveaux d'accès. Assurez-vous que votre réseau client, votre adresse IP ou votre compte utilisateur sont autorisés à l'aide d'Access Context Manager. La consoleGoogle Cloud nécessite des règles d'entrée spécifiquement configurées pour autoriser l'accès des utilisateurs aux environnements protégés.
L'exportation vers Google Drive est bloquée pour les projets pour lesquels VPC Service Controls est activé
Chaîne d'erreur :
Export to Google Drive is blocked for projects with VPC-SC enabled
Diagnostic
Google Drive n'est pas compatible avec VPC Service Controls. Comme Google Drive ne peut pas appliquer le périmètre de sécurité, BigQuery désactive automatiquement l'exportation des extraits d'API vers Google Drive pour toute requête provenant d'une limite VPC Service Controls afin d'empêcher l'exfiltration de données.
Solution
Au lieu d'exporter directement vers Google Drive, extrayez les résultats de votre requête dans un bucket Cloud Storage situé dans le même périmètre VPC Service Controls, ou enregistrez les résultats dans un fichier local.
Les tables externes Google Drive sont bloquées pour les projets pour lesquels VPC Service Controls est activé
Chaîne d'erreur :
Google Drive external tables are blocked for projects with VPC-SC enabled
Diagnostic
Par défaut, VPC Service Controls ne bloque pas l'interrogation des tables externes Google Drive (telles que les feuilles connectées). Toutefois, cette erreur s'affiche, car votre organisation Google Cloud a explicitement demandé que Google Cloudapplique une configuration de blocage stricte pour votre projet afin de remplacer le comportement permissif par défaut, empêchant ainsi toute requête entrante vers les données Google Drive depuis un périmètre VPC Service Controls.
Solution
Importez les données de la feuille de calcul Google Sheet ou du fichier Google Drive directement dans une table BigQuery standard de votre périmètre VPC Service Controls, plutôt que de les interroger de manière dynamique en tant que table fédérée externe. Vous pouvez également contacter votre administrateur Cloud interne pour discuter des limites d'exportation de données de votre organisation.
L'exportation vers Google Drive est bloquée pour votre projet
Chaîne d'erreur :
Export to Google Drive is blocked for your project.
Diagnostic
Même sans périmètre VPC Service Controls, vos administrateurs Google Cloud ont demandé qu'une configuration organisationnelle stricte et spécifique soit appliquée à votre projet, refusant toutes les fonctionnalités d'extraction de données vers Google Drive.
Solution
Choisissez une autre destination d'extraction, telle qu'un bucket Cloud Storage ou un fichier local, ou contactez votre administrateur Cloud interne pour discuter des limites d'exportation de données de votre organisation.
L'emplacement ne respecte pas la contrainte de règle d'administration
Chaîne d'erreur : LOCATION violates constraint CONSTRAINT_NAME on the
resource projects/PROJECT_ID ou LOCATION violates constraint CONSTRAINT_NAME on the
resource projects/PROJECT_ID/datasets/DATASET_ID
Diagnostic
Votre administrateur Cloud a configuré une contrainte de règle d'administration pour limiter précisément les emplacements où les ressources peuvent être créées ou analysées. Cette erreur s'affiche généralement dans les cas suivants :
- Créer un ensemble de données dans une région géographique non autorisée (par exemple, limitée par
constraints/gcp.resourceLocations) - Tentative d'utilisation de BigQuery Omni sur des clouds externes alors que cela n'est pas autorisé (par exemple, bloqué par
constraints/bigquery.disableBQOmniAWSouconstraints/bigquery.disableBQOmniAzure).
Solution
- Vérifiez l'élément
CONSTRAINT_NAMEexact fourni dans le message d'erreur pour comprendre quelle action est bloquée. - Sélectionnez une autre région non bloquée pour vos données ou contactez l'Google Cloud administrateur de votre organisation pour examiner la règle d'administration au niveau du dossier ou de l'organisation. Pour en savoir plus, consultez Structurer et définir des emplacements de ressources.
Résoudre les erreurs de non-authentification
Lorsque vous recevez une erreur HTTP 401 Unauthorized (gRPC UNAUTHENTICATED) dans BigQuery avec le motif d'erreur unauthenticated, cela signifie que la requête ne contient pas d'identifiants d'authentification valides, que le jeton d'accès OAuth 2.0 a expiré ou que l'appelant ne peut pas s'authentifier en tant qu'identité spécifiée.
Les sections suivantes décrivent les scénarios unauthenticated les plus courants, leurs causes et la manière de les résoudre.
Identifiants non valides ou arrivés à expiration
Chaînes d'erreur :
Invalid credentialUser credential was invalid.Credentials expiredCredentials missing required scope.Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential.
Diagnostic
Le jeton d'accès, la clé de compte de service ou les Identifiants par défaut de l'application (ADC) fournis avec la requête ont expiré, ont été révoqués ou ne disposent pas des champs d'application OAuth 2.0 requis. Cette erreur se produit également lorsque la requête est signée avec une horloge système qui s'est écartée de l'heure du protocole NTP (Network Time Protocol).
Solution
- Actualisez vos identifiants. Si vous vous authentifiez à partir d'un environnement de développement local, exécutez
gcloud auth application-default login(pour les ADC) ougcloud auth loginpour obtenir un nouveau jeton. - Vérifiez les clés de compte de service et les champs d'application OAuth. Si votre application utilise
GOOGLE_APPLICATION_CREDENTIALS, vérifiez que la variable pointe vers un fichier de clé JSON valide et non révoqué, que le compte de service est activé dans la consoleGoogle Cloud et que l'identifiant inclut le champ d'applicationhttps://www.googleapis.com/auth/bigqueryouhttps://www.googleapis.com/auth/cloud-platformrequis. - Utilisez les bibliothèques clientes actuelles et synchronisez les horloges système. Mettez à jour votre bibliothèque cliente BigQuery ou votre pilote ODBC ou JDBC vers la dernière version afin que les actualisations de jetons OAuth 2.0 et les identifiants fédérés soient gérés automatiquement. Assurez-vous également que l'horloge système de la machine hôte est synchronisée à l'aide de NTP.
Identifiants utilisateur du compte Google ou autorisation d'emprunt d'identité du compte de service manquants
Chaînes d'erreur :
Current user can not act as user for service account SERVICE_ACCOUNT_EMAILNo end user credentials found when accessing PROJECT_ID:DATASET_ID.TABLE_ID. Please use end user credentials to call BigQuery APIs.
Diagnostic
Le job ou la requête continue sont configurés pour s'exécuter en tant que compte de service personnalisé pour lequel l'appelant n'est pas autorisé à agir, ou la table ou la stratégie de sécurité cible nécessite des identifiants d'utilisateur de compte Google afin que BigQuery puisse évaluer l'accès par rapport à une identité d'utilisateur interactive.
Solution
- Accordez des autorisations d'emprunt d'identité d'un compte de service. Lorsque vous exécutez une requête continue ou un job configuré avec un compte de service personnalisé, accordez à l'appelant le rôle Utilisateur du compte de service (
roles/iam.serviceAccountUser, qui inclut l'autorisationiam.serviceAccounts.actAs) sur ce compte de service. Lorsque vous empruntez l'identité d'un compte de service ou que vous échangez des identifiants fédérés contre un jeton de courte durée, attribuez à l'appelant le rôle "Créateur de jetons du compte de service" (roles/iam.serviceAccountTokenCreator) sur le compte de service cible. - S'authentifier avec les identifiants d'un compte Google Lorsque la ressource cible nécessite des identifiants de compte utilisateur Google, authentifiez la requête à l'aide des identifiants OAuth 2.0 d'un utilisateur interactif (par exemple, en exécutant
gcloud auth application-default loginou en configurant l'authentification OAuth utilisateur dans votre outil de BI) plutôt que des identifiants de compte de service autonomes. - Vérifiez les règles d'entrée et de sortie de VPC Service Controls. Si la requête franchit une limite VPC Service Controls, vérifiez que les règles d'entrée et de sortie du périmètre autorisent l'identité de l'appelant et la ressource cible.
Compte limité, suspendu ou supprimé
Chaînes d'erreur :
The account was restricted due to REASONAccount deleted
Diagnostic
Le compte Google ou Google Workspace qui émet la requête a été suspendu, désactivé, limité ou supprimé par un administrateur ou une règle de sécurité du compte.
Solution
Contactez votre administrateur Google Workspace ou Cloud Identity pour vérifier l'état du compte dans la console d'administration Google et restaurer ou réactiver le compte utilisateur, ou mettez à jour la charge de travail pour l'authentifier avec un compte de service actif.
Résoudre les problèmes de contrôle des accès au niveau des colonnes
Les sections suivantes expliquent comment résoudre les problèmes liés au contrôle des accès au niveau des colonnes et aux tags avec stratégie Data Catalog.
Je ne vois pas les rôles Data Catalog
Si vous ne voyez pas de rôles tels que "Lecteur détaillé Data Catalog", il est possible que vous n'ayez pas activé l'API Data Catalog dans votre projet. Pour en savoir plus sur l'activation de l'API Data Catalog, consultez la section Avant de commencer. Les rôles Data Catalog s'affichent quelques minutes après l'activation de l'API Data Catalog.
Je ne peux pas afficher la page "Taxonomies"
Vous devez disposer d'autorisations supplémentaires pour afficher la page Catégories de tags avec stratégie dans la consoleGoogle Cloud . Par exemple, le rôle Administrateur de tags avec stratégie de Data Catalog a accès à la page Taxonomies.
J'ai appliqué des tags avec stratégie, mais cela ne semble pas fonctionner
Si vous recevez toujours des résultats de requête pour un compte qui ne devrait pas y avoir accès, il est possible que le compte reçoive des résultats mis en cache. Plus précisément, si vous avez déjà exécuté la requête avec succès, puis appliqué des tags avec stratégie, vous obtenez peut-être des résultats du cache des résultats de la requête. Par défaut, les résultats des requêtes sont mis en cache pendant 24 heures. La requête échoue immédiatement si vous désactivez le cache des résultats. Pour plus d'informations sur la mise en cache, consultez la section Impact du contrôle des accès au niveau des colonnes.
En règle générale, la propagation des mises à jour de Cloud IAM prend environ 30 secondes. La propagation des modifications apportées à la hiérarchie des tags avec stratégie peut prendre jusqu'à 30 minutes.
Je ne dispose pas de l'autorisation de lire dans une table avec une sécurité définie au niveau des colonnes
Vous devez disposer du rôle Lecteur détaillé ou du rôle Lecteur masqué à différents niveaux, par exemple au niveau de l'organisation, du dossier, du projet et du tag avec stratégie. Le rôle Lecteur détaillé accorde l'accès aux données brutes, tandis que le rôle Lecteur masqué accorde l'accès aux données masquées. Vous pouvez vérifier cette autorisation au niveau du projet à l'aide de l'outil de dépannage IAM.
J'ai défini un contrôle ultraprécis des accès dans la taxonomie des tags avec stratégie, mais les utilisateurs voient les données protégées
Pour résoudre ce problème, vérifiez les points suivants :
- Sur la page Taxonomies des tags avec stratégie du Centre de sécurité BigQuery, vérifiez que le bouton Appliquer le contrôle des accès est en position Activé.
Assurez-vous que vos requêtes n'utilisent pas de résultats de requête mis en cache. Si vous utilisez l'outil de ligne de commande bq pour tester vos requêtes, utilisez l'option
--nouse_cachepour désactiver le cache de requêtes. Exemple :bq query --nouse_cache --use_legacy_sql=false "SELECT * EXCEPT (customer_pii) FROM my_table;"
Considérations relatives à la migration de projets
Les tags avec stratégie et les taxonomies sont hébergés dans une organisation Google Cloud spécifique et ne sont pas automatiquement réassociés lorsqu'un projet est migré vers une nouvelle organisation. Si vous migrez un projet qui utilise des tags avec stratégie pour le contrôle des accès au niveau des colonnes vers une autre organisation, les problèmes suivants se produisent :
- Les tags avec stratégie ne sont plus gérables dans la console Google Cloud du projet migré.
- Vous ne pouvez pas appliquer ces tags avec stratégie aux nouvelles colonnes du projet migré.
- Les contrôles des accès au niveau des colonnes existants peuvent sembler toujours en place, mais le lien vers la taxonomie source dans l'organisation d'origine est rompu à des fins de gestion.
Pour résoudre ce problème, l'assistance Google Cloud doit intervenir manuellement pour réassocier la taxonomie à la nouvelle organisation. Si vous avez migré un projet avec des tags avec stratégie et que vous rencontrez ces problèmes, contactez Cloud Customer Care.
Résoudre les problèmes liés aux tags de gouvernance des données
Les sections suivantes décrivent comment résoudre les problèmes courants liés au contrôle de l'accès aux colonnes avec des tags de gouvernance des données.
Format des noms de tags incorrect
Lorsque vous créez des tags, vous définissez un nom court (par exemple, ssn). Toutefois, lorsque vous associez des tags à des colonnes de votre schéma ou que vous les utilisez dans des conditions, la clé de tag doit utiliser le format d'espace de noms (PROJECT_ID/TAG_KEY ou ORGANIZATION_ID/TAG_KEY), tandis que la valeur de tag utilise toujours le nom court.
Si vous ne fournissez que le nom court de la clé de tag, une erreur Invalid tagKey ou Invalid tagValue est générée.
Application de règles multiprojets
Par défaut, seules les règles de données du projet de la table sont évaluées. Les règles d'autres projets ne s'appliquent pas, sauf si un projet de stratégie de données par défaut est configuré au niveau de l'organisation. Pour en savoir plus sur la configuration et l'évaluation des règles interprojets, consultez Configurer un projet de stratégie de données par défaut.
Résoudre les problèmes liés aux clés de chiffrement gérées par le client
La liste suivante décrit les erreurs courantes et les solutions recommandées lorsque vous utilisez des clés de chiffrement gérées par le client (CMEK) avec Cloud Key Management Service :
- Erreur :
Please grant Cloud KMS CryptoKey Encrypter/Decrypter role - Résolution : Le compte de service BigQuery associé à votre projet ne dispose pas des autorisations IAM suffisantes pour opérer sur la clé Cloud KMS spécifiée. Pour accorder l'autorisation IAM requise, suivez les instructions du message d'erreur ou de la section Accorder une autorisation de chiffrement et de déchiffrement.
- Erreur :
Existing table encryption settings don't match encryption settings specified in the request - Résolution : cette erreur peut se produire lorsque la table de destination possède des paramètres de chiffrement différents de ceux de votre requête. Pour résoudre ce problème, remplacez la table à l'aide de la disposition d'écriture
TRUNCATEou spécifiez une table de destination différente. - Erreur :
This region is not supported - Solution : la région de la clé Cloud KMS ne correspond pas à la région de l'ensemble de données BigQuery pour la table de destination. Pour résoudre ce problème, sélectionnez une clé dans la région de votre ensemble de données ou chargez les données dans un ensemble de données appartenant à la même région que la clé.
- Erreur :
Your administrator requires that you specify an encryption key for queries in project PROJECT_ID. - Résolution : une règle d'administration a empêché la création d'une ressource ou l'exécution d'une requête. Pour en savoir plus sur cette règle, consultez Exiger des CMEK pour toutes les ressources.
- Erreur :
Your administrator prevents using KMS keys from project KMS_PROJECT_ID to protect resources in project PROJECT_ID. - Résolution : une règle d'administration a empêché la création d'une ressource ou l'exécution d'une requête. Pour en savoir plus sur cette règle, consultez la page Restreindre les clés Cloud KMS d'un projet BigQuery.
Étapes suivantes
- Pour obtenir la liste de tous les rôles et autorisations IAM BigQuery, consultez Rôles et autorisations IAM BigQuery.
- Pour en savoir plus sur la sécurité au niveau des colonnes, consultez Restreindre l'accès avec le contrôle des accès au niveau des colonnes.
- Pour en savoir plus sur les clés de chiffrement gérées par le client, consultez Protéger des données avec des clés Cloud KMS.
- Pour en savoir plus sur la résolution des problèmes liés aux stratégies d'autorisation et de refus dans IAM, consultez Résoudre les problèmes liés aux stratégies.
- Pour en savoir plus sur Policy Analyzer de Policy Intelligence, consultez Policy Analyzer pour les stratégies d'autorisation.
- Pour en savoir plus sur Policy Troubleshooter, consultez Utiliser Policy Troubleshooter.