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

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

> यूज़र लाइफसाइकल, साइन-इन, MFA, प्रशासनिक और डेटा-सुरक्षा गतिविधि के लिए Google Workspace को Living Security से कनेक्ट करें।

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="Google Workspace" recommendDelegated={true} />

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

Google Workspace सामान्यीकृत (normalized) यूज़र लाइफसाइकल, साइन-इन, MFA, प्रशासनिक और डेटा-सुरक्षा गतिविधि उपलब्ध करा सकता है। समीक्षा किए गए उदाहरणों में शामिल हैं:

* `account.compromised` — खाते को समझौता-ग्रस्त (compromised) के रूप में चिह्नित किया गया
* `data.sensitive.downloaded` — संवेदनशील डेटा डाउनलोड करता है
* `auth.login.unusual` — असामान्य संदर्भों से साइन इन करता है

देखें [इंटीग्रेशन डेटा Signals में कैसे बदलता है](/hi/signals/data-sources)।

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

| क्रेडेंशियल | विवरण |
| - | - |
| **Service-account key** | एक समर्पित Google Cloud सर्विस अकाउंट के लिए JSON कुंजी। |
| **Delegated administrator** | एक Google Workspace एडमिनिस्ट्रेटर का ईमेल, जिसकी ओर से सर्विस अकाउंट कार्य (impersonate) कर सकता है। |

Admin SDK API सक्षम करें और केवल उन्हीं स्कोप को अधिकृत करें जिन्हें यह कनेक्शन पढ़ता है:

* `https://www.googleapis.com/auth/admin.reports.audit.readonly`
* `https://www.googleapis.com/auth/admin.directory.user.readonly`
* `https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly`

## सेटअप

<Steps>
  <Step title="Google Cloud सर्विस अकाउंट बनाएँ">
    एक समर्पित सर्विस अकाउंट बनाएँ, डोमेन-वाइड डेलीगेशन सक्षम करें और उसकी JSON कुंजी डाउनलोड करें। कुंजी को सुरक्षित रूप से संग्रहीत करें।
  </Step>

  <Step title="डोमेन-वाइड डेलीगेशन अधिकृत करें">
    Google Admin Console में **Security → Access and data control → API controls → Manage Domain Wide Delegation** खोलें। सर्विस अकाउंट की न्यूमेरिक क्लाइंट ID और ऊपर दिए गए तीनों रीड-ओनली स्कोप जोड़ें।
  </Step>

  <Step title="Delegated administrator चुनें">
    एक सक्रिय Workspace एडमिनिस्ट्रेटर चुनें जो डायरेक्टरी, रोल असाइनमेंट और ऑडिट रिपोर्ट पढ़ सकता हो। Living Security इस पहचान का उपयोग केवल डेलीगेटेड API रीड के लिए करता है।
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    संकेत के अनुसार सर्विस-अकाउंट क्रेडेंशियल अपलोड करें या पेस्ट करें और डेलीगेटेड एडमिनिस्ट्रेटर का ईमेल दर्ज करें।
  </ConnectInPlatform>
</Steps>

## सत्यापन और समस्या-निवारण

सत्यापित करें कि कनेक्शन एक डायरेक्टरी यूज़र और हाल की लॉगिन गतिविधि पढ़ सकता है। Google के अनुसार, नए डोमेन-वाइड डेलीगेशन ग्रांट के प्रभावी होने में समय लग सकता है।

<AccordionGroup>
  <Accordion title="unauthorized_client">
    पुष्टि करें कि डोमेन-वाइड डेलीगेशन में सर्विस अकाउंट की न्यूमेरिक क्लाइंट ID का उपयोग किया गया है, उसके ईमेल पते का नहीं, और तीनों स्कोप ठीक-ठीक मेल खाते हैं।
  </Accordion>

  <Accordion title="डायरेक्टरी काम करती है, लेकिन रोल असाइनमेंट गायब हैं">
    डेलीगेशन एंट्री में `admin.directory.rolemanagement.readonly` जोड़ें और पुष्टि करें कि डेलीगेटेड एडमिनिस्ट्रेटर रोल असाइनमेंट देख सकता है।
  </Accordion>

  <Accordion title="रिपोर्ट खाली हैं">
    पुष्टि करें कि Admin Reports API सक्षम है और डेलीगेटेड एडमिनिस्ट्रेटर Workspace टेनेंट की ऑडिट रिपोर्टिंग तक पहुँच सकता है।
  </Accordion>
</AccordionGroup>

वेंडर-पक्ष के विवरण के लिए [Google की डोमेन-वाइड डेलीगेशन गाइड](https://developers.google.com/identity/protocols/oauth2/service-account#delegatingauthority) देखें।

<PublicIntegrationNextSteps />


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