Autorización

La API de Checks usa OAuth 2.0 para autorizar solicitudes.

El permiso de OAuth es https://www.googleapis.com/auth/checks.

Autoriza con OAuth 2.0

En esta guía de inicio rápido, se muestra cómo autorizar solicitudes con una cuenta de servicio usando la CLI de gcloud.

Configura la CLI de gcloud

  1. Instala la CLI de gcloud.

  2. Accede con la CLI de gcloud y configura un proyecto predeterminado:

    gcloud auth login
gcloud config set project PROJECT_ID

  3. Crea una cuenta de servicio y una clave de cuenta de servicio, y configura las credenciales predeterminadas de la aplicación:

    gcloud iam service-accounts create SA_NAME
gcloud iam service-accounts keys create key.json \
    --iam-account=SA_NAME@PROJECT_ID.iam.gserviceaccount.com
export GOOGLE_APPLICATION_CREDENTIALS=key.json

Otorga acceso a la API a tu cuenta de Checks

Quienes llamen a la API deben ser usuarios de tu cuenta de Checks y tener los permisos de lectura o escritura adecuados.

  1. Ve a la página Configuración en la Consola de verificaciones y haz clic en Administrar usuarios.

  2. Invita a la cuenta de servicio que creaste antes:

    SA_NAME@PROJECT_ID.iam.gserviceaccount.com

Cómo encontrar el ID de tu cuenta

El ID de tu cuenta de Checks es el ID de recurso para las solicitudes de recursos de la cuenta.

Por ejemplo, el método accounts.apps.list, que enumera tus apps, tiene el siguiente formato:

https://checks.googleapis.com/v1alpha/accounts/ACCOUNT_ID/apps

Puedes encontrar el ID de tu cuenta en la página Configuración, en la sección Información de la cuenta de la Consola de verificaciones.

Obtén un token de acceso

gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/checks

Haz una solicitud

curl -X GET \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/checks)" \
    "https://checks.googleapis.com/v1alpha/accounts/ACCOUNT_ID/apps"