Thiết lập thông báo Pub/Sub

Lưu ý: Các đối tác EMM hiện tại có ESA được tạo bằng lập trình cần đăng ký dự án Cloud mà họ muốn với Google trước khi thiết lập thông báo Pub/Sub cho API Quản lý Android. Để biết thêm thông tin chi tiết, hãy xem Hướng dẫn dành cho các đối tác EMM hiện tại.

Thông báo Pub/Sub giúp bạn nhận được cảnh báo về các thiết bị mới đăng ký, báo cáo thiết bị và lệnh được đưa ra gần đây.

Để thiết lập thông báo Pub/Sub, bạn cần bật API Pub/Sub và tạo một chủ đề. Để nhận các tin nhắn được đăng lên một chủ đề, hãy tạo một gói thuê bao cho chủ đề đó. Lệnh đăng ký kết nối chủ đề với một ứng dụng người đăng ký nhận và xử lý các thông báo được phát hành cho chủ đề đó. Sau khi tạo gói thuê bao, bạn cần cấp quyền cho Android Device Policy để phát hành lên chủ đề của mình.

1. Bật API Pub/Sub cho dự án

Để biết hướng dẫn về cách bật API Pub/Sub, hãy xem hướng dẫn nhanh về bảng điều khiển. Đảm bảo rằng bạn chọn cùng một dự án mà Android Management API được bật.

2. Tạo một chủ đề

Sau khi bật API, bạn cần tạo một chủ đề mà Android Device Policy có thể phát hành thông báo. Có hai cách để tạo chủ đề:

a. Theo cách thủ công trong Google Cloud Console.
b. Sử dụng API Pub/Sub (xem phương thức tạo chủ đề).

Sau khi tạo chủ đề, hãy ghi lại tên chủ đề.

3. Tạo gói thuê bao

Gói thuê bao ghi lại luồng tin nhắn được phát hành cho một chủ đề nhất định. Có hai cách để tạo gói thuê bao:

a. Theo cách thủ công trong Google Cloud Console.
b. Sử dụng Pub/Sub API (xem phương thức tạo gói thuê bao).

4. Cấp cho Android Device Policy quyền phát hành nội dung về chủ đề của bạn

Bạn cần cấp quyền cho [e-mail] để phát hành thông báo cho chủ đề của mình. Có hai cách để cấp quyền xuất bản:

a. Theo cách thủ công trong Bảng điều khiển Google Cloud.

• Thêm [e-mail] làm thành viên vào chủ đề của bạn.
• Nhấp vào Chọn vai trò > Pub/Sub > Nhà xuất bản Pub/Sub.

b. Sử dụng API Pub/Sub (xem phần Kiểm soát quyền truy cập thông qua API IAM)

• Thêm serviceAccount:[e-mail] vào members.
• Đặt role thành roles/pubsub.publisher.

5. Cập nhật phiên bản doanh nghiệp để hỗ trợ thông báo

Bỏ qua bước này nếu thông báo bạn muốn hỗ trợ là ENTERPRISE_UPGRADE, thông báo này luôn được hỗ trợ.

Để kết nối thông báo về một doanh nghiệp với chủ đề bạn đã tạo, hãy gọi enterprises.patch và chỉ định các tham số sau:

• pubsubTopic: Tên chủ đề pub/sub ở dạng projects/{project}/topics/{topic}.
• enabledNotificationTypes: Bao gồm tất cả các loại thông báo bạn muốn nhận. Chọn trong số ENROLLMENT, STATUS_REPORT và COMMAND.

6. Sử dụng API Pub/Sub để nhận thông báo

Một gói thuê bao có thể sử dụng cơ chế đẩy hoặc kéo để phân phối thông báo. Bạn có thể xem nguyên tắc và hướng dẫn về cách nhận thông báo thông qua cả hai cơ chế này trong Hướng dẫn dành cho người đăng ký Pub/Sub.

Định dạng thông báo

Tin nhắn có dạng PubsubMessage. Trường attributes của thông báo chứa một thuộc tính có khoá notificationType và giá trị được đặt thành loại thông báo đã kích hoạt thông báo (ví dụ: ENROLLMENT). Trường data của thông báo chứa nội dung đại diện JSON của tài nguyên đã được cập nhật, được mã hoá dưới dạng chuỗi UTF-8. Sau đây là thông báo và các loại tài nguyên tương ứng:

• Thông báo COMMAND sử dụng loại tài nguyên Toán tử.
• Thông báo USAGE_LOGS sử dụng loại tài nguyên UsageLogEvent.
• Thông báo ENROLLMENT và STATUS_REPORT sử dụng loại tài nguyên Thiết bị.
• Thông báo ENTERPRISE_UPGRADE sử dụng loại tài nguyên EnterpriseUpgradeEvent.

Khi thiết lập pubsubTopic trên một Doanh nghiệp, một thông báo ban đầu sẽ được phát hành với notificationType được đặt thành test. Thông báo này được gửi để xác minh rằng Android Device Policy có quyền phát hành về chủ đề này và bạn nên bỏ qua thông báo này.

Lưu ý: Khi sử dụng API Pub/Sub REST, trường data được mã hoá dưới dạng chuỗi base64. Để lấy JSON tài nguyên, trước tiên, hãy giải mã base64 trên nội dung của data, sau đó diễn giải các byte thu được dưới dạng chuỗi UTF-8.

Độ trễ dự kiến

Các sự kiện nâng cấp Enterprise dự kiến sẽ được gửi ngay lập tức.

Các sự kiện thiết bị cục bộ xảy ra liên tiếp nhanh chóng được phân thành lô và báo cáo trong một thông báo Pub/Sub duy nhất cho EMM.

Loại sự kiện	Độ trễ dự kiến giữa sự kiện trên thiết bị và thông báo EMM tương ứng^1
Trạng thái ứng dụng được khoá có mức độ ưu tiên cao	Ngay lập tức, tối đa một báo cáo mỗi phút
Trạng thái ứng dụng được khoá có mức độ ưu tiên tiêu chuẩn	Trong vòng một phút
Các sự kiện liên quan đến ứng dụng trong quá trình cấp phép, đối với các ứng dụng có trạng thái cài đặt do quản trị viên CNTT xác định^2	Trong vòng một phút, cùng với các sự kiện cấp phép khác có liên quan
Các sự kiện liên quan đến ứng dụng sau khi cấp phép, đối với các ứng dụng có trạng thái cài đặt do quản trị viên CNTT xác định.	Trong vòng 5 phút
Các sự kiện liên quan đến ứng dụng cả trong và sau khi cấp phép, đối với các ứng dụng có trạng thái cài đặt do nhân viên xác định^3	Trong vòng 60 phút
Các sự kiện khác của ứng dụng trên thiết bị	Trong vòng 60 phút

---

1. Mục tiêu nỗ lực tối đa dựa trên các trường hợp được kiểm soát. Độ trễ thực tế có thể thay đổi theo nhiều yếu tố về thiết bị và môi trường. ↩

2. InstallType ứng dụng được thực thi trong chính sách: FORCE_INSTALLED, BLOCKED, REQUIRED_FOR_SETUP, PREINSTALLED và KIOSK. ↩

3. InstallType của các ứng dụng có sẵn: AVAILABLE, INSTALL_TYPE_UNSPECIFIED. ↩