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

إعداد ipinfo.io

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

يجب أن توفر حساب IPinfo أو الوصول إلى الخدمة بنفسك. لا يوفر Extendy GeoShield أرصدة IPinfo أو اشتراكات أو رموز API أو وصولًا إلى الحساب.

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

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

IPinfo API Token

يرسل التكامل أثناء التشغيل الرمز ضمن ترويسة HTTPS Authorization: Bearer. ولا يتم وضع الرمز في عنوان URL الخاص بالطلب.

يستخدم Extendy GeoShield بيانات الدولة من IPinfo Lite ويربط استجابة المزود كما يلي:

حقل استجابة IPinfoحقل نتيجة Extendy GeoShield
country_codecountry_code
countrycountry_name

لا يعتمد Extendy GeoShield في هذا التكامل على المدينة أو المنطقة أو الإحداثيات أو ASN أو الخصوصية أو أي حقول أخرى غير متعلقة بالدولة.

قبل أن تبدأ​

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

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

أسماء خطط المزود والأسعار والحصص وحدود المعدل يتحكم بها IPinfo ولا يحددها Extendy GeoShield.

إعداد IPinfo في Extendy GeoShield​

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

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

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

بعد حفظ المزود والرمز:

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

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

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

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

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

سلوك الفشل​

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

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

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

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

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