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

# Integration सेट अप करें

> Provider क्रेडेंशियल तैयार करें, समर्थित सिस्टम को कनेक्ट करें, उसकी डेटा स्ट्रीम सक्षम करें और पहले सफल सिंक की पुष्टि करें।

यह गाइड **Settings → Integrations → Catalog** के अंतर्गत सूचीबद्ध Integrations के लिए सामान्य सेटअप प्रक्रिया की जानकारी देती है। Provider-विशिष्ट फ़ील्ड, अनुमतियाँ और प्रमाणीकरण चरण उस Provider के Catalog कार्ड पर लिंक की गई सेटअप गाइड में दिए गए हैं।

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

| भूमिका | ज़िम्मेदारी |
| - | - |
| [**Program Owner**](/hi/reference/glossary#program-owner) | स्रोत का चयन करता है, उसे Living Security में कनेक्ट करता है, स्ट्रीम सक्षम करता है और परिणाम सत्यापित करता है |
| [**System Administrator**](/hi/reference/glossary#system-administrator) | स्रोत सिस्टम में क्रेडेंशियल और स्कोप बनाता है या उन्हें स्वीकृत करता है |

ये भूमिकाएँ एक ही व्यक्ति के पास हो सकती हैं। Living Security में क्रेडेंशियल दर्ज करने वाले व्यक्ति के पास ऐसी administrator भूमिका होनी चाहिए जो integration प्रबंधन की अनुमति देती हो; केवल इस धारणा पर कि सीमित स्कोप वाली सेटअप भूमिका उपलब्ध है, किसी स्रोत-सिस्टम administrator को Living Security में आमंत्रित न करें।

शुरू करने से पहले:

* वह Living Security organization और environment चुनें जहाँ कनेक्शन होना चाहिए।
* Provider की Catalog गाइड खोलें और उसके लिए आवश्यक स्कोप, redirect URL और allowlist आवश्यकताएँ एकत्र करें।
* यदि क्रेडेंशियल बनाने और दर्ज करने वाले लोग अलग-अलग हैं, तो अपने संगठन की स्वीकृत गोपनीय-जानकारी साझा करने की प्रक्रिया का उपयोग करें।
* पासवर्ड, client secret, निजी कुंजियाँ या access-key मान कभी भी ईमेल या सपोर्ट टिकट के माध्यम से न भेजें।

## 1. Provider क्रेडेंशियल तैयार करें

**Settings → Integrations → Catalog** खोलें, Provider को ढूँढें और क्रेडेंशियल बनाने से पहले उसकी सेटअप गाइड पढ़ें।

Provider प्रमाणीकरण में OAuth सहमति, API टोकन, client ID और secret, service account या Provider द्वारा समर्थित कोई अन्य विधि उपयोग की जा सकती है। केवल वही क्रेडेंशियल और स्कोप बनाएँ जो उस Provider की गाइड में बताए गए हैं।

<Warning>
  किसी अन्य Provider की अनुमतियाँ कॉपी न करें और “कभी काम आ जाए” सोचकर व्यापक
  write एक्सेस न दें। अनुमतियाँ कम होने पर सामान्यतः स्पष्ट 401 या 403 त्रुटि आती है,
  जिसे ठीक किया जा सकता है; आवश्यकता से अधिक अनुमतियाँ टाले जा सकने वाला जोखिम उत्पन्न करती हैं।
</Warning>

## 2. Provider को कनेक्ट करें

<Steps>
  <Step title="Catalog खोलें">
    **Settings → Integrations → Catalog** पर जाएँ और Provider का चयन करें।
  </Step>

  <Step title="कनेक्शन शुरू करें">
    **Connect** चुनें। OAuth प्रक्रिया पूरी करें या कनेक्शन डायलॉग में माँगे गए फ़ील्ड
    दर्ज करें। प्रत्येक मान कहाँ से प्राप्त होगा, यह Provider गाइड में बताया गया है।
  </Step>

  <Step title="प्रमाणीकरण पूरा करें">
    जहाँ लागू हो, Provider की सहमति स्क्रीन पर स्वीकृति दें। प्रमाणीकरण सफल होने के बाद, Living Security नया कनेक्शन **Connected** के अंतर्गत खोलता है या सूचीबद्ध करता है।
  </Step>
</Steps>

यदि Provider प्रमाणीकरण अस्वीकार कर देता है, तो आगे बढ़ने से पहले रुकें और क्रेडेंशियल, tenant, region, redirect URL या स्रोत-सिस्टम की अनुमतियाँ ठीक करें।

## 3. डेटा स्ट्रीम सक्षम करें

**Settings → Integrations → Connected** के अंतर्गत कनेक्शन खोलें। Living Security उस Provider के लिए उपलब्ध सिंक टेम्पलेट खोजता है और उन्हें स्ट्रीम के रूप में सूचीबद्ध करता है।

1. प्रत्येक स्ट्रीम का नाम और उद्देश्य देखें।
2. केवल वही स्ट्रीम सक्षम करें जिनकी आपके प्रोग्राम को आवश्यकता है।
3. असंबंधित स्ट्रीम को रोके (paused) रखें।
4. पहला रन अनुरोधित करने के लिए, उपलब्ध होने पर, **Sync Now** का उपयोग करें।

सभी Provider समान स्ट्रीम या शेड्यूल नियंत्रण प्रदान नहीं करते। किसी सार्वभौमिक आवृत्ति, स्कोप, फ़ील्ड-मैपिंग, ड्राफ़्ट या सक्रियण विज़ार्ड की अपेक्षा करने के बजाय कनेक्शन पर दिखाए गए नियंत्रणों का पालन करें।

## 4. पहले रन की पुष्टि करें

केवल कनेक्शन का प्रमाणीकरण यह सिद्ध नहीं करता कि डेटा प्रवाहित हो रहा है।

<Steps>
  <Step title="कनेक्शन की स्थिति जाँचें">
    पुष्टि करें कि कनेक्शन स्वस्थ है और पुनः प्राधिकरण का अनुरोध नहीं कर रहा है।
  </Step>

  <Step title="स्ट्रीम की स्थिति जाँचें">
    पुष्टि करें कि आवश्यक स्ट्रीम रुकी हुई नहीं, बल्कि सक्षम है।
  </Step>

  <Step title="नवीनतम रन का निरीक्षण करें">
    स्ट्रीम, कनेक्शन का सिंक लिंक या **Settings** → **Integrations** → **Syncs** खोलें। सफल अंतिम परिणाम की प्रतीक्षा करें और, उपलब्ध होने पर, Provider त्रुटियों तथा रिकॉर्ड संख्या की समीक्षा करें।
  </Step>

  <Step title="डाउनस्ट्रीम डेटा की पुष्टि करें">
    संबंधित Living Security सतह खोलें। Identity डेटा से Workforce में अपेक्षित लोग और identities बननी चाहिए; security-source डेटा उस सुविधा में दिखना चाहिए जिसका उल्लेख उस Provider के दस्तावेज़ में है।
  </Step>
</Steps>

ऑनबोर्डिंग के लिए, Journey Map के **Verify Identity Data Flowing** और **Verify Integration Data Flowing** कार्य ingest किए गए डेटा से पूर्ण होते हैं। उन सत्यापन परिणामों के स्थान पर सहेजे गए कनेक्शन को न मानें।

## Sync विवरण पृष्ठ

**Settings** → **Integrations** → **Syncs** से किसी भी सिंक को खोलकर उसका कॉन्फ़िगरेशन और रन इतिहास एक ही स्थान पर देखें।

विवरण पृष्ठ में यह दिखता है:

| अनुभाग | इसमें क्या शामिल है |
| - | - |
| **Header** | सिंक का नाम, स्थिति बैज और integration provider |
| **Statistics** | मॉडल, अंतिम सिंक, पूर्ण रन और कुल रिकॉर्ड |
| **Run history** | स्थिति, समय और रिकॉर्ड संख्या के साथ हाल के रन |
| **Actions** | **Refresh**, **Pause** / **Resume**, और **Sync Now** |

सिंक सक्रिय होने पर तुरंत रन शुरू करने के लिए **Sync Now** का उपयोग करें। रोके गए सिंक को नए निर्धारित या मैन्युअल रन शुरू होने से पहले फिर से शुरू (resume) करना आवश्यक है।

जब integration सक्रिय स्ट्रीम सूचीबद्ध करता है, तब आप किसी सिंक को उसके कनेक्शन विवरण पृष्ठ से भी खोल सकते हैं।

## कनेक्शन संचालन

कनेक्शन विवरण पृष्ठ उस integration द्वारा समर्थित संचालन प्रदर्शित करता है:

| संचालन | प्रभाव |
| - | - |
| **Sync Now** | चयनित स्ट्रीम के लिए तत्काल रन का अनुरोध करता है |
| **Pause stream** | कनेक्शन को बनाए रखते हुए उस स्ट्रीम के नए रन रोक देता है |
| **Pause connection** | कॉन्फ़िगरेशन हटाए बिना समर्थित कनेक्शन गतिविधि रोक देता है |
| **Resume** | रुकी हुई स्ट्रीम या कनेक्शन को पुनः आरंभ करता है |
| **Reauthorize** | क्रेडेंशियल या सहमति में परिवर्तन के बाद प्रमाणीकरण दोहराता है |
| **Remove** | पुष्टि के बाद कनेक्शन कॉन्फ़िगरेशन हटा देता है |

कनेक्शन हटाना उससे पहले से ingest किए गए डेटा को हटाने के समान नहीं है। यदि डेटा-प्रतिधारण व्यवहार आपके निर्णय को प्रभावित करता है, तो Provider गाइड देखें या Support से संपर्क करें।

## Custom Push Sources

जब कोई सिस्टम Catalog कनेक्टर के माध्यम से पोल किए जाने के बजाय Living Security को डेटा भेजता है, तब **Custom Push Source** का उपयोग करें।

1. **Catalog** के नीचे से स्रोत बनाएँ।
2. custom push क्षेत्र के अंतर्गत उसका विवरण पृष्ठ खोलें।
3. गंतव्य स्ट्रीम चुनें।
4. मैन्युअल बैच के लिए **Upload CSV** या स्वचालित प्रेषक के लिए **Push via API** का उपयोग करें।
5. भेजने के बाद फ़ाइल या payload का पूर्वावलोकन करें और स्रोत का रन इतिहास देखें।

endpoint, प्रमाणीकरण, payload, पुनः प्रयास और सत्यापन अनुबंध की पूर्ण जानकारी के लिए [Custom Push Source API](/hi/integrations/custom-push-source) देखें। इन विवरणों का अनुमान किसी पुरानी Unify integration गाइड से न लगाएँ।

स्रोत-विवरण अपलोडर 100 MB तक की स्रोत CSV फ़ाइल स्वीकार करता है। अपलोड करने से पहले, Dashboard उसे क्लाइंट-साइड पर अधिकतम 10 MB और 10,000 पंक्तियों वाले अनुरोधों में विभाजित करता है। यह स्रोत-विशिष्ट अपलोडर, identity और activity टेम्पलेट के लिए बने सामान्य **Integrations → Upload** पृष्ठ से अलग है।

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

| लक्षण | जाँचें |
| - | - |
| `401 Unauthorized` | क्रेडेंशियल मान, समाप्ति, निरस्तीकरण, Provider tenant और पुनः प्राधिकरण की स्थिति |
| `403 Forbidden` | आवश्यक Provider भूमिका, स्कोप, admin सहमति और स्रोत-सिस्टम की एक्सेस नीति |
| कनेक्शन तुरंत विफल हो जाता है | Redirect URL, region, स्रोत URL, नेटवर्क या IP allowlist आवश्यकताएँ |
| कनेक्शन स्वस्थ है लेकिन कोई रन नहीं होता | आवश्यक स्ट्रीम सक्षम है और Provider वह स्ट्रीम प्रदान करता है |
| सफल रन कोई रिकॉर्ड नहीं लौटाता | स्रोत खाता अपेक्षित जनसंख्या देख सकता है और Provider-साइड फ़िल्टर सही हैं |
| डेटा गलत व्यक्ति के अंतर्गत दिखता है | कनेक्ट किए गए स्रोतों में identity विशेषताएँ और aliases सुसंगत हैं |
| डेटा अपडेट होना बंद हो जाता है | स्ट्रीम या कनेक्शन रुका हुआ है, क्रेडेंशियल समाप्त हो गए हैं या नवीनतम रन विफल रहा है |

[Living Security Support](mailto:support@livingsecurity.com) से संपर्क करते समय organization, Provider, कनेक्शन का नाम, स्ट्रीम, नवीनतम रन का समय और दिखाई देने वाली त्रुटि शामिल करें। गोपनीय जानकारी (secrets) शामिल न करें।

## संबंधित

<CardGroup cols={2}>
  <Card title="Integrations का अवलोकन" icon="grid-2" href="/hi/integrations/overview">
    Connected, Catalog, Syncs, Actions और Upload के लिए संदर्भ।
  </Card>

  <Card title="डेटा मैपिंग" icon="arrows-left-right" href="/hi/integrations/managing/data-mapping">
    जहाँ उपलब्ध हो, समर्थित विशेषताओं और मैपिंग को समझें।
  </Card>

  <Card title="Integration जीवनचक्र" icon="route" href="/hi/integrations/managing/lifecycle">
    पुनः प्राधिकरण या हटाने तक किसी मौजूदा integration का संचालन करें।
  </Card>

  <Card title="Administrator ऑनबोर्डिंग" icon="circle-check" href="/hi/getting-started/onboarding">
    Identity और security-data सत्यापन कार्य पूरे करें।
  </Card>
</CardGroup>


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