> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# KnowBe4 इंटीग्रेशन सेटअप

> उपयोगकर्ताओं, प्रशिक्षण नामांकनों और फ़िशिंग सुरक्षा परीक्षण परिणामों को आयात करने के लिए KnowBe4 को Living Security Platform से कनेक्ट करें।

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>संबंधित संसाधन</h2>
    <ul>
      <li>
        <a href="/hi/signals/data-sources">जानें कि Integrations का डेटा Human Risk Management Signals में कैसे परिवर्तित होता है</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Living Security के Integrations देखें</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Living Security Platform खोलें</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Living Security डेमो का अनुरोध करें</a>
      </li>
    </ul>
  </>;

export const EgressIpSafelist = ({system}) => <Note>
    <strong>Living Security के चारों sync egress IP addresses को</strong> {system} में allowlist में जोड़ें।{' '}
    यदि {system} CIDR notation की अपेक्षा करता है, तो प्रत्येक को <code>/32</code> के साथ एकल host के रूप में दर्ज करें:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    ट्रैफ़िक इन चारों में से किसी भी पते से आ सकता है, इसलिए केवल कुछ को allowlist करने से बीच-बीच में sync विफल होता रहता है। ये चारों पते Living Security के प्रत्येक region में समान हैं। पूरी सूची, परिवर्तन नीति और समस्या निवारण के लिए{' '}
    <a href="/hi/integrations/managing/egress-ip-addresses">
      Configuring Integration Egress IP Addresses
    </a>{' '}
    देखें।
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Living Security Platform में क्रेडेंशियल दर्ज करें">
    <p>
      यह चरण वही व्यक्ति पूरा करता है जिसके पास Living Security का एक्सेस है — प्रोग्राम ओनर, या यदि सिस्टम एडमिन को आमंत्रित किया गया है (डेलीगेटेड सेटअप), तो सिस्टम एडमिन।
    </p>
    <ol>
      <li>
        <strong>Settings → Integrations → Catalog</strong> पर जाएँ, <strong>{tile}</strong> टाइल ढूँढें और{' '}
        <strong>Connect</strong> पर क्लिक करें।
      </li>
      <li>
        नीचे दिए गए फ़ील्ड भरें, फिर <strong>Connect</strong> पर क्लिक करें।
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>यह मार्गदर्शिका आपके {system} एडमिनिस्ट्रेटर के लिए है।</strong> इसमें {system} के भीतर API
      क्रेडेंशियल बनाने की प्रक्रिया बताई गई है, जिसके लिए {system} का एडमिन एक्सेस आवश्यक है — Living Security Platform का नहीं।
    </p>
    <p>
      यदि आप Living Security के <strong>प्रोग्राम ओनर</strong> हैं और {system} का प्रशासन नहीं करते हैं,
      तो यह पेज उस व्यक्ति को भेजें जो इसका प्रशासन करता है। वे Part A पूरा करके क्रेडेंशियल आपको सौंप देंगे
      (या, यदि आपने उन्हें प्लेटफ़ॉर्म में आमंत्रित किया है, तो उन्हें सीधे दर्ज कर देंगे)।
      {recommendDelegated && <>
          {' '}चूँकि सेटअप में संवेदनशील की सामग्री (key material) तैयार होती है, इसलिए हम{' '}
          <strong>delegated setup</strong> मार्ग अपनाने की अनुशंसा करते हैं, ताकि सीक्रेट आपको कभी वापस न भेजा जाए।
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="KnowBe4" />

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

KnowBe4 Workforce, Training और फ़िशिंग-सिमुलेशन से संबंधित Outcomes में योगदान दे सकता है। समीक्षा किए गए उदाहरणों में शामिल हैं:

* `training.completed` — सुरक्षा प्रशिक्षण पूरा करता है
* `training.past.due` — का प्रशिक्षण समय-सीमा से अधिक लंबित है
* `phishing.simulation.clicked` — ने रिपोर्ट किए बिना सिमुलेशन पर क्लिक किया

ये उदाहरण उस सामान्यीकृत (normalized) गतिविधि के प्रकार दर्शाते हैं जिनका उपयोग Living Security कर सकता है। [इंटीग्रेशन डेटा Signals में कैसे परिवर्तित होता है](/hi/signals/data-sources) देखें।

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

| क्रेडेंशियल | विवरण |
| - | - |
| **API key** | **Account Settings → API** के अंतर्गत जनरेट किया गया Reporting API बेयरर टोकन। यह प्रत्येक अनुरोध में `Authorization: Bearer` हेडर में भेजा जाता है। |
| **Reporting API server region** | वह रीजन जिस पर आपका KnowBe4 खाता प्रोविजन किया गया है, जिसे सूची से चुना जाता है (US, EU, Canada, UK, Germany)। |

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

**आवश्यक भूमिका:** KnowBe4 में **Account Admin** (केवल खाता व्यवस्थापक ही **Account Settings → API** तक पहुँच सकते हैं)

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

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

***

## भाग A — KnowBe4 में

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

<Steps>
  <Step title="Reporting API सक्षम करें और टोकन जनरेट करें">
    1. अपने KnowBe4 कंसोल में साइन इन करें।
    2. ऊपर दाएँ कोने में अपने खाते के नाम पर क्लिक करें और **Account Settings** चुनें।
    3. बाएँ नेविगेशन में **API** चुनें।
    4. यदि **Reporting API** पहले से सक्षम नहीं है, तो उसे सक्षम करें, फिर एक नया API टोकन जनरेट करें।

    यदि आपका कंसोल उद्देश्य पूछता है, तो टोकन के लिए एक वर्णनात्मक उद्देश्य दें (उदा., `Living Security Platform`)।

    <Warning>
      KnowBe4 API टोकन का मान जनरेट होने पर **केवल एक बार** प्रदर्शित करता है। इसे तुरंत कॉपी करें और किसी सुरक्षित स्थान (उदा., पासवर्ड वॉल्ट या सीक्रेट्स मैनेजर) में संग्रहीत करें। यदि आप इसे कॉपी किए बिना अन्य पृष्ठ पर चले जाते हैं, तो आपको नया टोकन जनरेट करना होगा।
    </Warning>

    <Note>
      Reporting API केवल-पठन (read-only) है। यह उपयोगकर्ताओं, प्रशिक्षण नामांकनों और फ़िशिंग सुरक्षा परीक्षण परिणामों को उपलब्ध कराता है — यही वह डेटा है जिसे Living Security स्कोरिंग और रिपोर्टिंग के लिए ग्रहण करता है। किसी लेखन (write) पहुँच की आवश्यकता नहीं है।
    </Note>
  </Step>

  <Step title="Living Security के egress IP को Allowed IP Addresses सूची में जोड़ें">
    KnowBe4 आपको Reporting API पहुँच को स्रोत IP पतों के एक विशिष्ट समूह तक सीमित करने की सुविधा देता है। यह सेटिंग टोकन वाले स्थान पर ही मौजूद होती है:

    1. अपने KnowBe4 कंसोल में **Account Settings → API → Allowed IP Addresses** पर जाएँ।
    2. प्रत्येक [Living Security egress IP पता](/hi/integrations/managing/egress-ip-addresses) को अनुमति सूची (allowlist) में जोड़ें। यही चार पते प्रत्येक रीजन में लागू होते हैं।

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **यदि Allowed IP Addresses सूची कॉन्फ़िगर की गई है, तो उसे नेटवर्क स्तर पर लागू किया जाता है।** कनेक्शन डायलॉग प्रमाणीकरण के समय सफल होगा, लेकिन Living Security के egress IP को अनुमति सूची में जोड़े जाने तक डेटा सिंक विफल होंगे (नेटवर्क स्तर पर अवरुद्ध होकर, जो आमतौर पर `403` के रूप में दिखाई देता है)। यदि आप इस सूची में कोई भी पता जोड़ते हैं, तो आपको Living Security की रेंज भी जोड़नी होंगी, अन्यथा आपका टोकन मान्य होने पर भी हमारे अनुरोध अस्वीकार कर दिए जाएँगे।
    </Warning>

    <Note>
      इंफ्रास्ट्रक्चर अपडेट होने पर Living Security के egress IP पते बदल सकते हैं, हालाँकि हम ऐसे बदलाव बहुत कम करते हैं। यदि पहले काम कर रहे डेटा सिंक विफल होने लगें, तो [Configuring Integration Egress IP Addresses](/hi/integrations/managing/egress-ip-addresses) देखें और सत्यापित करें कि Allowed IP Addresses सूची उससे मेल खाती है।
    </Note>
  </Step>

  <Step title="अपना KnowBe4 server region पहचानें">
    KnowBe4 Reporting API को रीजन-विशिष्ट होस्ट से उपलब्ध कराता है। आप होस्टनाम टाइप करने के बजाय कनेक्शन डायलॉग में अपना रीजन चुनते हैं:

    | रीजन | Reporting API होस्ट |
    | - | - |
    | संयुक्त राज्य अमेरिका | `us.api.knowbe4.com` |
    | यूरोप | `eu.api.knowbe4.com` |
    | कनाडा | `ca.api.knowbe4.com` |
    | यूनाइटेड किंगडम | `uk.api.knowbe4.com` |
    | जर्मनी | `de.api.knowbe4.com` |

    यदि आप सुनिश्चित नहीं हैं कि आपका खाता किस रीजन का उपयोग करता है, तो अपने KnowBe4 कंसोल URL का डोमेन देखें या अपने KnowBe4 व्यवस्थापक से संपर्क करें।

    <Note>
      ये पाँच रीजन ही ऐसे हैं जिन तक Living Security पहुँच सकता है। यदि आपका KnowBe4 खाता किसी अन्य सर्वर पर है (उदाहरण के लिए US Government इंस्टेंस), तो कनेक्शन शुरू करने से पहले Living Security सहायता से संपर्क करें।
    </Note>
  </Step>
</Steps>

***

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

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

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | फ़ील्ड | मान |
    | - | - |
    | **API key** | भाग A, चरण 1 का Reporting API टोकन |
    | **Reporting API server region** | भाग A, चरण 3 का रीजन (उदा., United States) |
  </ConnectInPlatform>
</Steps>

अब आप KnowBe4 से कनेक्ट हो गए हैं।

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API टोकन अमान्य है या समाप्त हो चुका है। सत्यापित करें कि टोकन सही है और उसे **Account Settings → API** में पुनः जनरेट नहीं किया गया है।
  </Accordion>

  <Accordion title="403 Forbidden">
    या तो टोकन के पास Reporting API की पहुँच नहीं है, या अनुरोध का IP Allowed IP Addresses सूची में नहीं है। सत्यापित करें कि Reporting API सक्षम है और सभी चारों [Living Security egress IP पते](/hi/integrations/managing/egress-ip-addresses) अनुमति सूची में हैं।
  </Accordion>

  <Accordion title="Empty results (200 OK but no data)">
    संभव है कि Reporting API के पास अभी लौटाने के लिए डेटा न हो, या टोकन के खाते को उन उपयोगकर्ताओं और कैंपेन की दृश्यता प्राप्त न हो जिन्हें Living Security ग्रहण करता है। सत्यापित करें कि टोकन Account Admin द्वारा जनरेट किया गया था।
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.