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

# Thiết lập tích hợp Google Workspace

> Kết nối Google Workspace với Living Security để thu thập hoạt động về vòng đời người dùng, đăng nhập, MFA, quản trị và bảo vệ dữ liệu.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Tài nguyên liên quan</h2>
    <ul>
      <li>
        <a href="/vi/signals/data-sources">Tìm hiểu cách dữ liệu tích hợp trở thành các tín hiệu Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Khám phá các Tích hợp của Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Mở Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Yêu cầu bản demo của Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Nhập thông tin xác thực vào Living Security Platform">
    <p>
      Bước này do người có quyền truy cập Living Security thực hiện — chủ sở hữu chương trình, hoặc quản trị viên hệ thống nếu người đó đã được mời (thiết lập được ủy quyền).
    </p>
    <ol>
      <li>
        Truy cập <strong>Cài đặt → Tích hợp → Danh mục</strong>, tìm thẻ{' '}
        <strong>{tile}</strong>, rồi nhấp vào <strong>Kết nối</strong>.
      </li>
      <li>
        Điền các trường bên dưới, sau đó nhấp vào <strong>Kết nối</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Hướng dẫn này dành cho quản trị viên {system} của Quý vị.</strong> Hướng dẫn đề cập đến việc tạo thông tin xác thực API trong {system}, thao tác này yêu cầu quyền quản trị đối với {system} — chứ không phải đối với
      Living Security Platform.
    </p>
    <p>
      Nếu Quý vị là <strong>chủ sở hữu chương trình</strong> của Living Security và không quản trị {system},
      vui lòng gửi trang này cho người đảm nhiệm vai trò đó. Người này sẽ hoàn thành Phần A và chuyển lại thông tin xác thực cho Quý vị
      (hoặc nhập trực tiếp nếu Quý vị đã mời họ vào nền tảng).
      {recommendDelegated && <>
          {' '}Do quá trình thiết lập tạo ra tài liệu khóa nhạy cảm, chúng tôi khuyến nghị sử dụng hướng{' '}
          <strong>thiết lập ủy quyền</strong> để khóa bí mật không bao giờ được gửi lại cho Quý vị.
        </>}
    </p>
  </Note>;

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

## Tích hợp này đóng góp dữ liệu gì

Google Workspace có thể đóng góp dữ liệu hoạt động đã được chuẩn hóa về vòng đời người dùng, đăng nhập, MFA, quản trị và bảo vệ dữ liệu. Các ví dụ đã được rà soát bao gồm:

* `account.compromised` — tài khoản bị gắn cờ là đã bị xâm phạm
* `data.sensitive.downloaded` — tải xuống dữ liệu nhạy cảm
* `auth.login.unusual` — đăng nhập từ các ngữ cảnh bất thường

Xem [cách dữ liệu tích hợp trở thành tín hiệu](/vi/signals/data-sources).

## Living Security cần những gì

| Thông tin xác thực | Mô tả |
| - | - |
| **Khóa tài khoản dịch vụ** | Khóa JSON của một tài khoản dịch vụ Google Cloud chuyên dụng. |
| **Quản trị viên được ủy quyền** | Email của một quản trị viên Google Workspace mà tài khoản dịch vụ có thể đóng vai (impersonate). |

Hãy bật các API của Admin SDK và chỉ cấp quyền cho những phạm vi (scope) mà kết nối đọc:

* `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`

## Thiết lập

<Steps>
  <Step title="Tạo tài khoản dịch vụ Google Cloud">
    Tạo một tài khoản dịch vụ chuyên dụng, bật tính năng ủy quyền trên toàn miền (domain-wide delegation) và tải xuống khóa JSON của tài khoản đó. Hãy lưu trữ khóa an toàn.
  </Step>

  <Step title="Cấp quyền ủy quyền trên toàn miền">
    Trong Google Admin Console, mở **Security → Access and data control → API controls → Manage Domain Wide Delegation**. Thêm mã định danh khách hàng (client ID) dạng số của tài khoản dịch vụ và ba phạm vi chỉ đọc nêu trên.
  </Step>

  <Step title="Chọn quản trị viên được ủy quyền">
    Chọn một quản trị viên Workspace đang hoạt động có quyền đọc thư mục, các phân công vai trò và báo cáo kiểm tra (audit). Living Security chỉ sử dụng danh tính này cho các thao tác đọc API được ủy quyền.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    Tải lên hoặc dán thông tin xác thực của tài khoản dịch vụ theo hướng dẫn, rồi nhập email của quản trị viên được ủy quyền.
  </ConnectInPlatform>
</Steps>

## Xác minh và khắc phục sự cố

Hãy xác minh rằng kết nối có thể đọc một người dùng trong thư mục và hoạt động đăng nhập gần đây. Google lưu ý rằng các quyền ủy quyền trên toàn miền mới cấp có thể cần một khoảng thời gian để có hiệu lực.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    Hãy xác nhận rằng ủy quyền trên toàn miền sử dụng client ID dạng số của tài khoản dịch vụ, không phải địa chỉ email của tài khoản đó, và cả ba phạm vi khớp chính xác.
  </Accordion>

  <Accordion title="Thư mục hoạt động nhưng thiếu các phân công vai trò">
    Thêm `admin.directory.rolemanagement.readonly` vào mục ủy quyền và xác nhận rằng quản trị viên được ủy quyền có thể xem các phân công vai trò.
  </Accordion>

  <Accordion title="Báo cáo trống">
    Hãy xác nhận rằng Admin Reports API đã được bật và quản trị viên được ủy quyền có thể truy cập báo cáo kiểm tra (audit) của tenant Workspace.
  </Accordion>
</AccordionGroup>

Để biết chi tiết từ phía nhà cung cấp, hãy xem [hướng dẫn ủy quyền trên toàn miền của 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.