Pour en savoir plus sur le fonctionnement des ADC, y compris sur l'emplacement des identifiants, consultez la page Fonctionnement des identifiants par défaut de l'application.
Les identifiants utilisateur ne fonctionnent pas
Si votre requête API renvoie un message d'erreur indiquant que les identifiants de l'utilisateur ne sont pas compatibles avec cette API, que l'API n'est pas activée dans le projet ou qu'aucun projet de quota n'est défini, consultez les informations suivantes.
Il existe deux types d'API Google Cloud :
Les API basées sur des ressources, qui utilisent le projet associé aux ressources accessibles pour la facturation et les quotas.
Les API basées sur un client, qui utilisent le projet associé au client qui accède aux ressources pour la facturation et les quotas.
Lorsque vous fournissez des identifiants utilisateur pour vous authentifier auprès d'une API basée sur un client, vous devez spécifier le projet à utiliser pour la facturation et les quotas. Ce projet est appelé projet de quota.
Il existe plusieurs façons de spécifier un projet de quota, y compris les options suivantes :
Mettez à jour votre fichier ADC pour utiliser un projet différent comme projet de quota :
gcloud auth application-default set-quota-project YOUR_PROJECT
Si vous utilisez gcloud CLI pour appeler l'API, vous pouvez définir votre projet de quota dans votre configuration gcloud CLI :
gcloud config set billing/quota_project YOUR_PROJECT
Si vous appelez directement l'API REST ou RPC, utilisez l'en-tête HTTP
x-goog-user-projectpour spécifier un projet de quota dans chaque requête. Pour en savoir plus, consultez la section Définir le projet de quota avec une requête REST.
Vous devez disposer de l'autorisation IAM serviceusage.services.use pour un projet si vous souhaitez le désigner comme votre projet de facturation. L'autorisation serviceusage.services.use est incluse dans le rôle IAM Consommateur Service Usage. Si vous ne disposez pas de l'autorisation serviceusage.services.use pour un projet, contactez votre administrateur de sécurité ou un propriétaire de projet qui peut vous attribuer le rôle Consommateur Service Usage sur le projet.
Pour en savoir plus sur les projets de quota, consultez la page Présentation des projets de quota. Pour en savoir plus sur les autres méthodes de définition de projet de quota, consultez la page Définir le projet de quota.
Identifiants incorrects
Si vos identifiants ne semblent pas vous fournir l'accès attendu, ou si vous ne les trouvez pas, vérifiez les points suivants:
Si vous utilisez gcloud CLI pour accéder à Google Cloud dans un environnement local, assurez-vous de bien comprendre les identifiants que vous utilisez. Lorsque vous utilisez la gcloud CLI, vous utilisez les identifiants que vous avez fournis à la gcloud CLI à l'aide de la commande
gcloud auth login. Vous n'utilisez pas les identifiants que vous avez fournis au service ADC. Pour en savoir plus sur ces deux ensembles d'identifiants, consultez la page Configuration de l'authentification via gcloud CLI et configuration de l'ADC.Assurez-vous que la variable d'environnement
GOOGLE_APPLICATION_CREDENTIALSn'est définie que si vous utilisez une clé de compte de service ou un autre fichier JSON pour ADC. Les identifiants pointés par la variable d'environnement sont prioritaires sur les autres identifiants, y compris pour Workload Identity Federation for GKE.Vérifiez que le compte principal effectuant la requête dispose des rôles IAM requis. Si vous utilisez des identifiants utilisateur, les rôles doivent être attribués à l'adresse e-mail associée au compte utilisateur. Si vous utilisez un compte de service, ce compte doit disposer des rôles requis.
Si vous fournissez une clé API avec la requête API, la clé API est prioritaire sur ADC, quel qu'en soit l'emplacement. Si vous avez défini la variable d'environnement
GOOGLE_APPLICATION_CREDENTIALSet que vous utilisez une clé API, celle-ci peut renvoyer un avertissement vous informant que les identifiants que vous avez fournis à ADC sont ignorés. Pour arrêter l'avertissement, supprimez la variable d'environnementGOOGLE_APPLICATION_CREDENTIALS.
Champs d'application d'authentification insuffisants
Si votre requête API renvoie Request had insufficient authentication scopes avec le motif ACCESS_TOKEN_SCOPE_INSUFFICIENT, cela signifie que votre jeton d'accès n'inclut pas un champ d'application requis par l'API. L'attribution de rôles IAM ne résout pas cette erreur.
Pour résoudre l'erreur, procédez comme suit :
Identifiez l'API à partir des champs
serviceetmethoddans les détails de l'erreur.Recherchez le niveau d'accès requis par l'API dans la documentation de référence de l'API de la méthode ou dans Niveaux d'accès OAuth 2.0 pour les API Google. La plupart des API Google Cloud acceptent le champ d'application
https://www.googleapis.com/auth/cloud-platform. Les API Google Workspace nécessitent leurs propres champs d'application.Vérifiez les champs d'application de votre jeton. Dans l'environnement où l'erreur se produit, exécutez la commande suivante et examinez le champ
scope:curl "https://oauth2.googleapis.com/tokeninfo?access_token=$(gcloud auth application-default print-access-token)"
Ajoutez le champ d'application manquant là où vos identifiants obtiennent leurs champs d'application :
Compute Engine : mettez à jour les niveaux d'accès de la VM. Pour en savoir plus, consultez Niveaux d'accès et Associer le compte de service et mettre à jour le niveau d'accès.
GKE : créez un pool de nœuds avec les niveaux d'accès requis ou utilisez Workload Identity Federation for GKE pour vos charges de travail. Pour en savoir plus, consultez Niveaux d'accès par défaut et S'authentifier auprès des API Google Cloud à partir de charges de travail GKE.
Votre code : ajoutez le champ d'application aux champs d'application que vous demandez lorsque vous créez des identifiants. Pour connaître les champs d'application requis par chaque API, consultez Champs d'application OAuth 2.0 pour les API Google.
Délégation au niveau du domaine : autorisez les champs d'application requis pour l'ID client du compte de service dans la console d'administration Google Workspace, puis demandez ces champs d'application dans votre code lorsque vous créez des identifiants. Pour en savoir plus, consultez Déléguer l'autorité au niveau du domaine au compte de service et Contrôler l'accès à l'API à l'aide de la délégation au niveau du domaine.
Type d'identifiants non reconnus
Si votre requête API renvoie une erreur incluant Error creating credential
from JSON. Unrecognized credential type, assurez-vous d'utiliser un identifiant valide. Les fichiers d'ID client ne sont pas compatibles avec la saisie des identifiants pour ADC.