Method: oauthClients.exchangeAppAttestAssertion

Acepta una aserción de App Attest y un artefacto obtenido anteriormente en oauthClients.exchangeAppAttestAttestation y los verifica con Apple. Si es válido, muestra un AppCheckToken de Google Cloud.

Solicitud HTTP

POST https://firebaseappcheck.googleapis.com/v1beta/{app=oauthClients/*}:exchangeAppAttestAssertion

La URL utiliza Transcodificación de gRPC sintaxis.

Parámetros de ruta

Parámetros
app

string

Obligatorio. El nombre del recurso relativo de la app para iOS, en el formato: 

projects/{project_number}/apps/{app_id}

Si es necesario, el project_number puede reemplazarse por el ID del proyecto de Firebase. Obtén más información para usar identificadores de proyectos en la AIP 2510 estándar.

Como alternativa, si se llama a este método para un cliente de OAuth protegido por la Verificación de aplicaciones, este campo también puede tener el siguiente formato: 

oauthClients/{oauth_client_id}

Puedes ver el ID de cliente de OAuth de tus clientes de OAuth en la consola de Google Cloud. Ten en cuenta que, por el momento, solo se admiten clientes de OAuth para iOS y que deben estar vinculados a las apps de Firebase para iOS correspondientes. Consulta la documentación para obtener más información.

Cuerpo de la solicitud

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

Representación JSON 
{
  "artifact": string,
  "assertion": string,
  "challenge": string,
  "limitedUse": boolean
}
Campos
artifact

string ( bytes format)

Obligatorio. El artefacto devuelto por una llamada anterior a oauthClients.exchangeAppAttestAttestation de Google Cloud.

String codificada en base64.

assertion

string ( bytes format)

Obligatorio. La aserción codificada con CBOR que muestra la API de App Attest del cliente.

String codificada en base64.

challenge

string ( bytes format)

Obligatorio. Un desafío único devuelto por una llamada inmediatamente anterior a oauthClients.generateAppAttestChallenge de Google Cloud.

String codificada en base64.

limitedUse

boolean

Especifica si esta certificación se debe usar en un uso limitado ( true ) o basadas en sesiones ( false ) y el contexto. Para permitir que esta certificación se use con el protección contra la repetición establécelo como true de Google Cloud. El valor predeterminado es false de Google Cloud.

Cuerpo de la respuesta

Si el proceso es satisfactorio, el cuerpo de la respuesta contiene una instancia de AppCheckToken de Google Cloud.