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

إعداد MaxMind

يمكن لـ Extendy GeoShield استخدام MaxMind كمزود خدمة ويب عن بُعد من نوع GeoIP2 Country لاستعلام الدولة.

يجب أن توفر حساب MaxMind أو الوصول إلى الخدمة بنفسك. لا يوفر Extendy GeoShield أرصدة MaxMind أو اشتراكات أو Account IDs أو License Keys أو وصولًا إلى الحساب.

important

يستخدم تكامل Extendy GeoShield الحالي خدمة MaxMind web service/API. ولا يدعم قاعدة بيانات MaxMind محلية أو تنزيل GeoLite2 أو مسار ملف MMDB أو سير عمل تحديث قاعدة بيانات محلية.

ما الذي يحتاجه Extendy GeoShield​

يتطلب تكامل MaxMind حقول بيانات اعتماد Extendy GeoShield التالية:

MaxMind Account ID
MaxMind License Key

يستخدم Extendy GeoShield HTTPS Basic Authentication لطلب المزود:

  • username: MaxMind Account ID;
  • password: MaxMind License Key.

لا يتم وضع بيانات الاعتماد في عنوان URL الخاص بالطلب.

يستخدم Extendy GeoShield استجابة MaxMind GeoIP2 Country ويربط استجابة المزود كما يلي:

حقل استجابة MaxMindحقل نتيجة Extendy GeoShield
country.iso_codecountry_code
country.names.encountry_name

قبل أن تبدأ​

قبل إعداد MaxMind في Extendy GeoShield:

  1. تأكد من أن لديك حساب MaxMind أو وصول API/خدمة ويب خاصًا بك.
  2. احصل على Account ID وLicense Key المطلوبين للوصول إلى المزود.
  3. تأكد من أن خادم WHMCS يستطيع تنفيذ طلبات HTTPS صادرة إلى المزود.
  4. قرر ما إذا كنت تريد الاختبار باستخدام عنوان IPv4 أو IPv6 عام حقيقي.

أسماء منتجات المزود والأسعار والحصص والشروط التجارية يتحكم بها MaxMind ولا يحددها Extendy GeoShield.

إعداد MaxMind في Extendy GeoShield​

  1. افتح صفحة إدارة إضافة Extendy GeoShield.
  2. افتح تبويب Settings.
  3. اضبط GeoIP Provider على MaxMind.
  4. أدخل MaxMind Account ID في MaxMind Account ID.
  5. أدخل MaxMind License Key في MaxMind License Key.
  6. راجع الإعدادات الأخرى التي تؤثر في معالجة تسجيل الدخول، خصوصًا Addon Enabled و Client IP Source و Alert When Country Detection Fails.
  7. انقر Save Settings.

بعد الحفظ، تظهر حقول بيانات الاعتماد كبيانات اعتماد مخزنة ومخفية. إرسال حقل بيانات اعتماد فارغ لاحقًا يُبقي القيمة المخزنة الحالية. استخدم خيار المسح/الإزالة إذا كنت تريد إزالة بيان اعتماد مخزن عمدًا.

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

بعد حفظ المزود وبيانات الاعتماد:

  1. ابقَ في تبويب Settings.
  2. في GeoIP Provider Test Connection، أدخل عنوان IPv4 أو IPv6 عامًا حقيقيًا.
  3. انقر Test Connection.

يستخدم الاختبار المزود المحفوظ حاليًا وبيانات الاعتماد المحفوظة. ولا يحفظ الإعدادات ولا ينشئ أحداث تسجيل دخول.

عند النجاح، تعرض النتيجة:

  • المزود؛
  • الحالة؛
  • رمز الدولة؛
  • اسم الدولة.

عند الفشل، تعرض النتيجة رسالة خطأ آمنة. ولا تعرض Account ID أو License Key أو عنوان URL للطلب أو بيانات المصادقة أو JSON الخام من المزود أو نص الاستثناء الخام.

سلوك الفشل​

إذا كان Account ID أو License Key مفقودًا أو غير صالح أو رفضه المزود، يعيد Extendy GeoShield فشلًا مضبوطًا. أثناء تسجيل الدخول، يبقى الحدث مسجلًا وتعتمد نتيجة التنبيه على Alert When Country Detection Fails.

إذا كانت بيانات الدولة مفقودة من استجابة المزود، يتعامل Extendy GeoShield مع الدولة على أنها غير معروفة لأغراض قرار تسجيل الدخول.

ملاحظات أمنية​

  • لا تشارك MaxMind Account ID أو MaxMind License Key في التذاكر أو لقطات الشاشة أو السجلات أو قوالب البريد الإلكتروني أو الوثائق.
  • يخزن Extendy GeoShield بيانات اعتماد المزود مشفرة عند التخزين.
  • لا يكتب Extendy GeoShield بيانات اعتماد المزود عمدًا في WHMCS Activity Log أو Login Events أو مخرجات اختبار المزود أو الرسائل الموجهة للعملاء.
  • يتم رفض عناوين IP غير الصالحة أو الخاصة قبل استرجاع بيانات الاعتماد أو تنفيذ طلب إلى المزود.

للمرجع العام للإعدادات، راجع دليل الإعداد.