Device Trust from Android Enterprise – Tín hiệu hiện có

Quan trọng: Để truy cập vào tín hiệu tin cậy của thiết bị từ bên trong hồ sơ cá nhân hoặc trên một thiết bị không được quản lý, ứng dụng của bạn phải nằm trong danh sách cho phép. Các ứng dụng được chỉ định vai trò COMPANION_APP trên thiết bị do AMAPI quản lý có thể truy cập vào tín hiệu mà không cần có trong danh sách cho phép trên thiết bị được quản lý hoàn toàn hoặc từ bên trong hồ sơ công việc (với quyền truy cập bị giới hạn trong hồ sơ công việc). Để biết thông tin chi tiết, hãy xem phần Quyền truy cập vào tín hiệu.

Device Trust from Android Enterprise cung cấp một tập hợp các tín hiệu về trạng thái thiết bị trên Device mà các ứng dụng được uỷ quyền (bao gồm cả các ứng dụng trong danh sách cho phép và các ứng dụng được chỉ định vai trò COMPANION_APP (xem phần Quản lý vai trò của ứng dụng và Cấu hình chính sách)) có thể truy cập để tính điểm tin cậy cho thiết bị.

Mỗi trường tín hiệu trên Device và các lớp mô hình lồng nhau của trường đó đều bao gồm một phương thức get*Metadata() tương ứng trả về Metadata. Phương thức này báo cáo mọi Metadata.DataIssue gặp phải khi truy xuất tín hiệu (chẳng hạn như thiếu quyền trong tệp kê khai).

Để biết thông tin về cách tích hợp SDK Android Management API vào ứng dụng, hãy xem bài viết Device Trust from Android Enterprise – Hướng dẫn tích hợp.

Tín hiệu
Phiên bản hệ điều hành	Device#getSoftwareInfo() trả về một đối tượng SoftwareInfo chứa thông tin chi tiết về phiên bản hệ điều hành (các phiên bản hệ điều hành cũ thường có nhiều lỗ hổng bảo mật hơn): SoftwareInfo#getAndroidVersion(): chuỗi phiên bản Android mà người dùng nhìn thấy. SoftwareInfo#getAndroidSdkVersion(): Cấp độ API của phiên bản nền tảng Android đang chạy trên thiết bị.
Phiên bản Android Device Policy	SoftwareInfo#getAndroidDevicePolicyVersionCode() và SoftwareInfo#getAndroidDevicePolicyVersionName() trả về mã phiên bản và tên phiên bản mà người dùng nhìn thấy của ứng dụng Android Device Policy trên thiết bị.
Thiết bị có bản cập nhật qua mạng không dây (OTA) đang chờ xử lý không	SoftwareInfo#getSystemUpdateInfo() trả về một SoftwareInfo.SystemUpdateInfo cho biết liệu có bản cập nhật hệ điều hành đang chờ xử lý cho thiết bị hay không (một proxy cho biết liệu thiết bị có dễ bị khai thác hay không): SystemUpdateInfo#getUpdateStatus() (giá trị UpdateStatus). SystemUpdateInfo#getUpdateReceivedTime(): thời điểm bản cập nhật bắt đầu được cung cấp. Trên Android 15 trở lên, tín hiệu này có trong mọi trường hợp. Trên Android 14 trở xuống, tính năng này chỉ hoạt động khi thiết bị được quản lý bằng ứng dụng Android Device Policy (không hoạt động trên các thiết bị không được quản lý hoặc thiết bị được quản lý bằng một DPC tuỳ chỉnh).
Cấp bản vá bảo mật của thiết bị	SoftwareInfo#getDeviceSecurityPatchInfos() trả về một danh sách SoftwareInfo.SecurityPatchInfo đối tượng (với getComponent() và getSecurityPatchLevel() trả về một danh sách SecurityPatchLevel đối tượng) cho cấp bản vá bảo mật hiện tại của thiết bị trên các loại SecurityPatchComponent có thể cập nhật: SYSTEM KERNEL SYSTEM_MODULES (còn gọi là mô-đun chính của Android)
Cấp bản vá bảo mật đã phát hành	SoftwareInfo#getPublishedSecurityPatchInfos() trả về một danh sách các đối tượng SoftwareInfo.SecurityPatchInfo (với getComponent() và getSecurityPatchLevel() trả về một danh sách các đối tượng SecurityPatchLevel) cho cấp bản vá bảo mật đã phát hành hiện tại trên các loại SecurityPatchComponent có thể cập nhật: SYSTEM KERNEL SYSTEM_MODULES (còn gọi là mô-đun chính của Android)
Chi tiết ứng dụng quan trọng	Device#getApplicationReports() trả về thông tin chi tiết về tất cả ứng dụng đã cài đặt cho các ứng dụng có thể mở rộng và ứng dụng gọi có vai trò COMPANION_APP trên thiết bị do AMAPI quản lý (xem phần Quản lý vai trò của ứng dụng và Cấu hình chính sách; khi được gọi trong hồ sơ công việc, báo cáo sẽ bị giới hạn ở các ứng dụng được cài đặt trong hồ sơ công việc). Đối với tất cả phương thức gọi khác (chẳng hạn như các ứng dụng trong danh sách cho phép), Device#getApplicationReports() chỉ trả về thông tin chi tiết về các ứng dụng quan trọng sau: com.android.chrome com.google.android.gms com.google.android.apps.work.clouddpc com.android.vending Gói WebView hiện tại của thiết bị (chẳng hạn như com.google.android.webview) Thông tin chi tiết được trả về dưới dạng danh sách các đối tượng ApplicationReport cho thấy: getPackageName() getVersionName() và getLongVersionCode() getSigningKeyCertSha256Fingerprints() getApplicationSource() (giá trị ApplicationSource) và getInstallerPackageName() Các trường này chỉ được điền sẵn trên các thiết bị do AMAPI quản lý (thiết bị được quản lý hoàn toàn và hồ sơ công việc). Trên các thiết bị không được quản lý, hồ sơ cá nhân hoặc thiết bị DPC tuỳ chỉnh, các trường này có thể không được điền sẵn: getInstallerPackageName() trả về một chuỗi trống ("") và getApplicationSource() trả về APPLICATION_SOURCE_UNSPECIFIED. Phương thức gọi trong những môi trường đó không nên coi APPLICATION_SOURCE_UNSPECIFIED là dấu hiệu cho thấy một ứng dụng được cài đặt không qua cửa hàng ứng dụng. getLastUpdateTime()
Thông tin phần cứng thiết bị	Device#getHardwareInfo() trả về một đối tượng HardwareInfo hiển thị: HardwareInfo#getModel(): mẫu thiết bị. HardwareInfo#getBrand(): thương hiệu thiết bị. HardwareInfo#getManufacturer(): nhà sản xuất thiết bị. HardwareInfo#getHardware(): tên phần cứng. HardwareInfo#getDevice(): tên kiểu dáng công nghiệp. HardwareInfo#getProduct(): tên sản phẩm chung.
Độ phức tạp của phương thức khoá màn hình	Device#getDeviceSettings() cung cấp DeviceSettings#getScreenLockComplexity(), trả về một giá trị DeviceSettings.ScreenLockComplexity cho biết mức độ phức tạp của phương thức khoá màn hình của người dùng hoặc hồ sơ hiện tại. Yêu cầu quyền REQUEST_PASSWORD_COMPLEXITY trong tệp kê khai của ứng dụng gọi điện cho tất cả phương thức gọi.
Trạng thái quản lý (và ứng dụng quản lý)	Device#getOwnership() trả về giá trị Device.Ownership. Device#getManagementMode() trả về giá trị Device.ManagementMode. Device#getManagementAppPackageName() trả về tên gói của ứng dụng quản lý. Device#getWorkProfileState() trả về giá trị Device.WorkProfileState. Thông tin được trả về phụ thuộc vào hồ sơ mà ứng dụng đang chạy. Để biết thông tin chi tiết, hãy xem Bảng trạng thái quản lý.
Mã hoá ổ đĩa	DeviceSettings#getEncryptionStatus() trả về một giá trị DeviceSettings.EncryptionStatus cho biết bộ nhớ của thiết bị có được mã hoá hay không.
Trạng thái mạng truy cập (Trạng thái mạng và trạng thái Wi-Fi)	Device#getNetworkInfo() trả về một đối tượng NetworkInfo và NetworkInfo#getNetworkParams() trả về danh sách các đối tượng NetworkInfo.NetworkParams có thông tin chi tiết về tất cả mạng đang hoạt động trên thiết bị: getNetworkTransport() (danh sách các giá trị NetworkTransport, chẳng hạn như di động hoặc Wi-Fi) getWifiSecurityLevel() (WifiSecurityLevel: OPEN, PERSONAL, ENTERPRISE_EAP, ENTERPRISE_192) getPrivateDnsState() (PrivateDnsState) Yêu cầu quyền ACCESS_NETWORK_STATE trong tệp kê khai của ứng dụng gọi điện cho tất cả phương thức gọi.
VerifyApps của Google Play Protect	DeviceSettings#getGooglePlayProtectVerifyAppsState() trả về GooglePlayProtectVerifyAppsState hiện tại.
DNS qua TLS có được bật không	NetworkParams#getPrivateDnsState() trả về một giá trị PrivateDnsState cho biết liệu DNS riêng tư có được sử dụng trên mạng hay không.
Gói WebView	SoftwareInfo#getWebviewPackage() trả về tên của gói WebView hiện tại.
Tên doanh nghiệp mà con người có thể đọc được của nhà cung cấp dịch vụ quản lý	Trên các thiết bị do AMAPI quản lý, Device#getManagementProviderInfo() trả về một đối tượng ManagementProviderInfo có phương thức getBusinessName() cung cấp tên doanh nghiệp mà con người có thể đọc được của nhà cung cấp dịch vụ quản lý. Trường này không được đặt trên các thiết bị không được quản lý hoặc thiết bị do một DPC tuỳ chỉnh quản lý. Tín hiệu này có từ SDK AMAPI phiên bản 1.7.0-rc01 trở lên.

Trạng thái quản lý

Giá trị được trả về cho tín hiệu quản lý phụ thuộc vào hồ sơ mà ứng dụng của bạn đang chạy. Để truy cập vào tín hiệu từ trong Hồ sơ cá nhân, trên thiết bị không được quản lý hoặc trên thiết bị do DPC tuỳ chỉnh quản lý, ứng dụng của bạn phải nằm trong danh sách cho phép. Trên thiết bị được quản lý hoàn toàn bằng AMAPI hoặc trong Hồ sơ công việc, các ứng dụng được chỉ định vai trò COMPANION_APP cũng có thể truy cập vào các tín hiệu này mà không cần nằm trong danh sách cho phép (chỉ áp dụng cho các tín hiệu từ hồ sơ công việc khi được gọi bên trong hồ sơ công việc).

Điểm mấu chốt: Tín hiệu Device.WorkProfileState được cung cấp kể từ AMAPI SDK phiên bản 1.4.0-rc01.

Trạng thái quản lý	Tín hiệu khi được gọi từ trong Hồ sơ cá nhân	Tín hiệu khi được gọi từ trong Hồ sơ công việc
Thiết bị không được quản lý	ownership: PERSONALLY_OWNED managementMode: UNMANAGED managementAppPackageName: N/A workProfileState: A13+: WORK_PROFILE_NOT_PRESENT A9-12: WORK_PROFILE_STATE_UNSPECIFIED	N/A
Hồ sơ công việc trên thiết bị thuộc sở hữu cá nhân (BYOD)	ownership: PERSONALLY_OWNED managementMode: UNMANAGED managementAppPackageName: N/A workProfileState: A13+: WORK_PROFILE_PRESENT A9-12 (AMAPI): WORK_PROFILE_PRESENT A9-12 (CustomDPC): WORK_PROFILE_STATE_UNSPECIFIED	ownership: PERSONALLY_OWNED managementMode: PROFILE_OWNER managementAppPackageName: Package name of the Profile Owner application workProfileState: A9+: WORK_PROFILE_PRESENT
Hồ sơ công việc trên thiết bị do công ty sở hữu	ownership: COMPANY_OWNED managementMode: UNMANAGED managementAppPackageName:N/A workProfileState: A13+: WORK_PROFILE_PRESENT A9-12 (AMAPI): WORK_PROFILE_PRESENT A9-12 (CustomDPC): WORK_PROFILE_STATE_UNSPECIFIED	ownership: COMPANY_OWNED managementMode: PROFILE_OWNER managementAppPackageName: Package name of the Profile Owner application workProfileState: A9+: WORK_PROFILE_PRESENT
Thiết bị được quản lý hoàn toàn	N/A	ownership: COMPANY_OWNED managementMode: DEVICE_OWNER managementAppPackageName: Package name of the Device Owner application workProfileState: A11+: WORK_PROFILE_NOT_PRESENT A9-10: WORK_PROFILE_STATE_UNSPECIFIED