إعداد التكامل مع NINJIO

ما يقدمه هذا التكامل

يمكن لـ NINJIO تقديم نتائج القوى العاملة والتدريب ومحاكاة التصيد الاحتيالي. تشمل الأمثلة التي تمت مراجعتها ما يلي:

training.assigned — لديه تدريب أمني مُسند
training.completed — يُكمل التدريب الأمني
training.passed — يجتاز تقييمات التدريب الأمني
phishing.simulation.clicked — نقر على محاكاة دون الإبلاغ عنها
phishing.simulation.reported — يبلّغ عن محاكاة التصيد الاحتيالي

توضح هذه الأمثلة أنواع النشاط المعياري التي يمكن أن تستخدمها Living Security. راجع كيف تتحول بيانات التكامل إلى إشارات.

ما تحتاج إليه Living Security

بيانات الاعتماد	الوصف
مفتاح API	مفتاح API من NINJIO يتمتع بصلاحية القراءة على نقاط الوصول الخاصة بالموظفين والتدريب والتصيد الاحتيالي. ترسله Living Security مع كل طلب.

النطاقات: تحدد NINJIO نطاقات كل مفتاح API لكل نقطة وصول، مع أذونات منفصلة للقراءة والكتابة. تحتاج Living Security إلى صلاحية القراءة على ثلاث نقاط: الموظفين والتدريب والتصيد الاحتيالي. صلاحية الكتابة غير مطلوبة ويجب عدم منحها. الدور المطلوب: مسؤول في حساب NINJIO الخاص بك. لا يمكن إلا للمسؤولين الوصول إلى منطقة التكامل التي يتم فيها إنشاء المفاتيح.

تعرض NINJIO المفتاح الجديد مرة واحدة فقط، لحظة إنشائه. انسخه مباشرة إلى Living Security Platform، أو إلى خزنة كلمات مرور، قبل أن تنتقل إلى صفحة أخرى. لا يمكن استرداد مفتاح لم تنسخه — بل عليك إنشاء مفتاح بديل.

ما تسترده Living Security

البيانات	التفاصيل
المتعلمون	دليل الموظفين في NINJIO: الاسم، والبريد الإلكتروني، والقسم، والمسمى الوظيفي، والمدير، والدولة، والفرع، وحالة النشاط.
التدريب	من أُسند إليه كل تدريب، ومن أكمله — مع تاريخ الإكمال ودرجة الاختبار ودرجة التفاعل.
التصيد	من تفاعل مع رسالة تصيد احتيالي تجريبية، ومن أبلغ عنها، مع وقت حدوث ذلك.

لا يتم تخزين أرقام هواتف المتعلمين. تُرجع NINJIO رقم هاتف ضمن سجل الموظف. تتخلص منه Living Security قبل تخزين أي بيانات، لأنه لا توجد أي ميزة في Living Security تستخدمه.

المتطلبات المسبقة

حساب NINJIO مع إمكانية الوصول إلى API.
صلاحية مسؤول على admin.goninjio.com.
عناوين البريد الإلكتروني للمتعلمين في NINJIO مطابقة للعناوين التي تستخدمها أنظمتك المتصلة الأخرى. يُستخدم البريد الإلكتروني لمطابقة متعلم NINJIO مع شخص.

الجزء أ — في NINJIO

يُكمل مسؤول NINJIO لديك هذه الخطوات.

افتح منطقة التكامل

سجّل الدخول إلى admin.goninjio.com بصفتك مسؤولاً.
حدد Integration في أعلى يمين الشاشة.

أنشئ مفتاح API

حدد New API Key.
أعطِ المفتاح اسماً يسهل عليك تمييزه لاحقاً — على سبيل المثال Living Security.
امنح صلاحية القراءة على نقاط الوصول employee وtraining وphishing.
اترك صلاحية الكتابة غير محددة. تقرأ Living Security من NINJIO فقط.
حدد Generate Key.

انسخ المفتاح الآن. تعرضه NINJIO مرة واحدة ولا يمكنها عرضه مرة أخرى.

الجزء ب — في Living Security Platform

يُكمل مالك البرنامج هذه الخطوة، أو مسؤول النظام في حال استخدام الإعداد المفوَّض.

أصبحت الآن متصلاً بـ NINJIO.

وتيرة استرداد البيانات

البيانات	الجدول الزمني
المتعلمون	يومياً
نتائج التدريب	كل 6 ساعات
نتائج التصيد الاحتيالي	كل 6 ساعات

عند الاتصال لأول مرة، تسترد Living Security عمليات إكمال التدريب خلال الأشهر الـ 12 الماضية، ثم تواصل التحديث تدريجياً. تُقرأ عمليات محاكاة التصيد الاحتيالي مرة واحدة لكل منها، ثم يُعاد فحصها لمدة أسبوعين بعد انتهائها، بحيث تُسجَّل النقرات والتقارير المتأخرة.

قد يستغرق الاتصال الأول بحساب NINJIO كبير عدة دورات مجدولة لإكمال قراءة كل البيانات. تقرأ كل دورة أكبر قدر ممكن وتتابع الدورة التالية من حيث توقفت السابقة، ولذلك ترتفع الأعداد خلال اليوم الأول أو الثاني بدلاً من ظهورها دفعة واحدة.

استكشاف الأخطاء وإصلاحها

401 Unauthorized

مفتاح API غير صحيح أو غير مكتمل. السبب الأكثر شيوعاً هو نسخ المفتاح جزئياً — تعرضه NINJIO مرة واحدة، لذا يسهل حدوث لصق مبتور ويستحيل اكتشافه لاحقاً. أنشئ مفتاحاً جديداً في NINJIO وأعد الاتصال باستخدامه.

403 Forbidden

هذه ليست مشكلة في بيانات الاعتماد. تمت مصادقة المفتاح، لكن إحدى نقاط الوصول التي يحتاج إليها لم تُمنح صلاحية القراءة.لن تفيد إعادة لصق المفتاح نفسه. في NINJIO، أنشئ مفتاحاً بصلاحية القراءة على نقاط الوصول الثلاث جميعها — employee وtraining وphishing — ثم أعد الاتصال باستخدامه.

تم الاتصال بنجاح ولكن لا توجد بيانات تدريب

تحقق في NINJIO من أن حملة تدريب واحدة على الأقل نشطة وأن لها محاكاة مرفقة. تبقى الحملة التي لا تحتوي على محاكاة غير نشطة ولا تُسلّم شيئاً، ولذلك لا توجد نتائج لاستردادها.إذا كانت الحملات نشطة، فتأكد من أن المتعلمين فيها لديهم عناوين بريد إلكتروني في سجلاتهم في NINJIO. لا يمكن مطابقة متعلم ليس لديه عنوان بريد إلكتروني مع شخص، ويتم تخطيه.

يظهر التدريب كمُسند ولكن غير مكتمل

هذا هو العرض المتوقع للتدريب الذي لم يُنهِه المتعلم. تسجّل Living Security الإسناد عند بدء محاكاة NINJIO، وتسجّل الإكمال بشكل منفصل عندما تبلّغ NINJIO عن تاريخ إكمال.

بعض المتعلمين مفقودون

تطابق Living Security متعلم NINJIO مع شخص عن طريق عنوان البريد الإلكتروني. لن تتم مطابقة متعلم يختلف بريده الإلكتروني في NINJIO عن العنوان المسجل في دليلك — مثل عنوان شخصي أو نطاق قديم أو خطأ إملائي.صحّح العنوان في NINJIO وستتم المطابقة عند عملية الاسترداد المجدولة التالية.

نتائج التصيد الاحتيالي مفقودة لمحاكاة أقدم

تعيد Living Security فحص محاكاة التصيد الاحتيالي لمدة أسبوعين بعد انتهائها، ثم تتوقف. لا يتم التقاط النتائج التي تسجّلها NINJIO بعد تلك المدة. اتصل بالدعم إذا كنت بحاجة إلى إعادة قراءة محاكاة أقدم.

التكاملات