التوثيق / المنصة
تكامل Slack
أرسل تنبيهات Gurdx إلى قناة Slack عبر Incoming Webhook دون كتابة أي كود.
المتطلبات#
- صلاحية إضافة تطبيقات في مساحة عمل Slack.
- حساب Gurdx بصلاحية «الإعدادات والتكاملات».
الخطوة 1: إنشاء Incoming Webhook في Slack#
- افتح دليل تطبيقات Slack وأنشئ تطبيقًا (من الصفر) لمساحة عملك، مثلًا باسم «Gurdx alerts».
- فعّل Incoming Webhooks للتطبيق.
- اختر Add New Webhook to Workspace ثم القناة التي ستستقبل التنبيهات مثل
#fraud-alerts. - انسخ عنوان الـ Webhook، وهو يشبه
https://hooks.slack.com/services/T000/B000/XXXX.
الخطوة 2: إضافته في Gurdx#
- في
https://gurdx.cretip.com/appافتح الإعدادات ثم التكاملات وأضف تكاملًا من نوع Slack. - الصق عنوان الـ Webhook.
- اختر أنواع الأحداث المرسلة أو اتركه على كل الأحداث.
- حدّد حدًا أدنى للخطورة، مثل 60.
- احفظ وفعّل.
الخطوة 3: التجربة#
أنشئ حدثًا حقيقيًا باستدعاء نقطة نهاية بقيمة ترفع الدرجة في الوضع الحي، مثل عنوان IP معروف لشبكة Tor.
curl "https://gurdx.cretip.com/api/lookup/ip/threats?ip=203.0.113.42&userID=slack-test" \
-H "Authorization: Bearer $GURDX_KEY"
Note: الوضع التجريبي (
mode=testأو مفتاحgx_test_) لا يُنشئ أحداثًا، فلن تصلك رسالة Slack منه. استخدم مفتاحًا حيًا للتجربة.
ما يستقبله Slack#
ينشر Gurdx رسالة نصية بسيطة إلى الـ Webhook بصيغة {"text": "..."}:
🛡️ Gurdx — Fraudulent payment attempt (My Shop)
Risk: 91/100
User: user_1042
Time: 2026-10-06 12:14:22
استكشاف الأخطاء#
- لا شيء يصل: تأكد أن التكامل مفعّل، وأن نوع الحدث مختار، وأن الحد الأدنى للخطورة ليس أعلى من درجة الحدث.
- Slack يرد بخطأ: أُلغي عنوان الـ Webhook أو أُزيل التطبيق من القناة. أنشئ Webhook جديدًا وحدّث التكامل.
- ضجيج زائد: ارفع الحد الأدنى للخطورة أو قيّد أنواع الأحداث.
يُعاد الإرسال الفاشل حتى 3 مرات بفاصل دقيقة. وللتنسيق الغني أو الأزرار، استقبل Webhook وانشر في Slack من كودك.
وجدت خطأ؟ أخبرنا عبر صفحة التواصل. تواصل معنا