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

# Tích hợp Microsoft Teams

> Kết nối Living Security với Microsoft Teams để gửi thông báo đào tạo, cảnh báo bảo mật và thông báo kênh.

Tích hợp Microsoft Teams gửi các thông báo của Living Security đến người dùng và các kênh thông qua ứng dụng Living Security Teams. Hãy sử dụng tích hợp này cho các phân công đào tạo, cảnh báo rủi ro con người, thông điệp triển khai và thông báo của nhóm bảo mật.

Tích hợp này chỉ dùng để gửi thông báo. Người dùng không gửi lệnh cho bot trong Microsoft Teams. Khi ứng dụng được cài đặt, bot sẽ lưu tham chiếu cuộc trò chuyện Teams để gửi các thông báo chủ động trong tương lai. Thông điệp cài đặt là thông điệp một chiều và có thể được tùy chỉnh hoặc tắt để đáp ứng các yêu cầu triển khai của doanh nghiệp.

<Warning>
  Quản trị viên Microsoft Teams vẫn phải tải lên, phê duyệt và phân phối ứng dụng
  Living Security Teams. Sự đồng ý của quản trị viên Microsoft Entra `User.Read.All` là
  tùy chọn và chỉ bật cơ chế dự phòng tra cứu bằng email hoặc tên chính của người dùng (UPN).
</Warning>

<Note>
  Để thiết lập việc gửi Nhắc nhở và Sách hướng dẫn, hãy bắt đầu tại **Cài đặt → Truyền thông →
  Kênh** và nhấp vào thẻ **Microsoft Teams**. Trang này trình bày cấu hình
  ứng dụng Teams bên dưới.
</Note>

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

Trước khi cấu hình Microsoft Teams, hãy đảm bảo bạn có:

* Một quản trị viên Microsoft Teams có thể tải lên và phê duyệt các ứng dụng của tổ chức. Cùng một người có thể đảm nhiệm cả hai vai trò quản trị viên.
* Một quản trị viên Microsoft Entra, chỉ khi bạn muốn bật cơ chế dự phòng tra cứu email/UPN tùy chọn với sự đồng ý ứng dụng `User.Read.All` trên toàn bộ tenant
* Đặc quyền quản trị viên Living Security
* Một tổ chức Living Security đang hoạt động
* Tên nhóm và tên kênh nơi các thông báo bảo mật cần được gửi đến, nếu bật tính năng thông báo kênh
* ID tenant Microsoft Entra của bạn, có tại **Microsoft Entra admin center → Danh tính → Tổng quan về**

## Vai trò và trách nhiệm

| Vai trò | Trách nhiệm |
| - | - |
| **Quản trị viên Living Security** | Kết nối tenant Microsoft, tải xuống gói theo khu vực, cấu hình thông điệp cài đặt, xác thực thiết lập và gửi thông báo thử nghiệm |
| **Quản trị viên Microsoft Teams** | Tải lên và cho phép ứng dụng, phân phối ứng dụng đến người dùng hoặc nhóm dự kiến, và gán các chính sách thiết lập ứng dụng |
| **Quản trị viên Microsoft Entra**, tùy chọn | Cấp sự đồng ý ứng dụng `User.Read.All` cho ID ứng dụng Bot của khu vực khi cần cơ chế dự phòng tra cứu email/UPN |
| **Chủ sở hữu Teams**, khi sử dụng việc gửi qua kênh | Cài đặt hoặc phê duyệt ứng dụng cho nhóm và kênh dự kiến |

Các vai trò này có thể do những người khác nhau đảm nhiệm. Hãy chia sẻ giá trị checksum của gói, ID ứng dụng Teams, **ID ứng dụng Bot** và đối tượng triển khai dự kiến với quản trị viên Microsoft Teams. Chỉ chia sẻ URL đồng ý đã tạo với quản trị viên Microsoft Entra khi bật cơ chế dự phòng tra cứu email/UPN tùy chọn. Không chia sẻ các thông tin xác thực Living Security không liên quan.

## Thiết lập

<Steps>
  <Step title="Mở bảng thiết lập Microsoft Teams">
    Trong Living Security, đi tới **Cài đặt → Truyền thông → Kênh** và chọn **Microsoft Teams**.

    Bảng này hiển thị khu vực của tổ chức bạn, tên tệp gói, ID ứng dụng Teams, ID ứng dụng bot, giá trị checksum SHA256, trạng thái cấu hình tenant Microsoft, hướng dẫn cài đặt, các tùy chọn điều khiển thông điệp cài đặt, cũng như các công cụ xác thực và gửi thông báo thử nghiệm.

    <Check>
      Khu vực hiển thị trong Living Security khớp với khu vực nơi tổ chức của bạn được lưu trữ.
    </Check>
  </Step>

  <Step title="Kết nối tenant Microsoft của bạn">
    Trong **Connect your tenant**, nhập ID tenant Microsoft Entra sở hữu những người dùng và kênh Teams nhận thông báo, sau đó nhấp **Save Microsoft tenant**. Một tenant Microsoft chỉ có thể thuộc về một tổ chức Living Security.

    Nếu không thể sử dụng điều khiển tenant, hãy làm việc với người phụ trách triển khai Living Security hoặc đầu mối hỗ trợ của bạn để kết nối hoặc thay đổi tenant trước khi cài đặt ứng dụng.

    <Check>
      Living Security hiển thị **Microsoft tenant connected** trước khi bạn tiếp tục.
    </Check>

    <Note>
      Nếu có thể, hãy kết nối tenant trước khi cài đặt ứng dụng Teams. Nếu ứng dụng đã được cài đặt, hãy lưu tenant và chọn **Validate install** trước. Living Security sẽ cố gắng tự động liên kết bản cài đặt hiện có; chỉ cài đặt lại nếu quá trình xác thực không phát hiện được bản cài đặt đó.
    </Note>
  </Step>

  <Step title="Tải xuống gói Teams theo khu vực">
    Nhấp **Download Teams package**. Living Security cung cấp một gói ZIP dành riêng cho khu vực của tổ chức bạn.

    Hãy đối chiếu tệp đã tải xuống với giá trị checksum SHA256 hiển thị trong Living Security trước khi bạn thay đổi bất kỳ nội dung nào. Để đặt tên và biểu tượng riêng cho ứng dụng, hãy làm theo phần [Đổi thương hiệu gói theo khu vực](#%C4%91%E1%BB%95i-th%C6%B0%C6%A1ng-hi%E1%BB%87u-g%C3%B3i-theo-khu-v%E1%BB%B1c) sau bước kiểm tra này và trước khi bạn tải gói lên.

    <Check>
      Giá trị checksum của tệp đã tải xuống khớp với giá trị checksum SHA256 hiển thị trong Living Security.
    </Check>
  </Step>

  <Step title="Tải lên và cài đặt gói trong Teams admin center">
    Trong Microsoft Teams admin center, đi tới **Teams apps → Manage apps → Actions → Upload new app**, sau đó tải lên tệp ZIP đã tải xuống từ Living Security.

    Xác nhận:

    * ID ứng dụng Teams và ID ứng dụng bot khớp với các giá trị hiển thị trong Living Security
    * Tên ứng dụng là tên Living Security theo khu vực, hoặc tên bạn đã đặt nếu bạn đã đổi thương hiệu gói
    * Nhà xuất bản là **Living Security**. Việc đổi thương hiệu gói không làm thay đổi nhà xuất bản
    * Ứng dụng không bị chặn
    * Ứng dụng khả dụng cho những người dùng hoặc nhóm dự kiến
    * Ứng dụng được cài đặt thông qua các chính sách thiết lập ứng dụng hoặc cài đặt có mục tiêu cho những người dùng và nhóm/kênh cần nhận thông báo

    Microsoft có thể cần một khoảng thời gian để lan truyền các thay đổi về khả năng khả dụng của ứng dụng và chính sách thiết lập.

    <Note>
      Nếu quá trình xác thực hoặc thử nghiệm thất bại ngay sau khi thay đổi chính sách ứng dụng, hãy xác nhận việc gán chính sách trong Microsoft Teams admin center và thử lại sau khi Microsoft hoàn tất việc lan truyền.
    </Note>
  </Step>

  <Step title="Cài đặt hoặc mở ứng dụng">
    Phân phối ứng dụng cá nhân đến những người dùng dự kiến. Trước khi Living Security có thể
    gửi thông báo thử nghiệm cá nhân đến một bản cài đặt được phát hiện, ít nhất một người dùng phải
    cài đặt hoặc mở ứng dụng cá nhân Living Security trong Microsoft Teams. Thao tác này
    cho phép bot ghi nhận danh tính đáng tin cậy của người dùng và tham chiếu cuộc trò chuyện
    cá nhân. Chỉ cài đặt trên kênh thì không thể được dùng cho thử nghiệm
    cá nhân trên bản cài đặt được phát hiện.

    Để gửi qua kênh, hãy cài đặt ứng dụng trong nhóm và kênh dự kiến để bot
    có thể ghi nhận tham chiếu cuộc trò chuyện của kênh đó.

    <Check>
      Một người dùng mục tiêu đã cài đặt hoặc mở ứng dụng cá nhân, hoặc ứng dụng được
      cài đặt trong kênh dự kiến.
    </Check>
  </Step>

  <Step title="Cấu hình thông điệp cài đặt">
    Trong phần **Install message controls**, chọn có gửi thông điệp cài đặt Teams hay không và tùy chỉnh nội dung một chiều cho tổ chức của bạn.

    Các tùy chọn điều khiển khả dụng:

    * Send install messages
    * Send personal install messages
    * Send channel install messages
    * Default message
    * Personal message
    * Channel message

    Các trường thông điệp hỗ trợ `{{installerName}}`, được thay bằng tên hiển thị của người dùng đã cài đặt ứng dụng. Để trống thông điệp cá nhân hoặc thông điệp kênh để sử dụng thông điệp mặc định bạn đã cấu hình. Nếu thông điệp mặc định cũng để trống, Living Security sẽ sử dụng thông điệp tích hợp sẵn cho phạm vi đó.
  </Step>

  <Step title="Xác thực thiết lập">
    Nhấp **Validate install** trong Living Security. Quá trình xác thực kiểm tra rằng gói theo khu vực khả dụng, cấu hình tenant Microsoft đã có và là duy nhất cho tổ chức Living Security này, thông tin xác thực bot theo khu vực đã được cấu hình, và đã phát hiện một bản cài đặt ứng dụng đang hoạt động cho tenant đã kết nối.

    <Check>
      Quá trình xác thực hiển thị **Validation passed** trước khi bạn gửi các thông báo thực tế.
    </Check>
  </Step>

  <Step title="Gửi thông báo thử nghiệm">
    Đối với thử nghiệm cá nhân mặc định, nhấp **Send test to detected installation**.
    Living Security chọn một bản cài đặt cá nhân đang hoạt động đã được phát hiện và sử dụng
    danh tính đáng tin cậy cùng tham chiếu cuộc trò chuyện đã lưu của bản cài đặt đó. Thử nghiệm này không gọi
    Microsoft Graph và không yêu cầu sự đồng ý `User.Read.All`.

    Nếu không phát hiện bản cài đặt cá nhân nào, hãy yêu cầu một người dùng cài đặt hoặc mở
    ứng dụng cá nhân Living Security, chọn **Validate install** một lần nữa, sau đó
    gửi lại thông báo thử nghiệm. Chỉ sử dụng thử nghiệm email/UPN có mục tiêu nâng cao khi
    cơ chế dự phòng tra cứu tùy chọn được bật.

    <Check>Thông báo thử nghiệm một chiều xuất hiện trong Microsoft Teams.</Check>

    Xem lại lần gửi tương ứng trong [Nhật ký truyền thông](/vi/features/communications/log) khi cần dữ liệu chẩn đoán việc gửi.
  </Step>
</Steps>

## Đổi thương hiệu gói theo khu vực

Gói theo khu vực là một tệp nén ZIP gồm ba tệp: `manifest.json`, `color.png` và `outline.png`. Bạn có thể đặt tên và biểu tượng ứng dụng riêng trong gói đó trước khi tải lên. Living Security hỗ trợ cách này đối với các gói theo khu vực mà quản trị viên Teams tải lên trực tiếp.

Hãy thực hiện sau khi bạn tải xuống và xác minh gói, và trước khi tải gói lên trong Teams admin center.

<Steps>
  <Step title="Giải nén gói">
    Giải nén tệp ZIP. Tệp này chứa đúng ba tệp ở thư mục gốc của
    tệp nén: `manifest.json`, `color.png` và `outline.png`.
  </Step>

  <Step title="Thay thế các biểu tượng">
    Thay thế `color.png` và `outline.png` bằng các biểu tượng của riêng bạn. Giữ nguyên
    hai tên tệp này.

    | Tệp | Yêu cầu |
    | - | - |
    | `color.png` | PNG đủ màu, 192 × 192 pixel, không trong suốt |
    | `outline.png` | PNG trong suốt, 32 × 32 pixel |
  </Step>

  <Step title="Đặt tên ứng dụng của bạn">
    Trong `manifest.json`, chỉnh sửa hai trường sau:

    * `name.short` — tên hiển thị trong tiêu đề ứng dụng Teams và các khu vực có không gian hạn chế khác. Tối đa 30 ký tự.
    * `name.full` — tên hiển thị trong danh mục ứng dụng và chi tiết ứng dụng. Tối đa 100 ký tự.

          <Note>
            Nếu một ứng dụng Living Security đã được tải lên trong Teams admin center, hãy đặt
            `version` cao hơn phiên bản đang được cài đặt ở đó. Microsoft Teams từ chối một
            bản cập nhật không tăng số phiên bản, và một bản tải xuống mới có thể mang
            cùng phiên bản hoặc phiên bản thấp hơn so với gói bạn đã cài đặt.

            Xem phiên bản đã cài đặt trong Teams admin center tại **Teams apps → Manage
            apps**, trên trang chi tiết ứng dụng. So sánh với giá trị `version` trong
            `manifest.json` bạn vừa tải xuống, rồi đặt một giá trị cao hơn cả hai. Giữ
            định dạng ba số `MAJOR.MINOR.PATCH`.

            Ví dụ, nếu ứng dụng đã cài đặt là `1.1.1` và bản tải xuống mới của bạn là `1.1.0`,
            hãy đặt `1.1.2`. Việc nâng `1.1.0` đã tải xuống lên `1.1.1` sẽ lặp lại
            phiên bản đã cài đặt, và Teams sẽ từ chối bản tải lên.
          </Note>
  </Step>

  <Step title="Giữ nguyên các trường danh tính">
    Không thay đổi các trường này. Mỗi trường mang danh tính của ứng dụng, bot hoặc
    đăng nhập một lần:

    * `id`
    * `botId` trong `bots`
    * `webApplicationInfo`
    * `validDomains`
    * `contentUrl` và `websiteUrl` trong `staticTabs`

          <Warning>
            Việc thay đổi một trường danh tính có thể khiến ứng dụng vẫn cài đặt được nhưng không thể
            gửi thông báo hoặc hoàn tất đăng nhập một lần. **Validate install** kiểm tra
            tenant, thông tin xác thực bot và bản cài đặt được phát hiện. Chức năng này không
            so sánh tệp manifest của bạn với gói mà Living Security đã tạo.
          </Warning>
  </Step>

  <Step title="Nén lại ba tệp thành ZIP">
    Tạo một tệp nén ZIP mới từ ba tệp. Đặt chúng ở thư mục gốc của
    tệp nén, không có thư mục bao bên ngoài. Microsoft Teams từ chối một gói có
    `manifest.json` nằm trong một thư mục.
  </Step>

  <Step title="Tải lên và xác minh">
    Tải tệp ZIP đã đổi thương hiệu lên trong Teams admin center, sau đó quay lại Living
    Security và nhấp **Validate install**. Gửi một thông báo thử nghiệm.

    <Check>
      Quá trình xác thực hiển thị **Validation passed**, và thông báo thử nghiệm đến
      Microsoft Teams với tên và biểu tượng ứng dụng của bạn.
    </Check>
  </Step>
</Steps>

### Nhà xuất bản và checksum

Việc đổi thương hiệu đặt tên và biểu tượng ứng dụng. Việc này không thay đổi hai điều sau:

* **Nhà xuất bản vẫn là Living Security.** Các trường `developer` trong manifest nêu tên Living Security và liên kết đến trang web, chính sách quyền riêng tư và điều khoản dịch vụ của Living Security. Các trường này cùng nhau xác định công ty vận hành dịch vụ, vì vậy Teams tiếp tục hiển thị **Living Security** là nhà xuất bản trên trang chi tiết ứng dụng, trong hộp thoại đồng ý cấp quyền và trong các báo cáo sử dụng ứng dụng. Tên và biểu tượng của bạn là những gì người dùng thấy trong tiêu đề ứng dụng, danh mục ứng dụng và các thông báo.
* **Giá trị checksum SHA256 không còn khớp.** Giá trị checksum hiển thị trong Living Security mô tả gói như khi tải xuống. Hãy xác minh giá trị này trước khi chỉnh sửa các tệp, sau đó ghi lại giá trị checksum của gói đã đổi thương hiệu của riêng bạn vào hồ sơ triển khai.

## Tùy chọn: Bật cơ chế dự phòng tra cứu email/UPN

Việc gửi cá nhân thông thường sử dụng một ID đối tượng Microsoft Entra đáng tin cậy mà
Living Security đã biết, cùng với tham chiếu cuộc trò chuyện của bot được ghi nhận khi
người dùng cài đặt hoặc mở ứng dụng. Việc gửi qua kênh sử dụng tham chiếu cuộc trò chuyện
của kênh đã lưu. Cả hai cách đều không yêu cầu Microsoft Graph.

Nếu người nhận không có ID đối tượng Entra đáng tin cậy, Living Security có thể
tùy chọn sử dụng Microsoft Graph để xác định người nhận theo địa chỉ email hoặc UPN.
Để bật cơ chế dự phòng này, hãy yêu cầu quản trị viên Microsoft Entra nhấp **Grant
optional User.Read.All consent** trong bảng thiết lập Teams và phê duyệt quyền ứng dụng
Microsoft Graph `User.Read.All` cho ứng dụng Living
Security Teams của khu vực.

Luồng đồng ý của quản trị viên tuân theo mẫu Microsoft Entra sau:

```text theme={null}
https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id}
```

Living Security tạo URL này từ ID tenant đã kết nối và **Bot
app ID** hiển thị trong bảng thiết lập. Các ID này phục vụ các mục đích khác nhau:

* **Teams app ID** xác định gói ứng dụng có thể cài đặt trong Microsoft Teams
  admin center.
* **Bot app ID** xác định ứng dụng Microsoft Entra của bot theo khu vực và
  là ID máy khách được dùng cho luồng đồng ý của quản trị viên tùy chọn.

Không thay thế bằng Teams app ID trong URL đồng ý. Tích hợp **Microsoft Entra ID
(Client Credentials)** trong mục Connected Integrations là một tích hợp chung,
riêng biệt. Bot Teams theo khu vực không thể dùng lại thông tin xác thực hoặc sự đồng ý của tích hợp đó,
và sự đồng ý được cấp cho một ứng dụng Entra không liên quan không bật
cơ chế dự phòng này.

<Note>
  Việc đặt sự đồng ý là tùy chọn không loại bỏ `User.Read.All` khỏi các đăng ký ứng dụng
  Living Security theo khu vực hiện có. Những khách hàng đã cấp
  sự đồng ý có thể tiếp tục sử dụng cơ chế dự phòng email/UPN mà không cần cấu hình lại.
</Note>

## Các loại thông báo

Tùy thuộc vào quyền lợi của tổ chức bạn và các Sách hướng dẫn đã cấu hình, Living Security có thể gửi:

| Thông báo | Mô tả |
| - | - |
| Phân công đào tạo | Thông báo cho người dùng khi Đào tạo được phân công, đến hạn hoặc sẵn sàng để hoàn thành |
| Nhắc nhở đào tạo | Nhắc người dùng về các thời hạn sắp tới |
| Cảnh báo rủi ro con người | Gửi các cập nhật Chỉ số rủi ro con người được cá nhân hóa và các bước tiếp theo được đề xuất |
| Thông điệp triển khai | Gửi các thông báo giới thiệu hoặc triển khai một chiều trong quá trình triển khai |
| Thông báo kênh | Đăng các thông tin truyền thông của chương trình bảo mật lên các kênh Teams đã cấu hình |

## Tùy chỉnh

Các thông báo Teams sử dụng cấu hình tổ chức Living Security của bạn. Các trường được hỗ trợ bao gồm tên hiển thị của khách hàng, logo và các trường thương hiệu được hỗ trợ, nội dung thông điệp, lời kêu gọi hành động, liên kết đích, văn bản triển khai và văn bản hỗ trợ/liên hệ.

Thông điệp cài đặt có thể được cấu hình từ **Cài đặt → Truyền thông → Kênh → Microsoft Teams → Install message controls**. Bạn có thể tắt hoàn toàn thông điệp cài đặt, chỉ tắt thông điệp cài đặt cá nhân hoặc kênh, và cấu hình nội dung mặc định, cá nhân hoặc riêng cho kênh.

Tên và biểu tượng ứng dụng Teams đến từ gói theo khu vực. Để đặt tên và biểu tượng riêng, xem [Đổi thương hiệu gói theo khu vực](#%C4%91%E1%BB%95i-th%C6%B0%C6%A1ng-hi%E1%BB%87u-g%C3%B3i-theo-khu-v%E1%BB%B1c).

## Cập nhật hoặc gỡ bỏ ứng dụng

* Khi Living Security cung cấp gói theo khu vực đã cập nhật, hãy tải gói đó xuống từ bảng kênh Microsoft Teams và tải lên thông qua Teams admin center. Xác minh ID ứng dụng, ID bot và giá trị checksum được hiển thị trước khi triển khai.
* Các chỉnh sửa thương hiệu không được giữ lại khi cập nhật gói. Mỗi gói theo khu vực mới lại mang tên và biểu tượng ứng dụng Living Security. Hãy áp dụng lại các chỉnh sửa của bạn theo [Đổi thương hiệu gói theo khu vực](#%C4%91%E1%BB%95i-th%C6%B0%C6%A1ng-hi%E1%BB%87u-g%C3%B3i-theo-khu-v%E1%BB%B1c) trước khi tải gói mới lên. Hãy lưu biểu tượng, hai giá trị tên và phiên bản bạn đã tải lên gần nhất ở nơi bạn có thể tìm thấy, để mỗi lần nâng cấp chỉ là việc lặp lại ngắn gọn các bước tương tự. Một gói mới không phải lúc nào cũng có phiên bản cao hơn phiên bản bạn đã cài đặt, vì vậy hãy đặt phiên bản dựa trên những gì Teams hiển thị là đã cài đặt.
* Chạy lại **Validate install** và gửi một thông báo thử nghiệm khác sau khi cập nhật ứng dụng hoặc chính sách.
* Việc gỡ bỏ hoặc chặn ứng dụng sẽ ngăn các thông báo chủ động đến người dùng hoặc kênh đó. Hãy cài đặt lại ứng dụng và gửi một thông báo thử nghiệm mới để Living Security nhận được sự kiện cài đặt Teams hiện tại.
* Nếu bạn ngừng việc gửi qua Teams, hãy gỡ Teams khỏi các Sách hướng dẫn liên quan trước khi gỡ ứng dụng khỏi Microsoft Teams.

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

<AccordionGroup>
  <Accordion title="Người dùng không nhận được thông báo cá nhân">
    * Xác nhận ứng dụng cá nhân Living Security Teams đã được cài đặt và người dùng đã mở ứng dụng để Living Security có tham chiếu cuộc trò chuyện hiện tại
    * Xác nhận ID tenant Microsoft đã cấu hình là tenant nơi người dùng thuộc về
    * Nếu dữ liệu chẩn đoán cho thấy cơ chế dự phòng email/UPN đã được thử, hãy xác nhận sự đồng ý của quản trị viên `User.Read.All` đã được cấp cho Bot app ID hiển thị, đối với đúng tenant
    * Khi sử dụng cơ chế dự phòng email/UPN, hãy xác minh email hoặc UPN của người dùng trong Living Security khớp với Microsoft Entra ID
    * Yêu cầu người dùng bỏ chặn hoặc cài đặt lại ứng dụng nếu trước đó họ đã gỡ bỏ hoặc chặn ứng dụng
  </Accordion>

  <Accordion title="Thông báo kênh không xuất hiện">
    <ul>
      <li>
        Xác nhận ứng dụng Living Security Teams đã được cài đặt trong nhóm hoặc
        kênh mục tiêu.
      </li>

      <li>
        Xác nhận ánh xạ kênh trong Living Security sử dụng đúng nhóm và
        kênh.
      </li>

      <li>
        Kiểm tra xem kênh có bị xóa, đổi tên, lưu trữ hoặc hạn chế hay không.
      </li>

      <li>
        Cài đặt lại ứng dụng trong nhóm hoặc kênh mục tiêu và gửi một thông báo
        thử nghiệm khác.
      </li>
    </ul>
  </Accordion>

  <Accordion title="Tra cứu email/UPN tùy chọn hoặc sự đồng ý không thành công">
    <ul>
      <li>
        Xác nhận quản trị viên Microsoft Entra đã cấp sự đồng ý trên toàn tenant cho
        Microsoft Graph `User.Read.All` đối với Bot app ID hiển thị.
      </li>

      <li>
        Xác nhận ID tenant đã cấu hình là tenant nơi người dùng và Teams
        tọa lạc.
      </li>

      <li>
        Xác minh người dùng tồn tại trong Microsoft Entra ID và không phải là khách từ
        tenant khác.
      </li>
    </ul>
  </Accordion>

  <Accordion title="Nhật ký truyền thông hiển thị yêu cầu sự đồng ý của quản trị viên Microsoft">
    Danh mục lỗi `TEAMS_ADMIN_CONSENT_REQUIRED`, hoặc lỗi Microsoft `AADSTS7000229`, có nghĩa là một lượt tra cứu người nhận bằng email/UPN đã thử cơ chế dự phòng Microsoft Graph tùy chọn, nhưng ứng dụng Living Security Teams theo khu vực không có service principal (ứng dụng doanh nghiệp) trong tenant Microsoft Entra đã kết nối. Các cách mặc định dùng ID đáng tin cậy và cuộc trò chuyện đã lưu không yêu cầu sự đồng ý này. Đây không phải là lỗi do secret của Living Security đã hết hạn.

    1. Mở **Cài đặt → Truyền thông → Kênh → Microsoft Teams**. Bạn cũng có thể sử dụng **Open Microsoft Teams setup** từ lỗi trong Nhật ký truyền thông.
    2. Xác nhận đã kết nối đúng ID tenant Microsoft Entra.
    3. Nếu cần cơ chế dự phòng email/UPN, hãy yêu cầu quản trị viên Microsoft Entra nhấp **Grant optional User.Read.All consent** và phê duyệt `User.Read.All` cho **Bot app ID** được hiển thị. Nếu không, hãy đảm bảo người nhận đã mở ứng dụng cá nhân và Living Security có ID đối tượng Entra đáng tin cậy của họ.
    4. Sau khi Microsoft xử lý xong sự đồng ý, hãy gửi một thử nghiệm email/UPN có mục tiêu nâng cao từ phần thiết lập Microsoft Teams. Nhật ký truyền thông hiển thị lịch sử gửi và dữ liệu chẩn đoán; nhật ký này không gửi lại thông báo đã thất bại.

    Việc cấu hình lại **Microsoft Entra ID (Client Credentials)** không giải quyết được lỗi này vì tích hợp đó không được sử dụng để gửi thông báo Teams.
  </Accordion>

  <Accordion title="Ứng dụng đã được cài đặt nhưng thông báo không thành công">
    * Kiểm tra xem bot có bị chặn, gỡ bỏ hoặc gỡ cài đặt hay không
    * Nếu ứng dụng được cài đặt trước khi tenant được kết nối trong Living Security, hãy lưu tenant và chọn **Validate install** để Living Security có thể liên kết bản cài đặt hiện có
    * Chỉ cài đặt lại nếu quá trình xác thực không phát hiện được bản cài đặt hiện có
    * Xác nhận người dùng hoặc kênh mục tiêu đã nhận được sự kiện cài đặt ứng dụng mới nhất
    * Gửi một thông báo thử nghiệm mới sau khi cài đặt lại ứng dụng

    Ví dụ về các trường sự kiện cài đặt được dùng để khắc phục sự cố:

    ```json theme={null}
    {
      "type": "installationUpdate",
      "action": "add",
      "channelData": {
        "tenant": { "id": "278750d2-8df7-4262-a34d-08d79ad671d8" },
        "team": { "id": "19:team-id@thread.tacv2" },
        "channel": { "id": "19:channel-id@thread.tacv2" }
      },
      "conversation": {
        "id": "19:channel-id@thread.tacv2",
        "conversationType": "channel",
        "tenantId": "278750d2-8df7-4262-a34d-08d79ad671d8"
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## Bảo mật

Living Security chỉ sử dụng Microsoft Graph `User.Read.All` cho cơ chế dự phòng tra cứu người nhận bằng email/UPN tùy chọn. Theo mặc định, việc định tuyến thông báo cá nhân sử dụng ID đối tượng Entra đáng tin cậy từ dữ liệu thực thể của Living Security và tham chiếu cuộc trò chuyện của bot được ghi nhận từ Microsoft Teams. ID đối tượng và tham chiếu cuộc trò chuyện do bên gọi cung cấp không được coi là dữ liệu định tuyến đáng tin cậy. Các thông điệp Microsoft Teams được gửi thông qua bot Teams chỉ dùng để thông báo của Living Security, sử dụng tính năng nhắn tin chủ động của Microsoft Teams.

Living Security không yêu cầu khách hàng tự tạo đăng ký ứng dụng Microsoft Entra hoặc chia sẻ client secret thuộc sở hữu của khách hàng cho việc thiết lập ứng dụng Teams tiêu chuẩn.

Các gói Teams theo khu vực giữ cho ID ứng dụng, ID bot và điểm cuối nhắn tin nhất quán với khu vực Living Security nơi tổ chức của bạn được lưu trữ.

## Liên quan

<CardGroup cols={2}>
  <Card title="Tích hợp Email" icon="envelope" href="/vi/integrations/outbound/email">
    Cấu hình email làm kênh gửi.
  </Card>

  <Card title="Tích hợp Slack" icon="slack" href="/vi/integrations/outbound/slack">
    Cấu hình Slack làm kênh gửi.
  </Card>

  <Card title="Nhật ký truyền thông" icon="clock-rotate-left" href="/vi/features/communications/log">
    Theo dõi trạng thái và lịch sử gửi của Teams.
  </Card>

  <Card title="Xác thực" icon="shield-halved" href="/vi/features/settings/sso">
    Cấu hình Microsoft Entra ID và SSO.
  </Card>
</CardGroup>


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