Method: projects.locations.collections.engines.sessions.validateUserAuthorization

Valida un flujo de consentimiento de autenticación descendente de OAuth de 3 segmentos (3LO) de A2A después de que el usuario regresa de la pantalla de consentimiento de terceros y finaliza la credencial descendente con el Administrador de Auth.

Solicitud HTTP


POST https://discoveryengine.googleapis.com/v1alpha/{session=projects/*/locations/*/collections/*/engines/*/sessions/*}:validateUserAuthorization

Las URL usan la sintaxis de transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
session

string

Obligatorio. Es el nombre del recurso de la sesión de asistencia que inició el flujo de consentimiento. Se usa junto con downstreamConnector para recuperar el objeto consent_nonce almacenado en el servidor. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "userIdValidationState": string,
  "downstreamConnector": string
}
Campos
userIdValidationState

string (bytes format)

Obligatorio. Es el estado de validación opaco y encriptado que devuelve Auth Manager en el redireccionamiento de consentimiento. Se reenvía literalmente a FinalizeCredentials.

Es una cadena codificada en Base64.
downstreamConnector

string

Obligatorio. Nombre del recurso del conector downstream (proveedor de autenticación) del redireccionamiento de consentimiento (auth_provider_name). Se denomina downstreamConnector para diferenciarlo del "conector" en el agente remoto.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

Para obtener más información, consulta Authentication Overview.