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

Valide un flux de consentement d'authentification en aval OAuth à trois acteurs (3LO) A2A une fois que l'utilisateur est revenu de l'écran de consentement tiers, et finalise les identifiants en aval avec le Gestionnaire d'authentification.

Requête HTTP


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

Les URL utilisent la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
session

string

Obligatoire. Nom de ressource de la session d'assistance ayant lancé le parcours de consentement. Utilisé avec downstreamConnector pour récupérer les consent_nonce stockées sur le serveur. Format : projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "userIdValidationState": string,
  "downstreamConnector": string
}
Champs
userIdValidationState

string (bytes format)

Obligatoire. État de validation opaque et chiffré renvoyé par Auth Manager dans la redirection du consentement. Transmis tel quel à FinalizeCredentials.

Chaîne encodée en base64.

downstreamConnector

string

Obligatoire. Nom de ressource du connecteur en aval (fournisseur d'authentification) à partir de la redirection du consentement (auth_provider_name). Nommé downstreamConnector pour le différencier du "connecteur" dans l'agent distant.

Corps de la réponse

Si la requête aboutit, le corps de la réponse est vide.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

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

Pour plus d'informations, consultez la Authentication Overview.