إنشاء قائمة عبارات

تتم استضافة الكشوفات في قائمة كشوفات مرمّزة بتنسيق JSON في مكان معروف على أحد الأصول، كما هو محدّد في مواصفات روابط مواد العرض. تحتوي قائمة العبارات على عبارة واحدة أو أكثر، ويمكن للمدير أن يحتوي على قائمة واحدة فقط من العبارات.

بنية قائمة كشف الحساب

يُرجى الاطّلاع على بنية قائمة الإقرارات.

موقع قائمة كشف الحساب

تتم استضافة قائمة كشوفات الحساب في موقع جغرافي معروف يعتمد على نوع أصلي (الموقع الإلكتروني أو التطبيق الذي يُصدر البيانات).

قوائم كشوفات مواقع الويب

على موقع الويب، قائمة العبارات هي ملف نصي يقع في العنوان التالي:

scheme://domain/.well-known/assetlinks.json

لاحظ النقطة في اسم المجلد .well-known.

سيتم التعامل مع أي استجابة من الخادم إلى جانب HTTP 200 على أنها خطأ، وسيؤدي ذلك إلى إنشاء قائمة عبارات فارغة. بالنسبة إلى HTTPS، سيؤدي أي اتصال بدون سلسلة شهادات يمكن التحقق منها باستخدام قائمة الجذر الموثوق بها أيضًا إلى قائمة عبارات فارغة.

مثال

في ما يلي مثال لقائمة العبارات على موقع إلكتروني: http://example.digitalassetlinks.org/.well-known/assetlinks.json

قوائم كشوفات تطبيقات Android

في تطبيق Android، تكون قائمة العبارات عبارة عن مقتطف JSON له نفس بنية ملف بيان موقع الويب، ولكن يتم تضمينه في ملف strings.xml، ويُشار إليه في البيان كما هو موضح بعد ذلك.

في AndroidManifest.xml:

<manifest>
  <application>
    ...
    <meta-data android:name="asset_statements" android:resource="@string/asset_statements" />
    ...
  </application>
</manifest>

في res/values/strings.xml:

<resources>
  ...
  <string name="asset_statements">
    ... statement list ...
  </string>
</resources>

مثال

في ما يلي مثال على مقتطف res/values/strings.xml لتطبيق متوافق مع Android يتيح مشاركة الموقع الجغرافي مع التطبيق (ميزة غير متوافقة حاليًا مع Android):

<resources>
    ...
    <string name="asset_statements">
      [{
        \"relation\": [\"delegate_permission/common.share_location\"],
        \"target\": {
          \"namespace\": \"web\",
          \"site\": \"https://example.com\"
        }
      }]
    </string>
</resources>

مطابقة أحد الأهداف

ترتبط كل عبارة بالهدف. عند استهلاك عبارة، يجب أن تتطابق مع الهدف في عبارة مقابل كيان معيّن في الواقع. إذا كان استهداف العبارة يتطابق مع الكيان، ستسري العبارة. في ما يلي قواعد تحديد ما إذا كان الاستهداف يتطابق مع كيان معيّن:

استهدافات المواقع الإلكترونية

بالنسبة إلى موقع الويب، يجب أن يتطابق كل من مخطط الموقع والمضيف والمنفذ تمامًا. يتم افتراض المنفذين الافتراضيين لـ HTTP وHTTPS (80 و443 على التوالي) ضمنيًا؛ إذا كان الهدف من العبارة يصف http://www.example.com:80، فإن موقع الويب http://www.example.com يعتبر مطابقًا.

مثال

بالنظر إلى استهداف العبارة التالي

"target": {
  "namespace": "web",
  "site": "https://www.google.com"
}

تتطابق عناوين URL التالية مع سوف:

  • https://www.google.com/
  • https://www.google.com:443/
  • https://www.google.com/foo
  • https://www.google.com/foo?bar
  • https://www.google.com/foo#bar
  • https://user@password:

عناوين URL التالية لن تتطابق:

  • http://www.google.com/ (مخطط خاطئ)
  • https://google.com/ (اسم المضيف غير مطابق)
  • https://www.google.com:444/ (المنفذ غير متطابق)

استهدافات التطبيقات

بالنسبة إلى التطبيق، يجب أن تتطابق تجزئة الشهادة واسم الحزمة للهدف مع التطبيق تمامًا.