Te recomendamos que uses una cuenta de servicio para la autenticación cuando realices la integración con la API de Google Spectrum Access System (SAS) Portal.
Configurar una cuenta de servicio
Para usar una cuenta de servicio para la autenticación, completa los siguientes pasos:
- Crea una cuenta de servicio.
Crea la clave de tu cuenta de servicio y selecciona JSON como el tipo de clave.
Después de completar este paso, la clave de tu cuenta de servicio se descargará en la ubicación predeterminada de tu navegador.
Otorga el rol de propietario del proyecto a la cuenta de servicio.
Obtén un token del portador
Debes proporcionar la autenticación de tu cuenta de servicio como un token del portador. Si llamas a la API de SAS Portal de forma directa, por ejemplo, cuando realizas una solicitud HTTP con curl
, debes pasar la autenticación como un token del portador en el encabezado Authorization
.
Para obtener un token del portador con tu cuenta de servicio, sigue estos pasos:
En gcloud CLI, autentícate en tu cuenta de servicio:
gcloud auth activate-service-account --key-file ${KEY_FILE}
Reemplaza
${KEY_FILE}
por la ruta del archivo de claves de tu cuenta de servicio.Usa tu cuenta de servicio para obtener un token de autorización:
gcloud auth print-access-token
El comando muestra un valor de token de acceso.
Cuando uses la API, pasa el valor del token como un token del portador en un encabezado
Authorization
. En la siguiente muestra de código, se muestra cómo pasar el valor del token como un token portador:curl -X GET -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${TOKEN}" \ "https://sasportal.googleapis.com/v1alpha1/customers"
Reemplaza lo siguiente:
${CLIENT_PROJECT}
: El ID del proyecto de Google Cloud desde el que realizas las solicitudes.${TOKEN}
: Es el token de autorización.
¿Qué sigue?
- Para obtener una descripción general de la API de SAS Portal, consulta la descripción general de la API de Google SAS Portal.
- Para obtener información sobre cada API, consulta las páginas de las APIs de Clientes y Device Manager.
- Para ver ejemplos del uso de la API, consulta Muestras de código de la API.
- Para obtener documentación de referencia, consulta APIs y referencia.