> ## 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.

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

> अपने Workforce के लिए सुरक्षा जागरूकता Training के परिणाम और Phishing simulation के आउटकम आयात करने हेतु NINJIO को 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 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="NINJIO" />

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

NINJIO, Workforce, Training और Phishing simulation से संबंधित आउटकम प्रदान कर सकता है। समीक्षा किए गए उदाहरणों में शामिल हैं:

* `training.assigned` — को सुरक्षा Training असाइन की गई है
* `training.completed` — सुरक्षा Training पूर्ण करता है
* `training.passed` — सुरक्षा Training के मूल्यांकन उत्तीर्ण करता है
* `phishing.simulation.clicked` — किसी सिमुलेशन पर क्लिक किया और रिपोर्ट नहीं किया
* `phishing.simulation.reported` — Phishing simulation की रिपोर्ट करता है

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

## Living Security को क्या आवश्यक है

| क्रेडेंशियल | विवरण |
| - | - |
| **API key** | कर्मचारी, Training और फ़िशिंग एक्सेस पॉइंट के लिए रीड एक्सेस वाली NINJIO API key। Living Security इसे प्रत्येक अनुरोध के साथ भेजता है। |

**स्कोप:** NINJIO प्रत्येक API key को प्रति *एक्सेस पॉइंट* स्कोप करता है, जिसमें रीड और राइट अनुमतियाँ अलग-अलग होती हैं। Living Security को तीन एक्सेस पॉइंट पर **read** अनुमति चाहिए: कर्मचारी, Training और फ़िशिंग। राइट एक्सेस की आवश्यकता नहीं है और उसे प्रदान नहीं किया जाना चाहिए।

**आवश्यक भूमिका:** आपके NINJIO खाते पर **Administrator**। केवल एडमिनिस्ट्रेटर ही Integration क्षेत्र तक पहुँच सकते हैं, जहाँ keys बनाई जाती हैं।

<Warning>
  **NINJIO नई key केवल एक बार दिखाता है, जिस समय वह बनाई जाती है।** किसी अन्य पेज पर जाने से पहले उसे सीधे Living Security Platform में या पासवर्ड वॉल्ट में कॉपी कर लें। जो key कॉपी नहीं की गई, उसे पुनः प्राप्त नहीं किया जा सकता — आपको नई key जनरेट करनी होगी।
</Warning>

### Living Security क्या प्राप्त करता है

| डेटा | विवरण |
| - | - |
| **Learners** | आपकी NINJIO कर्मचारी डायरेक्टरी: नाम, ईमेल, विभाग, पदनाम, मैनेजर, देश, ब्रांच और सक्रिय स्थिति। |
| **Training** | प्रत्येक Training किसे असाइन की गई और किसने उसे पूर्ण किया — पूर्णता की तिथि, परीक्षा स्कोर और एंगेजमेंट स्कोर सहित। |
| **Phishing** | किसने सिमुलेटेड फ़िशिंग ईमेल के साथ इंटरैक्ट किया और किसने उसकी रिपोर्ट की, घटना के समय सहित। |

<Note>
  **Learner के फ़ोन नंबर संग्रहीत नहीं किए जाते।** NINJIO अपने कर्मचारी रिकॉर्ड में फ़ोन नंबर लौटाता है। Living Security कुछ भी संग्रहीत करने से पहले उसे हटा देता है, क्योंकि Living Security की कोई भी सुविधा उसका उपयोग नहीं करती।
</Note>

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

* API एक्सेस वाला NINJIO खाता।
* [admin.goninjio.com](https://admin.goninjio.com/) पर एडमिनिस्ट्रेटर एक्सेस।
* NINJIO में Learner के ईमेल पते, जो आपके अन्य कनेक्टेड सिस्टम में उपयोग किए जाने वाले पतों से मेल खाते हों। Living Security ईमेल के माध्यम से ही किसी NINJIO Learner को व्यक्ति से मिलाता है।

***

## भाग A — NINJIO में

*ये चरण आपका NINJIO एडमिनिस्ट्रेटर पूरे करता है।*

<Steps>
  <Step title="Integration क्षेत्र खोलें">
    1. एडमिनिस्ट्रेटर के रूप में [admin.goninjio.com](https://admin.goninjio.com/) में साइन इन करें।
    2. स्क्रीन के ऊपरी दाएँ कोने में **Integration** चुनें।
  </Step>

  <Step title="API key बनाएँ">
    1. **New API Key** चुनें।
    2. key को ऐसा नाम दें जिसे आप बाद में पहचान सकें — उदाहरण के लिए `Living Security`।
    3. **employee**, **training** और **phishing** एक्सेस पॉइंट के लिए **read** एक्सेस प्रदान करें।
    4. राइट एक्सेस को अचयनित रहने दें। Living Security NINJIO से केवल डेटा पढ़ता है।
    5. **Generate Key** चुनें।

    <Warning>
      key को अभी कॉपी कर लें। NINJIO उसे केवल एक बार प्रदर्शित करता है और दोबारा नहीं दिखा सकता।
    </Warning>
  </Step>
</Steps>

***

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

*यह चरण प्रोग्राम ओनर पूरा करता है, या प्रतिनिधित्व आधारित सेटअप होने पर सिस्टम एडमिन।*

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | फ़ील्ड | मान |
    | - | - |
    | **API key** | वह key जो आपने भाग A में जनरेट की थी |
  </ConnectInPlatform>
</Steps>

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

***

## डेटा कितनी बार प्राप्त किया जाता है

| डेटा | शेड्यूल |
| - | - |
| Learners | प्रतिदिन |
| Training परिणाम | प्रत्येक 6 घंटे में |
| Phishing परिणाम | प्रत्येक 6 घंटे में |

पहली बार कनेक्ट होने पर, Living Security पिछले 12 महीनों की Training पूर्णताएँ प्राप्त करता है, और उसके बाद क्रमिक रूप से अद्यतन रखता है। Phishing simulation को प्रत्येक बार एक ही बार पढ़ा जाता है और समाप्त होने के बाद दो सप्ताह तक पुनः जाँचा जाता है, ताकि देर से हुए क्लिक और देर से की गई रिपोर्ट भी दर्ज हो सकें।

<Note>
  बड़े NINJIO खाते पर पहली बार कनेक्ट करने पर सारा डेटा पढ़ने में कई निर्धारित रन लग सकते हैं। प्रत्येक रन जितना संभव हो उतना पढ़ता है और अगला रन वहीं से आगे बढ़ता है जहाँ पिछला रुका था, इसलिए संख्याएँ एक साथ दिखने के बजाय पहले एक-दो दिनों में धीरे-धीरे बढ़ती हैं।
</Note>

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API key गलत या अधूरी है। सबसे आम कारण आंशिक रूप से कॉपी की गई key है — NINJIO उसे केवल एक बार दिखाता है, इसलिए अधूरा पेस्ट हो जाना आसान है और बाद में उसे पहचानना असंभव। NINJIO में नई key जनरेट करें और उसी से दोबारा कनेक्ट करें।
  </Accordion>

  <Accordion title="403 Forbidden">
    यह क्रेडेंशियल की समस्या **नहीं** है। key प्रमाणित हो गई, लेकिन उसके लिए आवश्यक एक्सेस पॉइंट में से किसी एक को read अनुमति नहीं दी गई थी।

    वही key दोबारा पेस्ट करने से कोई लाभ नहीं होगा। NINJIO में ऐसी key बनाएँ जिसके पास तीनों एक्सेस पॉइंट — employee, training और phishing — पर **read** एक्सेस हो, और उसी से दोबारा कनेक्ट करें।
  </Accordion>

  <Accordion title="सफलतापूर्वक कनेक्ट हुआ लेकिन Training डेटा नहीं है">
    NINJIO में जाँचें कि कम से कम एक Training कैंपेन **active** है और उससे एक सिमुलेशन जुड़ा है। बिना सिमुलेशन वाला कैंपेन निष्क्रिय रहता है और कुछ भी प्रदान नहीं करता, इसलिए प्राप्त करने के लिए कोई परिणाम नहीं होते।

    यदि कैंपेन सक्रिय हैं, तो पुष्टि करें कि उनमें शामिल Learners के NINJIO रिकॉर्ड पर ईमेल पते हैं। जिस Learner का ईमेल पता नहीं है, उसे किसी व्यक्ति से मिलाया नहीं जा सकता और उसे छोड़ दिया जाता है।
  </Accordion>

  <Accordion title="Training असाइन दिखती है लेकिन कभी पूर्ण नहीं होती">
    जिस Training को Learner ने पूरा नहीं किया है, उसके लिए यही अपेक्षित प्रदर्शन है। NINJIO सिमुलेशन शुरू होने पर Living Security असाइनमेंट दर्ज करता है, और जब NINJIO पूर्णता की तिथि रिपोर्ट करता है तब पूर्णता को अलग से दर्ज करता है।
  </Accordion>

  <Accordion title="कुछ Learners अनुपस्थित हैं">
    Living Security किसी NINJIO Learner को **ईमेल पते** के आधार पर व्यक्ति से मिलाता है। जिस Learner का NINJIO ईमेल आपकी डायरेक्टरी में मौजूद पते से भिन्न है — जैसे व्यक्तिगत पता, पुराना डोमेन या टाइपो — वह मेल नहीं खाएगा।

    NINJIO में पता सही करें, और अगली निर्धारित पुनःप्राप्ति में वह मेल खा जाएगा।
  </Accordion>

  <Accordion title="पुराने सिमुलेशन के लिए Phishing परिणाम अनुपस्थित हैं">
    Living Security किसी Phishing simulation को समाप्त होने के बाद दो सप्ताह तक पुनः जाँचता है, फिर रुक जाता है। उस अवधि के बाद NINJIO द्वारा दर्ज किए गए परिणाम प्राप्त नहीं किए जाते। यदि आपको किसी पुराने सिमुलेशन को दोबारा पढ़वाना हो तो सपोर्ट से संपर्क करें।
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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