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 القياسية.

نص الطلب

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

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

string ( bytes format)

مطلوب. عبارة App Attest API التي تعرضها واجهة برمجة التطبيقات App Attest من جهة العميل. هذا عنصر 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 )

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