Method: projects.apps.exchangeAppAttestAttestation

يتم قبول مصادقة App Attest CBOR والتحقّق منها من خلال Apple باستخدام أرقام تعريف الحِزم والفِرق التي تم ضبطها مسبقًا. في حال كانت صالحة، يتم عرض أداة مصادقة يمكن استبدالها لاحقًا بـ AppCheckToken باستخدام apps.exchangeAppAttestAssertion .

لتوفير الراحة والأداء، سيحتوي عنصر الاستجابة لهذه الطريقة أيضًا على 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 من Google.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "attestationStatement": string,
  "challenge": string,
  "keyId": string,
  "limitedUse": boolean
}
الحقول
attestationStatement

string ( bytes format)

مطلوبة. عبارة App Attest التي تعرضها واجهة App Attest API من جهة العميل. هذا هو كائن CBOR تم ترميزه حسب base64url في استجابة JSON.

سلسلة بترميز base64.

challenge

string ( bytes format)

مطلوبة. تحدٍّ لمرة واحدة تم عرضه نتيجة مكالمة سابقة مباشرةً إلى apps.generateAppAttestChallenge .

سلسلة بترميز base64.

keyId

string ( bytes format)

مطلوبة. رقم تعريف المفتاح الذي تم إنشاؤه من خلال App Attest لتطبيق العميل.

سلسلة بترميز base64.

limitedUse

boolean

تحدّد هذه السياسة ما إذا كان سيتم استخدام هذه المصادقة في سياق استخدام محدود ( true ) أو مستند إلى جلسة ( false ). للسماح باستخدام هذه المصادقة مع ميزة الحماية من إعادة التشغيل ، اضبط القيمة على true . القيمة التلقائية هي false .

نص الاستجابة

رسالة استجابة لطريقة apps.exchangeAppAttestAttestation .

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "artifact": string,
  "appCheckToken": {
    object (AppCheckToken)
  }
}
الحقول
artifact

string ( bytes format)

أداة يمكن استخدامها في الطلبات المستقبلية لـ apps.exchangeAppAttestAssertion .

سلسلة بترميز base64.

appCheckToken

object ( AppCheckToken )

تشمل هذه الرسالة رمز التحقّق من التطبيقات.