إنتقل إلى المحتوى الرئيسي

تنبيهات البريد الإلكتروني

يمكن لـ Extendy GeoShield إرسال تنبيه أمني عبر البريد الإلكتروني بعد تسجيل حدث تسجيل دخول مكتمل إلى منطقة العملاء في WHMCS وتقييمه.

يمثل تنبيه البريد الإلكتروني حدث تسجيل دخول تم تقييمه. ولا يعني أن Extendy GeoShield حظر تسجيل الدخول في WHMCS أو وافق عليه أو عكسه أو منعه. الإضافة تعمل بوضع التنبيه فقط في MVP.

متى يمكن إرسال بريد تنبيه​

يحاول Extendy GeoShield إرسال بريد تنبيه فقط عندما يستوفي حدث تسجيل الدخول وقرار التنبيه قواعد الإرسال الحالية.

يجب أن يكون الحدث:

  • لديه سياق Client Account محدد بأمان؛
  • لديه decision_result = alert_required؛
  • لديه alert_sent = false؛
  • يستخدم أحد أسماء قوالب تنبيهات Extendy GeoShield؛
  • لديه عنوان بريد أساسي صالح متاح في WHMCS Client Profile؛
  • يستخدم قالب بريد Extendy GeoShield لا يحتوي على مستلمين منسوخين مكوّنين.

إذا لم تتحقق هذه الشروط، قد يبقى الحدث مسجلاً، لكن يتم تجاوز إرسال البريد.

لمعرفة كيفية تحديد alert_required، راجع أوضاع التنبيه.

سلوك المستلم​

في MVP، يرسل Extendy GeoShield رسائل التنبيه عبر WHMCS SendEmail باستخدام سياق Client Account المحدد بأمان.

المستلم المقصود هو عنوان البريد الأساسي في WHMCS Client Profile لذلك Client Account.

يتم تضمين بريد WHMCS User الذي نفذ تسجيل الدخول في محتوى البريد بوصفه فاعل تسجيل الدخول. ولا يُستخدم كمستلم بريد مباشر في MVP.

إذا لم يتوفر سياق Client Account آمن، لا يخمّن Extendy GeoShield المستلم. ولا يرسل بصمت إلى Client Account آخر أو Contact أو مستلم منسوخ إضافي.

أوضاع التنبيه والدول الموثوقة​

تعتمد تنبيهات البريد الإلكتروني على Alert Mode المكوّن وسياق الدولة الذي تم تقييمه.

على مستوى عام:

  • Notify on Every Login يمكن أن ينبه لكل دولة تسجيل دخول مكتشفة، مع مراعاة قواعد فشل اكتشاف الدولة وفترة التهدئة.
  • Outside Trusted Countries يمكن أن ينبه عندما تكون الدولة المكتشفة خارج نموذج الدول الموثوقة للحدث.
  • Smart Mode يمكن أن ينبه عندما تكون الدولة المكتشفة جديدة بالنسبة إلى سياق WHMCS User وClient Account.

يمكن لمنطق الدول الموثوقة أن يكتم التنبيهات في الأوضاع التي تقيّم الدول الموثوقة. أما منطق الدول المعروفة في Smart Mode فهو مقيد بسياق المستخدم/العميل المحدد.

للتفاصيل، راجع الدول الموثوقة وSmart Mode.

فشل اكتشاف الدولة​

إذا لم يتمكن Extendy GeoShield من تحديد دولة تسجيل الدخول، فإنه يتبع إعداد Alert When Country Detection Fails.

  • No — يتم تسجيل الحدث، لكن لا يتم إرسال بريد إلى العميل فقط بسبب فشل اكتشاف الدولة.
  • Yes — يتم استخدام قالب تنبيه تسجيل الدخول العادي مع قيم دولة غير معروفة.

لا يتم إنشاء روابط ثقة Smart Mode لتنبيهات الدولة غير المعروفة أو فشل اكتشاف الدولة.

روابط الثقة في البريد​

فقط تنبيهات الدولة الجديدة المؤهلة في Smart Mode يمكن أن تتضمن trust_country_url.

روابط الثقة:

  • تتطلب مصادقة WHMCS قبل أن يمكن الوثوق بدولة؛
  • تكون مرتبطة بسياق WHMCS User وClient Account ذي الصلة عندما يكون متاحاً؛
  • تنتهي صلاحيتها بعد حوالي 48 ساعة؛
  • تستخدم مرة واحدة فقط؛
  • لا تثق بدولة لمجرد استلام البريد أو فتحه.

تبقي تنبيهات تسجيل الدخول العامة وتنبيهات الدولة غير المعروفة رابط الثقة فارغاً.

للسلوك الكامل لروابط الثقة، راجع Smart Mode.

سلوك فشل الإرسال​

لا يضمن Extendy GeoShield تسليم البريد الإلكتروني. يظل التسليم معتمداً على WHMCS ووسيلة البريد المكوّنة وبيئة صندوق بريد المستلم.

عندما يبلغ WHMCS SendEmail عن فشل، أو يتم إيقاف الإرسال، أو لا يمكن استخدامه بأمان، يبقي Extendy GeoShield قيمة alert_sent = false ويخزن سبب فشل آمناً في حدث تسجيل الدخول حيثما أمكن.

تشمل أمثلة حالات التجاوز أو الفشل الآمنة:

  • عدم توفر سياق Client Account آمن؛
  • عدم وجود بريد أساسي صالح في Client Profile؛
  • وجود مستلمين منسوخين مكوّنين على قالب تنبيه Extendy GeoShield؛
  • فشل SendEmail أو إيقافه؛
  • خطأ SendEmail داخلي مضبوط وآمن.

تكتب الإضافة أيضاً سجلات آمنة في WHMCS Activity Log لبعض حالات فشل البريد أو تجاوز الإرسال بسبب المستلمين. هذه السجلات لا تتضمن بيانات اعتماد المزود، أو ردود المزود الخام، أو رموز الثقة الخام، أو رؤوس الطلبات، أو الكوكيز، أو الجلسات، أو بيانات اعتماد قاعدة البيانات.

لا تنفذ الإضافة إعادة محاولة إلى ما لا نهاية.

سلوك اللغة​

ينشئ التنفيذ الحالي ويستخدم سجلات WHMCS General email template لصف اللغة الرئيسي/الافتراضي.

لا يطبق Extendy GeoShield محدد لغة خاصاً به للبريد الإلكتروني. كما أنه لا ينشئ حالياً صفوف قوالب عربية أو مترجمة أو بلغات أخرى تلقائياً.

ينبغي للمسؤولين مراجعة قوالب WHMCS التي تم إنشاؤها قبل الاستخدام الإنتاجي، وإدارة أي توطين لقوالب WHMCS وفق سير عمل قوالب البريد الإلكتروني في WHMCS لديهم.

ما لا تفعله رسائل التنبيه​

رسائل التنبيه لا تقوم بما يلي:

  • حظر تسجيل الدخول؛
  • إثبات هوية الزائر؛
  • إثبات أن عنوان IP آمن؛
  • الوثوق بدولة في Smart Mode تلقائياً؛
  • الإرسال بصمت إلى Contacts أو مستلمين منسوخين؛
  • تضمين بيانات اعتماد المزود أو ردود المزود الخام؛
  • كشف رموز الثقة الخام، باستثناء رابط الثقة القابل للاستخدام حيثما كان ذلك منطبقاً.

للمتغيرات الدقيقة في القوالب، راجع قوالب البريد الإلكتروني والمتغيرات.