Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

Device Trust from Android Enterprise - สัญญาณที่ใช้ได้

สำคัญ: การเข้าถึงสัญญาณความน่าเชื่อถือของอุปกรณ์จากภายในโปรไฟล์ส่วนตัวหรือในอุปกรณ์ที่ไม่มีการจัดการกำหนดให้แอปพลิเคชันของคุณต้องอยู่ในรายการที่อนุญาต แอปพลิเคชันที่ได้รับมอบหมายบทบาท COMPANION_APP ในอุปกรณ์ที่จัดการโดย AMAPI จะเข้าถึงสัญญาณได้โดยไม่ต้องอยู่ในรายการที่อนุญาตในอุปกรณ์ที่มีการจัดการครบวงจรหรือจากภายในโปรไฟล์งาน (โดยจำกัดการเข้าถึงเฉพาะโปรไฟล์งาน) โปรดดูรายละเอียดที่หัวข้อการเข้าถึงสัญญาณ

Device Trust from Android Enterprise มีชุดสัญญาณสถานะของอุปกรณ์ใน Device ที่แอปพลิเคชันที่ได้รับอนุญาต ซึ่งรวมถึงแอปพลิเคชันในรายการที่อนุญาตและแอปที่ได้รับบทบาท COMPANION_APP (ดูหัวข้อจัดการบทบาทของแอปพลิเคชันและการกำหนดค่านโยบาย) สามารถเข้าถึงเพื่อคำนวณคะแนนความน่าเชื่อถือของอุปกรณ์ได้

ฟิลด์สัญญาณแต่ละฟิลด์ใน Device และคลาสโมเดลที่ฝังอยู่จะมีเมธอด get*Metadata() ที่เกี่ยวข้องซึ่งแสดงผล Metadata ซึ่งจะรายงาน Metadata.DataIssue ที่พบเมื่อดึงข้อมูลสัญญาณ (เช่น สิทธิ์ในไฟล์ Manifest ที่ขาดหายไป)

ดูข้อมูลเกี่ยวกับวิธีผสานรวม Android Management API SDK ในแอปพลิเคชันได้ที่Device Trust from Android Enterprise - คู่มือการผสานรวม

สัญญาณ
เวอร์ชันของระบบปฏิบัติการ	`Device#getSoftwareInfo()` จะแสดงผลออบเจ็กต์ `SoftwareInfo` ที่มีรายละเอียดเวอร์ชันของระบบปฏิบัติการ (โดยปกติแล้วระบบปฏิบัติการเวอร์ชันเก่าจะมีช่องโหว่มากกว่า) ดังนี้ `SoftwareInfo#getAndroidVersion()`: สตริงเวอร์ชัน Android ที่ผู้ใช้มองเห็น `SoftwareInfo#getAndroidSdkVersion()`: ระดับ API ของเวอร์ชันแพลตฟอร์ม Android ที่ทำงานบนอุปกรณ์
เวอร์ชัน Android Device Policy	`SoftwareInfo#getAndroidDevicePolicyVersionCode()` และ `SoftwareInfo#getAndroidDevicePolicyVersionName()` จะแสดงผล รหัสเวอร์ชันและชื่อเวอร์ชันที่ผู้ใช้เห็นของแอป Android Device Policy ในอุปกรณ์ Android
อุปกรณ์มี OTA ที่รอดำเนินการไหม	`SoftwareInfo#getSystemUpdateInfo()` แสดงผลเป็น `SoftwareInfo.SystemUpdateInfo` ซึ่งระบุว่ามี การอัปเดตระบบปฏิบัติการที่รอดำเนินการสำหรับอุปกรณ์หรือไม่ (พร็อกซีสำหรับระบุว่าอุปกรณ์ เสี่ยงต่อการถูกเจาะระบบหรือไม่) `SystemUpdateInfo#getUpdateStatus()` (ค่า `UpdateStatus`) `SystemUpdateInfo#getUpdateReceivedTime()`: วันที่การอัปเดตเริ่มเปิดให้ใช้งาน ใน Android 15 ขึ้นไป สัญญาณนี้จะพร้อมใช้งานในทุกสถานการณ์ ใน Android 14 และต่ำกว่า ฟีเจอร์นี้จะใช้ได้เฉพาะเมื่ออุปกรณ์ได้รับการจัดการโดยแอป Android Device Policy (ไม่ใช่ในอุปกรณ์ที่ไม่มีการจัดการหรืออุปกรณ์ที่จัดการโดย DPC ที่กำหนดเอง)
ระดับแพตช์ด้านความปลอดภัยของอุปกรณ์	`SoftwareInfo#getDeviceSecurityPatchInfos()` แสดงรายการออบเจ็กต์ `SoftwareInfo.SecurityPatchInfo` (โดยที่ `getComponent()` และ `getSecurityPatchLevel()` แสดงรายการออบเจ็กต์ `SecurityPatchLevel`) สำหรับระดับแพตช์ด้านความปลอดภัยปัจจุบันของอุปกรณ์ในประเภท `SecurityPatchComponent` ที่อัปเดตได้ ดังนี้ `SYSTEM` `KERNEL` `SYSTEM_MODULES` (หรือที่เรียกว่าโมดูลหลักของ Android)
ระดับแพตช์ด้านความปลอดภัยที่เผยแพร่	`SoftwareInfo#getPublishedSecurityPatchInfos()` แสดงรายการออบเจ็กต์ `SoftwareInfo.SecurityPatchInfo` (โดย `getComponent()` และ `getSecurityPatchLevel()` แสดงรายการออบเจ็กต์ `SecurityPatchLevel`) สำหรับระดับแพตช์ด้านความปลอดภัยที่เผยแพร่ในปัจจุบันในประเภท `SecurityPatchComponent` ที่อัปเดตได้ ดังนี้ `SYSTEM` `KERNEL` `SYSTEM_MODULES` (หรือที่เรียกว่าโมดูลหลักของ Android)
รายละเอียดแอปที่สำคัญ	`Device#getApplicationReports()` แสดงรายละเอียดเกี่ยวกับแอปพลิเคชันที่ติดตั้งทั้งหมดไปยังแอปความสามารถในการขยายและแอปพลิเคชันที่เรียกใช้ซึ่งมีบทบาท `COMPANION_APP` ในอุปกรณ์ที่จัดการโดย AMAPI (ดูจัดการบทบาทของแอปพลิเคชันและการกำหนดค่านโยบาย เมื่อเรียกใช้ภายในโปรไฟล์งาน รายงานจะจำกัดเฉพาะแอปที่ติดตั้งในโปรไฟล์งาน) สำหรับผู้โทรรายอื่นๆ ทั้งหมด (เช่น แอปพลิเคชันในรายการที่อนุญาต) `Device#getApplicationReports()` จะแสดงรายละเอียดเฉพาะแอปที่สำคัญต่อไปนี้เท่านั้น `com.android.chrome` `com.google.android.gms` `com.google.android.apps.work.clouddpc` `com.android.vending` แพ็กเกจ WebView ปัจจุบันของอุปกรณ์ (เช่น `com.google.android.webview`) ระบบจะแสดงรายละเอียดเป็นรายการออบเจ็กต์ `ApplicationReport` ที่แสดงข้อมูลต่อไปนี้ `getPackageName()` `getVersionName()` และ `getLongVersionCode()` `getSigningKeyCertSha256Fingerprints()` `getApplicationSource()` (ค่า `ApplicationSource`) และ `getInstallerPackageName()` ระบบจะป้อนข้อมูลในช่องเหล่านี้เฉพาะในอุปกรณ์ที่จัดการโดย AMAPI (อุปกรณ์ที่มีการจัดการครบวงจรและโปรไฟล์งาน) ในอุปกรณ์ที่ไม่มีการจัดการ โปรไฟล์ส่วนตัว หรืออุปกรณ์ DPC ที่กำหนดเอง ระบบอาจไม่ป้อนข้อมูลในช่องเหล่านี้ โดย `getInstallerPackageName()` จะแสดงผลเป็นสตริงว่าง (`""`) และ `getApplicationSource()` จะแสดงผลเป็น `APPLICATION_SOURCE_UNSPECIFIED` ผู้เรียกในสภาพแวดล้อมเหล่านั้นไม่ควรถือว่า `APPLICATION_SOURCE_UNSPECIFIED` บ่งชี้ถึงแอปที่โหลดจากภายนอก `getLastUpdateTime()`
ข้อมูลฮาร์ดแวร์ของอุปกรณ์	`Device#getHardwareInfo()` แสดงผลออบเจ็กต์ `HardwareInfo` ที่แสดงข้อมูลต่อไปนี้ `HardwareInfo#getModel()`: รุ่นอุปกรณ์ `HardwareInfo#getBrand()`: แบรนด์อุปกรณ์ `HardwareInfo#getManufacturer()`: ผู้ผลิตอุปกรณ์ `HardwareInfo#getHardware()`: ชื่อฮาร์ดแวร์ `HardwareInfo#getDevice()`: ชื่อการออกแบบอุตสาหกรรม `HardwareInfo#getProduct()`: ชื่อสินค้าโดยรวม
ความซับซ้อนของการล็อกหน้าจอ	`Device#getDeviceSettings()` มี `DeviceSettings#getScreenLockComplexity()` ซึ่งจะแสดงผลค่า `DeviceSettings.ScreenLockComplexity` ที่ระบุว่าการล็อกหน้าจอของผู้ใช้หรือโปรไฟล์ปัจจุบันมีความซับซ้อนเพียงใด ต้องใช้สิทธิ์ `REQUEST_PASSWORD_COMPLEXITY` ในไฟล์ Manifest ของแอปที่เรียกใช้สำหรับผู้เรียกใช้ทั้งหมด
สถานะการจัดการ (และแอปการจัดการ)	`Device#getOwnership()` แสดงผลค่า `Device.Ownership` `Device#getManagementMode()` แสดงผลค่า `Device.ManagementMode` `Device#getManagementAppPackageName()` จะแสดงผลชื่อแพ็กเกจของแอปที่จัดการ `Device#getWorkProfileState()` แสดงผลค่า `Device.WorkProfileState` ข้อมูลที่แสดงผลจะขึ้นอยู่กับโปรไฟล์ที่แอปพลิเคชันทำงานอยู่ โปรดดูรายละเอียดในตารางสถานะการจัดการ
การเข้ารหัสดิสก์	`DeviceSettings#getEncryptionStatus()` จะแสดงผลค่า `DeviceSettings.EncryptionStatus` ซึ่งระบุว่า พื้นที่เก็บข้อมูลของอุปกรณ์มีการเข้ารหัสหรือไม่
สถานะเครือข่ายการเข้าถึง (สถานะเครือข่ายและสถานะ Wi-Fi)	`Device#getNetworkInfo()` แสดงผลออบเจ็กต์ `NetworkInfo` และ `NetworkInfo#getNetworkParams()` แสดงผลรายการออบเจ็กต์ `NetworkInfo.NetworkParams` พร้อมรายละเอียดเกี่ยวกับเครือข่ายที่ใช้งานอยู่ทั้งหมดในอุปกรณ์ `getNetworkTransport()` (รายการค่า `NetworkTransport` เช่น เครือข่ายมือถือหรือ Wi-Fi) `getWifiSecurityLevel()` (`WifiSecurityLevel`: `OPEN`, `PERSONAL`, `ENTERPRISE_EAP`, `ENTERPRISE_192`) `getPrivateDnsState()` (`PrivateDnsState`) ต้องมีสิทธิ์ `ACCESS_NETWORK_STATE` ในไฟล์ Manifest ของแอปการโทรสำหรับผู้โทรทั้งหมด
VerifyApps ของ Google Play Protect	`DeviceSettings#getGooglePlayProtectVerifyAppsState()` แสดงผล `GooglePlayProtectVerifyAppsState` ปัจจุบัน
เปิดใช้ DNS-over-TLS หรือไม่	`NetworkParams#getPrivateDnsState()` จะแสดงผลค่า `PrivateDnsState` ซึ่งระบุว่ามีการใช้ DNS ส่วนตัวในเครือข่ายหรือไม่
แพ็กเกจ WebView	`SoftwareInfo#getWebviewPackage()` จะแสดงชื่อของแพ็กเกจ WebView ปัจจุบัน
ชื่อธุรกิจที่มนุษย์อ่านได้ของผู้ให้บริการการจัดการ	ในอุปกรณ์ที่จัดการโดย AMAPI `Device#getManagementProviderInfo()` จะแสดงผลออบเจ็กต์ `ManagementProviderInfo` ซึ่งเมธอด `getBusinessName()` จะระบุชื่อธุรกิจที่มนุษย์อ่านได้ ของผู้ให้บริการการจัดการ ระบบจะไม่ตั้งค่าช่องนี้ในอุปกรณ์ที่ไม่มีการจัดการหรืออุปกรณ์ที่จัดการโดย DPC ที่กำหนดเอง สัญญาณนี้พร้อมใช้งานตั้งแต่ AMAPI SDK v1.7.0-rc01 เป็นต้นไป

สถานะการจัดการ

ค่าที่แสดงผลสำหรับสัญญาณการจัดการจะขึ้นอยู่กับโปรไฟล์ที่แอปพลิเคชันของคุณทำงานอยู่ การเข้าถึงสัญญาณจากภายในโปรไฟล์ส่วนตัว ในอุปกรณ์ที่ไม่มีการจัดการ หรือในอุปกรณ์ที่จัดการโดย DPC ที่กำหนดเองกำหนดให้แอปพลิเคชันของคุณต้องอยู่ในรายการที่อนุญาต ในอุปกรณ์ที่มีการจัดการครบวงจรซึ่งจัดการโดย AMAPI หรือจากภายในโปรไฟล์งาน แอปพลิเคชันที่ได้รับมอบหมายบทบาท COMPANION_APP จะเข้าถึงสัญญาณเหล่านี้ได้โดยไม่ต้องอยู่ในรายการที่อนุญาต (จำกัดเฉพาะสัญญาณจากโปรไฟล์งานเมื่อเรียกใช้ภายในโปรไฟล์งาน)

สถานะการจัดการ	สัญญาณเมื่อเรียกใช้จากภายในโปรไฟล์ส่วนตัว	สัญญาณเมื่อมีการโทรจากภายในโปรไฟล์งาน
อุปกรณ์ที่ไม่มีการจัดการ	ownership: `PERSONALLY_OWNED` managementMode: `UNMANAGED` managementAppPackageName: `N/A` workProfileState: A13+: `WORK_PROFILE_NOT_PRESENT` A9-12: `WORK_PROFILE_STATE_UNSPECIFIED`	`N/A`
โปรไฟล์งานในอุปกรณ์ส่วนตัว (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`
โปรไฟล์งานในอุปกรณ์ของบริษัท	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`
อุปกรณ์ที่มีการจัดการเต็มรูปแบบ	`N/A`	ownership: `COMPANY_OWNED` managementMode: `DEVICE_OWNER` managementAppPackageName: `Package name of the Device Owner application` workProfileState: A11+: `WORK_PROFILE_NOT_PRESENT` คำตอบ 9-10: `WORK_PROFILE_STATE_UNSPECIFIED`