Method: projects.apps.exchangeAppAttestAttestation

Acepta una certificación CBOR de App Attest y la verifica con Apple mediante los IDs del paquete y del equipo preconfigurados. Si es válido, muestra un artefacto de certificación que luego se puede intercambiar por un AppCheckToken mediante apps.exchangeAppAttestAssertion .

Por conveniencia y rendimiento, el objeto de respuesta de este método también contendrá un AppCheckToken (si la verificación se realiza correctamente).

Solicitud HTTP

POST https://firebaseappcheck.googleapis.com/v1/{app=projects/*/apps/*}:exchangeAppAttestAttestation

La URL usa la sintaxis de la transcodificación de gRPC .

Parámetros de ruta de acceso

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 elemento project_number se puede reemplazar por el ID del proyecto de Firebase. Obtén más información para usar identificadores de proyectos en el estándar AIP 2510 de Google.

Cuerpo de la solicitud

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

Representación JSON 
{
  "attestationStatement": string,
  "challenge": string,
  "keyId": string,
  "limitedUse": boolean
}
Campos
attestationStatement

string ( bytes format)

Obligatorio. La declaración de App Attest que muestra la API de App Attest del cliente. Este es un objeto CBOR codificado en base64url en la respuesta JSON.

String codificada en base64.

challenge

string ( bytes format)

Obligatorio. Un desafío único que se muestra en una llamada inmediatamente anterior a apps.generateAppAttestChallenge .

String codificada en base64.

keyId

string ( bytes format)

Obligatorio. El ID de clave que genera App Attest para la app cliente.

String codificada en base64.

limitedUse

boolean

Especifica si esta certificación es para uso en un contexto de uso limitado ( true ) o basado en sesiones ( false ). Para permitir que esta certificación se use con la función de protección contra la repetición , establécela en true . El valor predeterminado es false .

Cuerpo de la respuesta

Mensaje de respuesta para el método apps.exchangeAppAttestAttestation .

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "artifact": string,
  "appCheckToken": {
    object (AppCheckToken)
  }
}
Campos
artifact

string ( bytes format)

Un artefacto que se pueda usar en llamadas futuras a apps.exchangeAppAttestAssertion .

String codificada en base64.

appCheckToken

object ( AppCheckToken )

Encapsula un token de la Verificación de aplicaciones.