Soluciona problemas de configuración de ADC

En esta página, se describen algunos problemas comunes que pueden surgir cuando usas las credenciales predeterminadas de la aplicación (ADC).

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-project para 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_CREDENTIALS se 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_CREDENTIALS y 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 entorno GOOGLE_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:

  1. Identifica la API de los campos service y method en los detalles del error.

  2. 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 permisohttps://www.googleapis.com/auth/cloud-platform. Las APIs de Google Workspace requieren sus propios permisos.

  3. 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)"
  4. Agrega el permiso faltante donde tus credenciales obtienen sus permisos:

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.