يقدّم هذا القسم تعليمات لإرسال التنبيهات إلى Google لأغراض الاختبار. وهذه عملية متكررة. ولن يتم نشر أي تنبيهات في هذه الخطوة من التنفيذ.
تأمين بياناتك
لضمان موثوقية معلومات التنبيه المهمة، والحفاظ على مصداقية نظامنا، وتقديم البيانات الصحيحة للجميع، نحتاج إلى تأمين بياناتك. يجب وضع خطة الأمان والصيانة كما هي قبل إرسال أي بيانات.
يمكنك استخدام HTTP بشرط أن تستخدم توقيعات رقمية لتوقيع التنبيهات، أو يمكنك استخدام HTTPS، وفي هذه الحالة، لا تحتاج إلى توقيع التنبيهات.
ننصحك باستخدام بروتوكول HTTPS.
بروتوكول HTTPS مع بروتوكول أمان طبقة النقل (TLS)
يتجنّب بروتوكول HTTPS الحاجة إلى تبادل الشهادات الرقمية الجديدة عند انتهاء صلاحية الشهادات الرقمية.
يجب الحصول على شهادة طبقة المقابس الآمنة (SSL) الصادرة عن مرجع تصديق موثوق به من Google Chrome. يُرجى الاطّلاع على أمثلة على السلطات هذه.
ننصح باستخدام HTTP/طبقة النقل الآمنة (TLS) ("https://...") عبر قناة طبقة المقابس الآمنة التقليدية.
HTTP باستخدام التوقيعات الرقمية
إذا كنت تستخدم HTTP مع توقيعات رقمية، يمكنك إنشاء المفتاح لتوقيع نفسك. تتطلب "تنبيهات Google العامة" ما يلي:
- قدِّم مفتاحك العام وآخر التعديلات على مفتاحك العام قبل 30 يومًا على الأقل من انتهاء صلاحية المفتاح القديم. سيؤدي ذلك إلى منع حالات الانقطاع غير المتوقَّعة في تحديثات البيانات.
- تنتهي الصلاحية وأن تنشئ مفتاحًا جديدًا كل عامين على الأقل.
- توقيع تنبيهاتك باستخدام توقيعك وفقًا لاقتراحات الأمان لنظام الكتابة بالأحرف الكبيرة.
إعداد خلاصتك
لاستضافة رسائل CAP وتسليمها، يُرجى تقديمها في خلاصة يمكن للجميع الوصول إليها، مثل أي مما يلي:
- تنسيق مشاركة Atom (مفضّل)
- تنسيق RSS
- EDXL-DE 1.0
اطّلع على أمثلة على مراجع CAP: خلاصات CAP للحصول على إرشادات حول إرسال تنبيهات CAP في خلاصة. للحصول على إرشادات حول إعداد خلاصات Atom أو RSS على تنبيهات CAP، راجع أمثلة على ممارسات CAP: خلاصات CAP. يمكنك تضمين رابط في خلاصة الويب لتنبيه CAP الكامل كما هو موضح هنا.
التحقق من الخلاصة
استخدام أداة كابيتال للتحقق من صحة الخلاصة.
تعديل التنبيهات والخلاصات
عند تغيير تنبيه، يمكنك إصدار تنبيه جديد يشير إلى التنبيه السابق، بدلاً من تغيير التنبيه الحالي أو إزالته من خلاصتك. بعد فترة زمنية مناسبة (على سبيل المثال، 24-48 ساعة)، أزِل التنبيهات المُلغاة أو المُعدَّلة أو المنتهية الصلاحية من خلاصتك.
<msgType> يجب أن يتضمن التعديل أو الإلغاء عنصر <references> واحدًا على الأقل.
على النحو المحدّد في معيار CAP، يجب أن تستخدم أي رسالة تنبيه يتم تعديلها تنبيهًا سابقًا <msgType>Update</msgType> وأن تضبط <references>code</references> على جميع الرسائل السابقة ذات الصلة التي لم تصل إلى تاريخها <expires>. يجب تطبيق التعديل أو الإلغاء على تنبيه غير منتهي الصلاحية.
هناك ثلاث طرق لإلغاء الأحداث حسب الترتيب المفضّل:
- يمكنك ضبط تاريخ
<expires>في كل حدث، مع تحديد وصف الرسالة المتوقّع بأن هذا التنبيه سينتهي عنده. - يمكنك إصدار
<alert>جديدة باستخدام<msgType>UPDATEو<responseType>"All Clear"و<expires>لفترة قصيرة في المستقبل. - إصدار
<alert>جديد باستخدام<msgType>CANCEL.
يُرجى الاطّلاع على أمثلة عن التنبيهات بشأن التحديثات وعمليات الإلغاء للحصول على أمثلة.