Para obtener información sobre cómo funcionan las ADC, incluso dónde se encuentran las credenciales, consulta Cómo funcionan las credenciales predeterminadas de la aplicación.
Las credenciales de usuario no funcionan
Si tu solicitud a la API muestra un mensaje de error sobre credenciales de usuario que no son compatibles con esta API, que la API no está habilitada en el proyecto o que no se estableció ningún proyecto de cuota, revisa la siguiente información.
Existen dos tipos de APIs de Google Cloud :
APIs basadas en recursos, que usan el proyecto asociado con los recursos a los que se accede para la facturación y la cuota.
APIs basadas en el cliente, que usan el proyecto asociado con el cliente que accede a los recursos para facturación y cuota.
Cuando proporcionas credenciales de usuario para autenticarte en una API basada en cliente, debes especificar el proyecto que se usará para la facturación y la cuota. Este proyecto se llama proyecto de cuota.
Existen varias formas de especificar un proyecto de cuota, incluidas las siguientes opciones:
Actualiza tu archivo de ADC para que use un proyecto diferente como el de cuota:
gcloud auth application-default set-quota-project YOUR_PROJECT
Si usas gcloud CLI para llamar a la API, puedes establecer el proyecto de cuota en la configuración de gcloud CLI:
gcloud config set billing/quota_project YOUR_PROJECT
Si llamas a la API de REST o de RPC directamente, usa el encabezado HTTP
x-goog-user-projectpara especificar un proyecto de cuota en cada solicitud. Para obtener más detalles, consulta Configura el proyecto de cuota con una solicitud de REST.
Debes tener el permiso de IAM serviceusage.services.use para que un proyecto pueda designarlo como tu proyecto de facturación. El
permiso serviceusage.services.use se incluye en el rol de IAM Consumidor de Service Usage. Si no tienes el permiso serviceusage.services.use
para ningún proyecto, comunícate con tu administrador de seguridad o un propietario del proyecto
que pueda otorgarte el rol de consumidor de Service Usage en el proyecto.
Para obtener más información sobre los proyectos de cuota, consulta Descripción general del proyecto de cuota. Para obtener más información sobre cómo configurar el proyecto de cuota, consulta Configura el proyecto de cuota.
Las credenciales son incorrectas
Si parece que tus credenciales no proporcionan el acceso que esperas o no se encuentran, verifica lo siguiente:
Si usas gcloud CLI para acceder a Google Cloud en un entorno local, asegúrate de comprender qué credenciales usas. Cuando usas gcloud CLI, usas las credenciales que proporcionaste a gcloud CLI con el comando
gcloud auth login. No usas las credenciales que proporcionaste a ADC. Para obtener más información sobre estos dos conjuntos de credenciales, consulta Configuración de la autenticación de gcloud CLI y configuración de ADC.Asegúrate de que la variable de entorno
GOOGLE_APPLICATION_CREDENTIALSse configure solo si usas una clave de cuenta de servicio u otro archivo JSON para ADC. Las credenciales a las que apunta la variable de entorno tienen prioridad sobre otras credenciales, incluida Workload Identity Federation for GKE.Confirma que el principal que realiza la solicitud tenga los roles de IAM necesarios. Si usas credenciales de usuario, las funciones deben otorgarse a la dirección de correo electrónico asociada con la cuenta de usuario. Si usas una cuenta de servicio, esa cuenta debe tener los roles necesarios.
Si proporcionas una clave de API con la solicitud a la API, esta tendrá prioridad sobre ADC en cualquier ubicación. Si configuraste la variable de entorno
GOOGLE_APPLICATION_CREDENTIALSy usas una clave de API, es posible que la API muestre una advertencia que te indique que se ignoran las credenciales que proporcionaste a ADC. Para detener la advertencia, desactiva la variable de entornoGOOGLE_APPLICATION_CREDENTIALS.
Permisos de autenticación insuficientes
Si tu solicitud a la API devuelve Request had insufficient authentication scopes
con el motivo ACCESS_TOKEN_SCOPE_INSUFFICIENT, tu token de acceso no
incluye un permiso que requiere la API. Otorgar roles de IAM no
soluciona este error.
Para resolver el error, haz lo siguiente:
Identifica la API de los campos
serviceymethoden los detalles del error.Busca el permiso que requiere la API en la referencia de la API del método o en Permisos de OAuth 2.0 para las APIs de Google. La mayoría de las APIs de Google Cloud aceptan el permiso
https://www.googleapis.com/auth/cloud-platform. Las APIs de Google Workspace requieren sus propios permisos.Verifica qué permisos tiene tu token. Desde el entorno en el que se produce el error, ejecuta el siguiente comando y revisa el campo
scope:curl "https://oauth2.googleapis.com/tokeninfo?access_token=$(gcloud auth application-default print-access-token)"
Agrega el permiso faltante donde tus credenciales obtienen sus permisos:
Compute Engine: Actualiza los permisos de acceso de la VM. Para obtener más información, consulta Permisos de acceso y Conecta la cuenta de servicio y actualiza el permiso de acceso.
GKE: Crea un grupo de nodos con los permisos de acceso necesarios o usa la federación de identidades para cargas de trabajo para GKE en tus cargas de trabajo. Para obtener más información, consulta Permisos de acceso predeterminados y Autentica en las APIs de Google Cloud desde cargas de trabajo de GKE.
Tu código: Agrega el permiso a los permisos que solicitas cuando creas credenciales. Para conocer los permisos que requiere cada API, consulta Permisos de OAuth 2.0 para las APIs de Google.
Delegación de todo el dominio: Autoriza los permisos necesarios para el ID de cliente de la cuenta de servicio en la Consola del administrador de Google Workspace y, luego, solicita esos permisos en tu código cuando crees credenciales. Para obtener más información, consulta Delega la autoridad para todo el dominio a la cuenta de servicio y Controla el acceso a la API con la delegación para todo el dominio.
Tipo de credencial no reconocido
Si tu solicitud a la API devuelve un error que incluye Error creating credential
from JSON. Unrecognized credential type, asegúrate de usar una credencial
válida. Los archivos de ID de cliente no son compatibles con el fin de proporcionar credenciales para ADC.