نظرة عامة على مزودي GeoIP

يستخدم Extendy GeoShield مزود GeoIP لتحويل عنوان IP عام للعميل إلى معلومات الدولة. ثم تستخدم الإضافة الدولة المكتشفة عند تسجيل أحداث تسجيل الدخول وتقييم سلوك التنبيهات.

لا يتضمن Extendy GeoShield حساب مزود GeoIP مضمّنًا، ولا اشتراكًا مضمّنًا لدى المزود، ولا بيانات اعتماد API مضمّنة. يجب عليك الحصول على حساب المزود أو الوصول إلى API الخاص بالمزود الذي تختاره والمحافظة عليه بنفسك.

المزودون المدعومون

يدعم Extendy GeoShield حاليًا:

• IPinfo
• MaxMind

يستخدم كلا التكاملين الوصول عن بُعد عبر API / خدمة الويب. لا يدعم Extendy GeoShield حاليًا سير عمل قاعدة بيانات MaxMind محلية قابلة للتنزيل.

مسؤولية المزود

IPinfo وMaxMind مزودان خارجيان. مؤسستك مسؤولة عن:

• إنشاء حساب المزود أو الوصول إلى الخدمة أو المحافظة عليه؛
• الحصول على بيانات اعتماد المزود المطلوبة؛
• إدخال هذه البيانات في Extendy GeoShield؛
• متابعة توفر المزود وحدوده وفوترته وشروطه التجارية مباشرةً مع المزود؛
• حماية بيانات اعتماد المزود.

يستهلك Extendy GeoShield خدمة المزود التي تم إعدادها. ولا يتحكم في قواعد حساب المزود أو شروطه التجارية أو توفره أو سياسة الحصص لديه.

مقارنة المزودين

يتضمن الجدول أدناه فقط حقائق تنفيذية تم التحقق منها.

المزود	نموذج التكامل	حقول بيانات اعتماد Extendy GeoShield المطلوبة	حقول الدولة المستخدمة
IPinfo	Remote HTTPS API using the IPinfo Lite country data response	IPinfo API Token	country_code, country
MaxMind	Remote HTTPS GeoIP2 Country web service	MaxMind Account ID, MaxMind License Key	country.iso_code, country.names.en

لا يقارن هذا الجدول الدقة أو الأسعار أو السرعة أو الحصص أو ملاءمة خطط المزود.

تخزين بيانات الاعتماد

تُخزّن بيانات اعتماد المزود مشفرة عند التخزين، وتُعرض كقيم مخفية في صفحة إدارة Extendy GeoShield. ولا تُستخدم بيانات الاعتماد النصية إلا عند الحاجة إلى استعلام فوري من المزود أو اختبار المزود.

لا تُكتب بيانات الاعتماد عمدًا في صفحة Login Events أو WHMCS Activity Log أو مخرجات اختبار المزود أو قوالب البريد الإلكتروني أو الرسائل الموجهة للعملاء.

متى يعمل استعلام GeoIP

ينفذ Extendy GeoShield استعلام GeoIP فقط بعد توفر عنوان IP عام للعميل يكون مؤهلًا للاستعلام الخارجي.

يتم رفض عناوين IP الخاصة أو loopback أو المحلية أو عناوين التوثيق أو المحجوزة أو المشوهة أو غير المؤهلة قبل استرجاع بيانات اعتماد المزود أو استدعاء المزود.

اختبار اتصال المزود

تتضمن صفحة Settings نموذج GeoIP Provider Test Connection.

الاختبار:

• يستخدم إعداد GeoIP Provider المحفوظ حاليًا؛
• يستخدم بيانات اعتماد المزود المحفوظة؛
• يتطلب عنوان IP عام للاختبار؛
• لا يحفظ الإعدادات؛
• لا ينشئ حدث تسجيل دخول؛
• لا يخزن عنوان IP المستخدم للاختبار في إعدادات الإضافة؛
• يعرض فقط حقول نتيجة موحدة أو رسالة خطأ آمنة.

إذا غيّرت قائمة اختيار المزود ولم تحفظ الإعدادات أولًا، فسيظل الاختبار يستخدم المزود المحفوظ سابقًا.

سلوك فشل المزود

عندما يفشل استعلام المزود أثناء تسجيل الدخول، يسجل Extendy GeoShield الحدث ويتبع إعداد Alert When Country Detection Fails.

قيم الإعداد الحالية هي:

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

لا يتم إنشاء روابط ثقة Smart Mode لتنبيهات Unknown country / فشل تحديد الدولة.

للمرجع الأوسع لإعدادات الإضافة، راجع دليل الإعداد.