Skip to main content

​
यह इंटीग्रेशन क्या योगदान देता है

KnowBe4 Workforce, Training और फ़िशिंग-सिमुलेशन से संबंधित Outcomes में योगदान दे सकता है। समीक्षा किए गए उदाहरणों में शामिल हैं:
  • training.completed — सुरक्षा प्रशिक्षण पूरा करता है
  • training.past.due — का प्रशिक्षण समय-सीमा से अधिक लंबित है
  • phishing.simulation.clicked — ने रिपोर्ट किए बिना सिमुलेशन पर क्लिक किया
ये उदाहरण उस सामान्यीकृत (normalized) गतिविधि के प्रकार दर्शाते हैं जिनका उपयोग Living Security कर सकता है। इंटीग्रेशन डेटा Signals में कैसे परिवर्तित होता है देखें।

​
Living Security को क्या चाहिए

स्कोप: कॉन्फ़िगर करने के लिए कोई स्कोप नहीं है — KnowBe4 Reporting API टोकन डिज़ाइन के अनुसार केवल-पठन (read-only) हैं और उनके स्कोप निर्धारित नहीं होते। यह टोकन उपयोगकर्ताओं, प्रशिक्षण नामांकनों और फ़िशिंग सुरक्षा परीक्षण परिणामों तक पठन पहुँच प्रदान करता है, और सिंक ठीक यही डेटा पढ़ता है। आवश्यक भूमिका: KnowBe4 में Account Admin (केवल खाता व्यवस्थापक ही Account Settings → API तक पहुँच सकते हैं)

​
पूर्वापेक्षाएँ

  • आपको अपने KnowBe4 कंसोल में Account Admin भूमिका के साथ साइन इन होना चाहिए। Reporting API सक्षम करने और टोकन जनरेट करने के लिए केवल खाता व्यवस्थापक ही Account Settings → API तक पहुँच सकते हैं।

​
भाग A — KnowBe4 में

ये चरण आपके KnowBe4 व्यवस्थापक द्वारा पूरे किए जाते हैं।
1

Reporting API सक्षम करें और टोकन जनरेट करें

  1. अपने KnowBe4 कंसोल में साइन इन करें।
  2. ऊपर दाएँ कोने में अपने खाते के नाम पर क्लिक करें और Account Settings चुनें।
  3. बाएँ नेविगेशन में API चुनें।
  4. यदि Reporting API पहले से सक्षम नहीं है, तो उसे सक्षम करें, फिर एक नया API टोकन जनरेट करें।
यदि आपका कंसोल उद्देश्य पूछता है, तो टोकन के लिए एक वर्णनात्मक उद्देश्य दें (उदा., Living Security Platform)।
KnowBe4 API टोकन का मान जनरेट होने पर केवल एक बार प्रदर्शित करता है। इसे तुरंत कॉपी करें और किसी सुरक्षित स्थान (उदा., पासवर्ड वॉल्ट या सीक्रेट्स मैनेजर) में संग्रहीत करें। यदि आप इसे कॉपी किए बिना अन्य पृष्ठ पर चले जाते हैं, तो आपको नया टोकन जनरेट करना होगा।
Reporting API केवल-पठन (read-only) है। यह उपयोगकर्ताओं, प्रशिक्षण नामांकनों और फ़िशिंग सुरक्षा परीक्षण परिणामों को उपलब्ध कराता है — यही वह डेटा है जिसे Living Security स्कोरिंग और रिपोर्टिंग के लिए ग्रहण करता है। किसी लेखन (write) पहुँच की आवश्यकता नहीं है।
2

Living Security के egress IP को Allowed IP Addresses सूची में जोड़ें

KnowBe4 आपको Reporting API पहुँच को स्रोत IP पतों के एक विशिष्ट समूह तक सीमित करने की सुविधा देता है। यह सेटिंग टोकन वाले स्थान पर ही मौजूद होती है:
  1. अपने KnowBe4 कंसोल में Account Settings → API → Allowed IP Addresses पर जाएँ।
  2. प्रत्येक Living Security egress IP पता को अनुमति सूची (allowlist) में जोड़ें। यही चार पते प्रत्येक रीजन में लागू होते हैं।
यदि Allowed IP Addresses सूची कॉन्फ़िगर की गई है, तो उसे नेटवर्क स्तर पर लागू किया जाता है। कनेक्शन डायलॉग प्रमाणीकरण के समय सफल होगा, लेकिन Living Security के egress IP को अनुमति सूची में जोड़े जाने तक डेटा सिंक विफल होंगे (नेटवर्क स्तर पर अवरुद्ध होकर, जो आमतौर पर 403 के रूप में दिखाई देता है)। यदि आप इस सूची में कोई भी पता जोड़ते हैं, तो आपको Living Security की रेंज भी जोड़नी होंगी, अन्यथा आपका टोकन मान्य होने पर भी हमारे अनुरोध अस्वीकार कर दिए जाएँगे।
इंफ्रास्ट्रक्चर अपडेट होने पर Living Security के egress IP पते बदल सकते हैं, हालाँकि हम ऐसे बदलाव बहुत कम करते हैं। यदि पहले काम कर रहे डेटा सिंक विफल होने लगें, तो Configuring Integration Egress IP Addresses देखें और सत्यापित करें कि Allowed IP Addresses सूची उससे मेल खाती है।
3

अपना KnowBe4 server region पहचानें

KnowBe4 Reporting API को रीजन-विशिष्ट होस्ट से उपलब्ध कराता है। आप होस्टनाम टाइप करने के बजाय कनेक्शन डायलॉग में अपना रीजन चुनते हैं:यदि आप सुनिश्चित नहीं हैं कि आपका खाता किस रीजन का उपयोग करता है, तो अपने KnowBe4 कंसोल URL का डोमेन देखें या अपने KnowBe4 व्यवस्थापक से संपर्क करें।
ये पाँच रीजन ही ऐसे हैं जिन तक Living Security पहुँच सकता है। यदि आपका KnowBe4 खाता किसी अन्य सर्वर पर है (उदाहरण के लिए US Government इंस्टेंस), तो कनेक्शन शुरू करने से पहले Living Security सहायता से संपर्क करें।

​
भाग B — Living Security Platform में

यह चरण प्रोग्राम स्वामी द्वारा पूरा किया जाता है, या प्रत्यायोजित (delegated) सेटअप का उपयोग करने पर सिस्टम व्यवस्थापक द्वारा।
अब आप KnowBe4 से कनेक्ट हो गए हैं।

​
समस्या निवारण

API टोकन अमान्य है या समाप्त हो चुका है। सत्यापित करें कि टोकन सही है और उसे Account Settings → API में पुनः जनरेट नहीं किया गया है।
या तो टोकन के पास Reporting API की पहुँच नहीं है, या अनुरोध का IP Allowed IP Addresses सूची में नहीं है। सत्यापित करें कि Reporting API सक्षम है और सभी चारों Living Security egress IP पते अनुमति सूची में हैं।
संभव है कि Reporting API के पास अभी लौटाने के लिए डेटा न हो, या टोकन के खाते को उन उपयोगकर्ताओं और कैंपेन की दृश्यता प्राप्त न हो जिन्हें Living Security ग्रहण करता है। सत्यापित करें कि टोकन Account Admin द्वारा जनरेट किया गया था।