> ## 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="/uk/signals/data-sources">Дізнайтеся, як дані інтеграцій перетворюються на сигнали Human Risk Management</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>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> Він описує створення облікових даних 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` — входи в систему з незвичних контекстів

Див. [як дані інтеграції перетворюються на Signals](/uk/signals/data-sources).

## Що потрібно для Living Security

| Облікові дані | Опис |
| - | - |
| **Service-account key** | JSON-ключ для окремого службового облікового запису Google Cloud. |
| **Delegated administrator** | Адреса електронної пошти адміністратора Google Workspace, від імені якого може діяти службовий обліковий запис. |

Увімкніть API Admin SDK і надайте дозвіл лише на ті області доступу (scopes), які підключення використовує для читання:

* `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 відкрийте **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.