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

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