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

> Kết nối Abnormal Security để nhập dữ liệu về mối đe dọa qua email và chiến dịch lừa đảo (phishing).

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 EgressIpSafelist = ({system}) => <Note>
    <strong>Hãy thêm cả bốn địa chỉ IP egress đồng bộ của Living Security</strong> vào danh sách cho phép trong{' '}
    {system}. Nhập từng địa chỉ dưới dạng một máy chủ đơn lẻ với <code>/32</code> nếu {system} yêu cầu ký hiệu CIDR:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    Lưu lượng có thể xuất phát từ bất kỳ địa chỉ nào trong bốn địa chỉ này, vì vậy nếu chỉ đưa một số địa chỉ vào danh sách cho phép, quá trình đồng bộ sẽ thỉnh thoảng bị lỗi. Bốn địa chỉ này giống nhau ở mọi khu vực của Living Security. Xem{' '}
    <a href="/vi/integrations/managing/egress-ip-addresses">
      Cấu hình địa chỉ IP egress của Tích hợp
    </a>{' '}
    để biết danh sách đầy đủ, chính sách thay đổi và cách khắc phục sự cố.
  </Note>;

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="Abnormal Security" />

## Tích hợp này đóng góp những gì

Abnormal Security có thể cung cấp dữ liệu hoạt động đã được chuẩn hóa về mối đe dọa qua email, việc chuyển phát, việc chặn và việc nhân viên báo cáo. Các ví dụ đã được xem xét bao gồm:

* `phishing.real.blocked` — email lừa đảo (phishing) thực sự bị chặn trước khi được chuyển phát
* `phishing.real.delivered` — email lừa đảo (phishing) thực sự đã được chuyển vào hộp thư đến
* `phishing.real.reported` — báo cáo các email lừa đảo (phishing) thực sự

Các ví dụ này cho thấy những loại hoạt động đã được chuẩn hóa mà Living Security có thể sử dụ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 gì

| Thông tin xác thực | Mô tả |
| - | - |
| **Khóa API** | Mã thông báo bearer của REST API được tạo từ Abnormal Portal |
| **Máy chủ API theo khu vực** | Tên máy chủ của môi trường Abnormal Security của quý vị |

**Phạm vi (Scopes):** Custom Access với quyền **Đọc** đối với `Abuse Campaigns (AI Security Mailbox)` và `Threats`

**Vai trò bắt buộc:** **Security Admin** hoặc **Super Admin** trong Abnormal Security

### Điều kiện tiên quyết

* Quý vị phải có quyền truy cập **Security Admin** hoặc **Super Admin** trong Abnormal Security để tạo và quản lý mã thông báo API.

***

## Phần A — Trong Abnormal Security

*Quản trị viên Abnormal Security của quý vị thực hiện các bước sau.*

<Steps>
  <Step title="Điều hướng đến API Token Management">
    1. Đăng nhập vào cổng Abnormal Security của quý vị.
    2. Trong thanh điều hướng bên trái, nhấp vào **Cài đặt**, sau đó chọn **Tích hợp**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/settings-integrations.webp?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=7f5d7a616acdcf72a9048f16c6706b5e" alt="Menu Cài đặt của Abnormal Security hiển thị tùy chọn Tích hợp" width="1999" height="1680" data-path="integrations/images/abnormal-security/settings-integrations.webp" />

    3. Cuộn xuống phần **API Token Management** ở cuối trang Tích hợp.
    4. Nhấp vào **+ Create New Token**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/api-token-management.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=13cfdfb7ced9b3f3fca67c781ee7e844" alt="Phần API Token Management với nút Create New Token" width="1239" height="1151" data-path="integrations/images/abnormal-security/api-token-management.avif" />
  </Step>

  <Step title="Chọn loại tích hợp">
    Chọn **REST API** làm loại tích hợp, sau đó nhấp vào **Tiếp theo**.
  </Step>

  <Step title="Chọn phạm vi mã thông báo">
    Chọn phạm vi mã thông báo, sau đó nhấp vào **Tiếp theo**:

    * **Khách hàng (Tất cả tenant hiện tại và tương lai)** — Sử dụng tùy chọn này nếu tài khoản Abnormal của quý vị quản lý nhiều tenant. Mã thông báo này tự động bao gồm tất cả tenant hiện tại và tương lai.
    * **Tenant (Một tenant duy nhất)** — Sử dụng tùy chọn này để giới hạn mã thông báo cho một tenant cụ thể.

    Đối với hầu hết các tổ chức chỉ có một tenant Abnormal, cả hai tùy chọn đều phù hợp. Nếu không chắc chắn, hãy chọn **Khách hàng**.
  </Step>

  <Step title="Cấp quyền truy cập cần thiết">
    Chọn **Custom Access** và bật quyền **Đọc** cho cả hai nhóm endpoint:

    | Nhóm endpoint | Mức truy cập bắt buộc |
    | - | - |
    | **Abuse Campaigns (AI Security Mailbox)** | Đọc |
    | **Threats** | Đọc |

    Sau đó nhấp vào **Tiếp theo**.

    <Note>
      Quyền truy cập **Đọc** trả về dữ liệu mối đe dọa và chiến dịch không nhạy cảm. **Read Sensitive** còn cho phép truy cập thông tin nhận dạng cá nhân (PII), tệp đính kèm và dữ liệu nhân viên. Quyền **Viết** gửi các hành động khắc phục. Chỉ cấp quyền **Đọc** trừ khi trường hợp sử dụng của quý vị yêu cầu cụ thể nhiều hơn.
    </Note>
  </Step>

  <Step title="Cấu hình chi tiết mã thông báo và danh sách IP an toàn">
    Điền vào các trường sau:

    * **Token Name** — Một tên mô tả (ví dụ: `Living Security Platform`)
    * **Mô tả** — Thông tin bổ sung không bắt buộc (ví dụ: `Read access for Living Security HRM platform`)
    * **Token Expiry** — Chọn **90**, **180** hoặc **365 ngày** để phù hợp với chính sách luân chuyển của quý vị. Hãy đặt lời nhắc trên lịch để luân chuyển mã thông báo trước khi hết hạn.
    * **IP Safelist** — Nhập các dải IP đầu ra (egress) của Living Security, mỗi dải một mục. Nhấp vào **Thêm** sau mỗi mục.

    <EgressIpSafelist system="Abnormal Security" />

    <Warning>
      **Danh sách IP an toàn là bắt buộc.** Abnormal Security từ chối mọi yêu cầu API từ các địa chỉ không nằm trong danh sách an toàn. Hộp thoại kết nối sẽ thành công, nhưng việc đồng bộ dữ liệu sẽ thất bại với lỗi `401 Unauthorized` cho đến khi các IP chính xác được thêm vào danh sách an toàn.
    </Warning>

    Sau đó nhấp vào **Tiếp theo**.
  </Step>

  <Step title="Xem lại và tạo mã thông báo">
    Xem lại bản tóm tắt cấu hình mã thông báo của quý vị, sau đó nhấp vào **Create Token**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/review-token.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=6935f488f5778fcea3f6907629aa1316" alt="Màn hình xem lại cấu hình mã thông báo" style={{maxWidth: "550px"}} width="1910" height="726" data-path="integrations/images/abnormal-security/review-token.avif" />
  </Step>

  <Step title="Sao chép và lưu mã thông báo của quý vị">
    **Sao chép mã thông báo ngay lập tức** và lưu trữ ở nơi an toàn (ví dụ: kho mật khẩu hoặc trình quản lý bí mật), sau đó nhấp vào **Xong**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/copy-token.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=fa752c333af664ad5b3ed037dbb67143" alt="Hộp thoại sao chép mã thông báo hiển thị mã thông báo đã được tạo" style={{maxWidth: "550px"}} width="1999" height="329" data-path="integrations/images/abnormal-security/copy-token.avif" />

    <Warning>
      Abnormal Portal chỉ hiển thị giá trị mã thông báo **một lần duy nhất**. Nếu quý vị rời khỏi trang mà chưa sao chép, quý vị phải tạo mã thông báo mới và thu hồi mã thông báo cũ.
    </Warning>
  </Step>

  <Step title="Xác định máy chủ API theo khu vực của quý vị">
    Xác định máy chủ API chính xác cho môi trường Abnormal Security của quý vị:

    | Môi trường | Máy chủ API theo khu vực |
    | - | - |
    | Mặc định (thương mại Hoa Kỳ) | `api.abnormalplatform.com` |
    | EU | `eu.rest.abnormalsecurity.com` |
    | FedRAMP | `rest.abnormalsecurity.us` |

    Chỉ nhập **tên máy chủ** — không có tiền tố `https://` và không có dấu gạch chéo ở cuối.

    Nếu quý vị không chắc tổ chức của mình sử dụng môi trường nào, hãy kiểm tra URL cổng Abnormal của quý vị hoặc liên hệ với nhóm quản lý tài khoản Abnormal Security của quý vị.
  </Step>
</Steps>

***

## Phần B — Trong Living Security Platform

*Chủ sở hữu chương trình thực hiện bước này, hoặc quản trị viên hệ thống nếu sử dụng thiết lập ủy quyền.*

<Steps>
  <ConnectInPlatform tile="Abnormal Security">
    | Trường | Giá trị |
    | - | - |
    | **Khóa API** | Mã thông báo đã sao chép ở Phần A, Bước 7 |
    | **Máy chủ API theo khu vực** | Máy chủ từ Phần A, Bước 8 (mặc định cho Hoa Kỳ: `api.abnormalplatform.com`) |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/abnormal-security/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=46afa66685c5f59483324c863fd4fa86" alt="Hộp thoại kết nối của Living Security dành cho Abnormal Security" style={{maxWidth: "450px"}} width="576" height="638" data-path="integrations/images/abnormal-security/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

Hiện quý vị đã được kết nối với Abnormal Security.

***

## Khắc phục sự cố

<AccordionGroup>
  <Accordion title="403 Forbidden — Quý vị không có quyền thực hiện hành động này">
    Mã thông báo thiếu một hoặc cả hai quyền truy cập bắt buộc (**Abuse Campaigns** hoặc **Threats**). Loại tích hợp, phạm vi và mức truy cập không thể thay đổi sau khi tạo mã thông báo — quý vị phải tạo mã thông báo mới với các cài đặt chính xác và thu hồi mã thông báo cũ.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Mã thông báo không hợp lệ/đã hết hạn, hoặc IP của yêu cầu không nằm trong danh sách an toàn. Hãy kiểm tra:

    1. Mã thông báo chưa bị thu hồi hoặc hết hạn
    2. Cả bốn [địa chỉ IP đầu ra (egress) của Living Security](/vi/integrations/managing/egress-ip-addresses) đều nằm trong danh sách an toàn

    Nếu trước đây việc đồng bộ hoạt động bình thường nhưng hiện thất bại với lỗi `401`, các địa chỉ IP đầu ra có thể đã thay đổi — hãy xem [Configuring Integration Egress IP Addresses](/vi/integrations/managing/egress-ip-addresses) và xác minh danh sách an toàn khớp với các địa chỉ đó.
  </Accordion>

  <Accordion title="Hết hạn mã thông báo cũ (30 tháng 4, 2027)">
    Nếu tổ chức của quý vị có các mã thông báo API được tạo trước khi trải nghiệm Token Management tự phục vụ được giới thiệu, chúng sẽ xuất hiện với nhãn **Legacy** trong bảng điều khiển. Các mã thông báo cũ (legacy) vẫn tiếp tục hoạt động nhưng không thể luân chuyển — chỉ có thể cập nhật danh sách IP an toàn của chúng. Tất cả mã thông báo cũ sẽ tự động hết hạn vào ngày **30 tháng 4, 2027**. Hãy lên kế hoạch thay thế các mã thông báo cũ bằng mã thông báo mới trước ngày đó.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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