Method: projects.apps.exchangeAppAttestAttestation

ยอมรับเอกสารรับรอง CBOR ของ App Attest แล้วยืนยันกับ Apple โดยใช้รหัสทีมและ Bundle ID ที่กําหนดค่าไว้ล่วงหน้า หากถูกต้อง จะมีการส่งคืนอาร์ติแฟกต์เอกสารรับรองที่สามารถแลกเปลี่ยนเป็น AppCheckToken โดยใช้ วันที่ apps.exchangeAppAttestAssertion ที่ใช้เวลาเพียง 2 นาที

เพื่อความสะดวกและประสิทธิภาพ ออบเจ็กต์การตอบกลับของเมธอดนี้จะมี AppCheckToken (หากการยืนยันสำเร็จ)

คำขอ HTTP

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

URL ใช้ การแปลง gRPC ไวยากรณ์

พารามิเตอร์เส้นทาง

พารามิเตอร์
app

string

ต้องระบุ ชื่อทรัพยากรที่เกี่ยวข้องของแอป iOS ในรูปแบบ 

projects/{project_number}/apps/{app_id}

หากจำเป็น project_number สามารถแทนที่องค์ประกอบด้วยรหัสโปรเจ็กต์ของโปรเจ็กต์ Firebase ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุโปรเจ็กต์ใน AIP 2510 มาตรฐาน

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "attestationStatement": string,
  "challenge": string,
  "keyId": string,
  "limitedUse": boolean
}
ช่อง
attestationStatement

string ( bytes format)

ต้องระบุ คำสั่ง App Attest ที่แสดงโดย App Attest API ฝั่งไคลเอ็นต์ นี่คือออบเจ็กต์ CBOR ที่เข้ารหัส base64url ในการตอบกลับ JSON

สตริงที่เข้ารหัสฐาน 64

challenge

string ( bytes format)

ต้องระบุ ระบบส่งการยืนยันแบบครั้งเดียวไปยัง apps.generateAppAttestChallenge ที่ใช้เวลาเพียง 2 นาที

สตริงที่เข้ารหัสฐาน 64

keyId

string ( bytes format)

ต้องระบุ รหัสคีย์ที่ App Attest สร้างขึ้นสำหรับแอปไคลเอ็นต์

สตริงที่เข้ารหัสฐาน 64

limitedUse

boolean

ระบุว่าเอกสารรับรองนี้มีไว้สำหรับใช้ใน การใช้งานที่จำกัด ( true ) หรือ ตามเซสชัน ( false ) หากต้องการเปิดใช้เอกสารรับรองนี้กับ การป้องกันการเล่นซ้ำ ฟีเจอร์ ตั้งค่าเป็น true ที่ใช้เวลาเพียง 2 นาที ค่าเริ่มต้นคือ false ที่ใช้เวลาเพียง 2 นาที

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ apps.exchangeAppAttestAttestation

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "artifact": string,
  "appCheckToken": {
    object (AppCheckToken)
  }
}
ช่อง
artifact

string ( bytes format)

อาร์ติแฟกต์ที่สามารถใช้ในการเรียกในอนาคตไปยัง apps.exchangeAppAttestAssertion ที่ใช้เวลาเพียง 2 นาที

สตริงที่เข้ารหัสฐาน 64

appCheckToken

object ( AppCheckToken )

สรุปโทเค็น App Check