Method: projects.apps.exchangeAppAttestAssertion

接受 App Attest 断言和工件,以及之前从 apps.exchangeAppAttestAttestation 获取的工件,并通过 Apple 验证这些断言和工件。如果有效,则返回 AppCheckToken

HTTP 请求

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

网址采用 gRPC 转码 语法。

路径参数

参数
app

string

必需。iOS 应用的相对资源名称,格式为:

projects/{project_number}/apps/{app_id}

如有必要,可以将 project_number 元素替换为 Firebase 项目的 ID。详细了解如何按照 Google 的 AIP 2510 标准使用项目标识符。

请求正文

请求正文包含结构如下的数据:

JSON 表示法
{
  "artifact": string,
  "assertion": string,
  "challenge": string,
  "limitedUse": boolean
}
字段
artifact

string ( bytes format)

必需。上一次调用 apps.exchangeAppAttestAttestation 返回的工件。

使用 base64 编码的字符串。

assertion

string ( bytes format)

必需。客户端 App Attest API 返回的 CBOR 编码断言。

使用 base64 编码的字符串。

challenge

string ( bytes format)

必需。由刚刚调用 apps.generateAppAttestChallenge 返回的一次性质询。

使用 base64 编码的字符串。

limitedUse

boolean

指定此证明是用于有限使用 ( true ) 还是基于会话 ( false ) 的环境。如需启用此认证以便与 重放攻击防范 功能搭配使用,请将此项设为 true 。默认值为 false

响应正文

如果成功,响应正文将包含一个 AppCheckToken 实例。