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

> חברו את Google Workspace אל Living Security לקבלת נתוני פעילות של מחזור חיי משתמשים, כניסה למערכת, MFA, פעולות ניהול והגנה על נתונים.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>משאבים קשורים</h2>
    <ul>
      <li>
        <a href="/he/signals/data-sources">כך הופכים נתוני אינטגרציה לאותות של ניהול סיכוני גורם אנוש</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">גלו את האינטגרציות של Living Security</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>הגדרות → שילובי → קטלוג</strong>, אתרו את האריח{' '}
        <strong>{tile}</strong> ולחצו על <strong>חבר</strong>.
      </li>
      <li>
        מלאו את השדות שלהלן, ולאחר מכן לחצו על <strong>חבר</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>מדריך זה מיועד למנהל/ת {system} שלכם.</strong> הוא עוסק ביצירת אישורי API
      בתוך {system}, פעולה הדורשת הרשאות ניהול ב-{system} — ולא ב-Living Security Platform.
    </p>
    <p>
      אם אתם <strong>בעלי התוכנית</strong> של Living Security ואינכם מנהלים את {system},
      העבירו דף זה לאיש או אשת הקשר המנהלים אותה. הם ישלימו את חלק A ויעבירו אליכם את האישורים
      (או שיזינו אותם ישירות אם הוזמנו לפלטפורמה).
      {recommendDelegated && <>
          {' '}מאחר שהתקנה זו מפיקה חומרי מפתח רגישים, אנו ממליצים על מסלול{' '}
          <strong>ההתקנה המואצלת</strong>, כך שהסוד לעולם לא יישלח אליכם.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Google Workspace" recommendDelegated={true} />

## מה האינטגרציה הזו מספקת

Google Workspace יכול לספק נתוני פעילות מנורמלים של מחזור חיי משתמשים, כניסה למערכת, MFA, פעולות ניהול והגנה על נתונים. הדוגמאות שנבדקו כוללות:

* `account.compromised` — חשבון שסומן כחשבון שנפרץ
* `data.sensitive.downloaded` — הורדת נתונים רגישים
* `auth.login.unusual` — כניסה למערכת מהקשרים חריגים

ראו [כיצד נתוני אינטגרציה הופכים לאותות](/he/signals/data-sources).

## מה Living Security דורשת

| פרטי גישה | תיאור |
| - | - |
| **מפתח חשבון שירות** | מפתח JSON עבור חשבון שירות ייעודי ב-Google Cloud. |
| **מנהל מורשה** | כתובת דוא"ל של מנהל Google Workspace שחשבון השירות יכול לפעול בשמו. |

הפעילו את ממשקי ה-API של Admin SDK ואשרו רק את ההיקפים שהחיבור קורא:

* `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">
    צרו חשבון שירות ייעודי, הפעילו האצלת סמכויות ברמת הדומיין (domain-wide delegation) והורידו את מפתח ה-JSON שלו. שמרו את המפתח במקום מאובטח.
  </Step>

  <Step title="אישור האצלת סמכויות ברמת הדומיין">
    ב-Google Admin Console, פתחו את **Security → Access and data control → API controls → Manage Domain Wide Delegation**. הוסיפו את מזהה הלקוח המספרי של חשבון השירות ואת שלושת ההיקפים לקריאה בלבד שצוינו לעיל.
  </Step>

  <Step title="בחירת המנהל המורשה">
    בחרו מנהל Workspace פעיל שיכול לקרוא את הספרייה, את הקצאות התפקידים ואת דוחות הביקורת. Living Security משתמשת בזהות זו אך ורק לקריאות API מואצלות.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    העלו או הדביקו את פרטי הגישה של חשבון השירות בהתאם להנחיות, והזינו את כתובת הדוא"ל של המנהל המורשה.
  </ConnectInPlatform>
</Steps>

## אימות ופתרון בעיות

ודאו שהחיבור יכול לקרוא משתמש אחד בספרייה ואת פעילות הכניסה האחרונה למערכת. Google מציינת כי הענקות חדשות של האצלת סמכויות ברמת הדומיין עשויות לקחת זמן עד שהן מופצות.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    ודאו שהאצלת הסמכויות ברמת הדומיין משתמשת במזהה הלקוח המספרי של חשבון השירות ולא בכתובת הדוא"ל שלו, ושכל שלושת ההיקפים תואמים במדויק.
  </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.