Đ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.Alltrê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
Thiết lập
Mở bảng thiết lập Microsoft Teams
Kết nối tenant Microsoft của bạn
Tải xuống gói Teams theo khu vực
Tải lên và cài đặt gói trong Teams admin center
- 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
Cài đặt hoặc mở ứng dụng
Cấu hình thông điệp cài đặt
- Send install messages
- Send personal install messages
- Send channel install messages
- Default message
- Personal message
- Channel message
{{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 đó.Xác thực thiết lập
Gửi thông báo thử nghiệm
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.Đổ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.
Giải nén gói
manifest.json, color.png và outline.png.Thay thế các biểu tượng
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 tên ứng dụng của bạn
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ự.Nếu một ứng dụng Living Security đã được tải lên trong Teams admin center, hãy đặtversioncao 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ịversiontrongmanifest.jsonbạ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.1và bản tải xuống mới của bạn là1.1.0, hãy đặt1.1.2. Việc nâng1.1.0đã tải xuống lên1.1.1sẽ lặp lại phiên bản đã cài đặt, và Teams sẽ từ chối bản tải lên.
Giữ nguyên các trường danh tính
-
id -
botIdtrongbots -
webApplicationInfo -
validDomains -
contentUrlvàwebsiteUrltrongstaticTabs
Nén lại ba tệp thành ZIP
manifest.json nằm trong một thư mục.Tải lên và xác minh
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
developertrong 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 GraphUser.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:
- 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.
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.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: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.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 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ố
Người dùng không nhận được thông báo cá nhân
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
Thông báo kênh không xuất hiện
Thông báo kênh không xuất hiện
- 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.
- Xác nhận ánh xạ kênh trong Living Security sử dụng đúng nhóm và kênh.
- Kiểm tra xem kênh có bị xóa, đổi tên, lưu trữ hoặc hạn chế hay không.
- 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.
Tra cứu email/UPN tùy chọn hoặc sự đồng ý không thành công
Tra cứu email/UPN tùy chọn hoặc sự đồng ý không thành công
- 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ị. - Xác nhận ID tenant đã cấu hình là tenant nơi người dùng và Teams tọa lạc.
- 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.
Nhật ký truyền thông hiển thị yêu cầu sự đồng ý của quản trị viên Microsoft
Nhật ký truyền thông hiển thị yêu cầu sự đồng ý của quản trị viên Microsoft
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.- 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.
- Xác nhận đã kết nối đúng ID tenant Microsoft Entra.
- 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.Allcho 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ọ. - 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.
Ứng dụng đã được cài đặt nhưng thông báo không thành công
Ứ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
Bảo mật
Living Security chỉ sử dụng Microsoft GraphUser.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ữ.

