Method: projects.apps.generateAppAttestChallenge

إنشاء تحدٍّ يحمي سلامة مكالمة apps.exchangeAppAttestAttestation أو apps.exchangeAppAttestAssertion التالية مباشرةً. يجب عدم إعادة استخدام تحدٍ مع مكالمات متعددة.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
app

string

مطلوبة. اسم المورد النسبي لتطبيق iOS، بالتنسيق:

projects/{project_number}/apps/{app_id}

وإذا لزم الأمر، يمكن استبدال العنصر project_number برقم تعريف مشروع مشروع Firebase. تعرَّف على المزيد من المعلومات عن استخدام معرّفات المشاريع في معيار AIP 2510 من Google.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة الرد لطريقة apps.generateAppAttestChallenge.

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

تمثيل JSON 
{
  "challenge": string,
  "ttl": string
}
الحقول
challenge

string (bytes format)

اختبار يتم استخدامه لمرة واحدة للعميل لتمريره إلى App Attest API.

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

string (Duration format)

المدة بدءًا من وقت صياغة هذا التحدي وحتى انتهاء صلاحيته. يهدف هذا الحقل إلى تسهيل إدارة الرموز المميّزة من جهة العميل، حيث قد يكون لدى العميل انحراف في الساعة، ولكنه لا يزال قادرًا على قياس المدة بدقة.

مدة بالثواني يصل عددها إلى تسعة أرقام كسرية وتنتهي بـ "s". مثال: "3.5s".

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/firebase

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.