> ## 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="/ru/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` — вход в систему из необычных условий

См. раздел [как данные интеграции превращаются в Сигналы](/ru/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">
    Создайте выделенную учётную запись службы, включите делегирование полномочий на уровне домена и скачайте её 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.