Autentica solicitudes a la API

Vertex AI en el dispositivo aislado de Google Distributed Cloud (GDC) proporciona APIs y servicios que requieren autenticación. La autenticación es la forma en que demuestras tu identidad para acceder a los servicios mediante tokens.

Los tokens son objetos digitales que verifican que un emisor proporcionó las credenciales adecuadas y que se intercambiaron correctamente por el token. El token contiene información sobre la identidad de la cuenta solicitante y el acceso específico que está autorizada a tener.

En esta página, se describe cómo autenticar en las APIs de Vertex AI de manera programática. Según si accedes a las APIs de Vertex AI como usuario o con una cuenta de servicio, en esta página, se describen los pasos para obtener un token de autenticación para tus solicitudes a la API.

Elige una de las siguientes opciones para obtener un token de autenticación:

Cuenta de usuario

Sigue estos pasos para obtener un token de autenticación con permisos de usuario:

  1. Anota el extremo de la API que quieres usar.

  2. Para acceder al servicio de Vertex AI que quieres usar, otorga a tu cuenta de usuario el rol correspondiente que se indica en Prepara los permisos de IAM.

  3. Accede al dispositivo aislado de GDC con la cuenta de usuario con la que debes interactuar con la API:

    gdcloud auth login

  4. Obtén el token de autenticación:

    gdcloud auth print-identity-token --audiences=https://ENDPOINT

    Reemplaza ENDPOINT por el extremo del servicio que usas para tu organización. Para obtener más información, consulta el estado y los extremos del servicio.

    Según el uso previsto del token de autenticación, es posible que debas incluir el puerto después del extremo del servicio en la ruta de los públicos de la siguiente manera:

    • Si usas una biblioteca cliente para tu solicitud, debes incluir el puerto :443 después del extremo del servicio en la ruta de los públicos. Por lo tanto, la ruta --audiences en el comando debe ser https://ENDPOINT:443.
    • Si usas gRPC, curl o llamadas REST programáticas para tu solicitud, no incluyas el puerto. Por lo tanto, la ruta --audiences en el comando debe ser https://ENDPOINT.

El resultado muestra el token de autenticación. Agrega el token al encabezado de las solicitudes de línea de comandos que realices, como en el siguiente ejemplo:

-H "Authorization: Bearer TOKEN"

Reemplaza TOKEN por el valor del token de autenticación que muestra el resultado.

Cuenta de servicio

Sigue estos pasos para obtener un token de autenticación con una cuenta de servicio:

  1. Anota el extremo de la API que quieres usar.

  2. Configura la cuenta de servicio que quieres usar para acceder al servicio de Vertex AI.

  3. Otorga a la cuenta de servicio el rol correspondiente que se indica en Prepara los permisos de IAM para permitirle acceder al servicio que quieres usar.

  4. Obtén los pares de claves de servicio de tu cuenta de servicio.

  5. Instala la biblioteca cliente google-auth:

    pip install google-auth

  6. Agrega el siguiente código a una secuencia de comandos de Python:

    import os
import google.auth
from google.auth.transport import requests
import requests as reqs

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "PATH_TO_SERVICE_KEY"
os.environ["GRPC_DEFAULT_SSL_ROOTS_FILE_PATH"] = "CERT_NAME"

# If you use a client library for your request,
# you must include port :443 after the service endpoint
# in the audience path.
audience = "https://ENDPOINT"

creds, project_id = google.auth.default()
print(project_id)
creds = creds.with_gdch_audience(audience)

def test_get_token():
  sesh = reqs.Session()
  req = requests.Request(session=sesh)
  creds.refresh(req)
  print(creds.token)

if __name__=="__main__":
  test_get_token()

    Reemplaza lo siguiente:

    • PATH_TO_SERVICE_KEY: Es la ruta de acceso al archivo JSON que contiene los pares de claves de tu cuenta de servicio.
    • CERT_NAME: Es el nombre del archivo de certificado de la autoridad certificadora (CA), como org-1-trust-bundle-ca.cert. Solo necesitas este valor si estás en un entorno de desarrollo. De lo contrario, omítelo.

    • ENDPOINT: Es el extremo del servicio que usas para tu organización. Para obtener más información, consulta el estado y los extremos del servicio. Según el uso previsto del token de autenticación, es posible que debas incluir el puerto después del extremo del servicio en la ruta del público de la siguiente manera:

      • Si usas una biblioteca cliente para tu solicitud, debes incluir el puerto :443 después del extremo del servicio en la ruta del público. Por lo tanto, la ruta audience en la secuencia de comandos debe ser "https://ENDPOINT:443".
      • Si usas gRPC, curl o llamadas REST programáticas para tu solicitud, no incluyas el puerto. Por lo tanto, la ruta audience en la secuencia de comandos debe ser "https://ENDPOINT".

  7. Guarda la secuencia de comandos de Python.

  8. Ejecuta la secuencia de comandos de Python para recuperar el token:

    python SCRIPT_NAME

    Reemplaza SCRIPT_NAME por el nombre que le diste a tu secuencia de comandos de Python, como token.py.

El resultado muestra el token de autenticación. Agrega el token al encabezado de las solicitudes de línea de comandos que realices, como en el siguiente ejemplo:

-H "Authorization: Bearer TOKEN"

Reemplaza TOKEN por el valor del token de autenticación que muestra el resultado.