Device Trust از Android Enterprise - سیگنال‌های دردسترس

مهم: برای دسترسی به نشان‌های اعتماد دستگاه از داخل نمایه شخصی یا در دستگاه غیرمدیریت‌شده، برنامه شما باید در فهرست مجاز باشد. برنامه‌هایی که نقش COMPANION_APP به آن‌ها اختصاص داده شده است در دستگاه‌های تحت‌مدیریت AMAPI می‌توانند بدون اینکه در فهرست مجاز دستگاه‌های کاملاً مدیریت‌شده یا از داخل نمایه کاری (با دسترسی محدود به نمایه کاری) باشند، به سیگنال‌ها دسترسی داشته باشند. برای جزئیات، دسترسی به سیگنال‌ها را ببینید.

‫Device Trust از Android Enterprise مجموعه‌ای از نشان‌های وضعیت دستگاه را در Device دردسترس قرار می‌دهد که برنامه‌های مجاز (ازجمله برنامه‌های موجود در فهرست مجاز و برنامه‌هایی که نقش COMPANION_APP به آن‌ها اختصاص داده شده است (به مدیریت نقش‌های برنامه و پیکربندی خط‌مشی مراجعه کنید)) می‌توانند برای محاسبه امتیاز اعتماد دستگاه به آن‌ها دسترسی داشته باشند.

هر فیلد سیگنال در Device و کلاس‌های مدل تودرتوی آن شامل یک روش get*Metadata() متناظر است که Metadata را برمی‌گرداند، که هرگونه Metadata.DataIssue مواجه‌شده هنگام بازیابی سیگنال (مانند اجازه‌های مانیفست مفقود) را گزارش می‌دهد.

برای کسب اطلاعات درباره نحوه ادغام Android Management API SDK در برنامه‌تان، Device Trust از Android Enterprise - راهنمای ادغام را ببینید.

نشان‌ها
نسخه سیستم‌عامل	Device#getSoftwareInfo() یک SoftwareInfo شیء حاوی جزئیات نسخه سیستم‌عامل را برمی‌گرداند (نسخه‌های قدیمی‌تر سیستم‌عامل معمولاً آسیب‌پذیری‌های بیشتری دارند): SoftwareInfo#getAndroidVersion(): رشته نسخه Android قابل‌مشاهده برای کاربر. SoftwareInfo#getAndroidSdkVersion(): سطح میانای برنامه‌سازی کاربردی نسخه پلاتفرم Android که در دستگاه اجرا می‌شود.
نسخه Android Device Policy	SoftwareInfo#getAndroidDevicePolicyVersionCode() و SoftwareInfo#getAndroidDevicePolicyVersionName() کد نسخه و نام نسخه قابل‌مشاهده برای کاربر برنامه Android Device Policy را در دستگاه برمی‌گرداند.
آیا دستگاه OTA معلقه دارد	SoftwareInfo#getSystemUpdateInfo() SoftwareInfo.SystemUpdateInfo را برمی‌گرداند که نشان می‌دهد آیا به‌روزرسانی سیستم‌عامل معلقی برای دستگاه وجود دارد یا نه (پروکسی برای اینکه آیا دستگاه دربرابر سوءاستفاده آسیب‌پذیر است یا نه): SystemUpdateInfo#getUpdateStatus() (یک UpdateStatus مقدار). SystemUpdateInfo#getUpdateReceivedTime(): زمانی که به‌روزرسانی برای اولین‌بار دردسترس قرار گرفت. در Android 15 و بالاتر، این سیگنال در همه سناریوها دردسترس است. در Android 14 و نسخه‌های پایین‌تر، این ویژگی فقط زمانی دردسترس است که دستگاه توسط برنامه Android Device Policy مدیریت شود (در دستگاه‌های مدیریت‌نشده یا دستگاه‌هایی که توسط «کنترل‌کننده خط‌مشی دستگاه» سفارشی مدیریت می‌شوند دردسترس نیست).
سطح وصله امنیتی دستگاه	SoftwareInfo#getDeviceSecurityPatchInfos() فهرستی از اشیاء SoftwareInfo.SecurityPatchInfo (با getComponent() و getSecurityPatchLevel() که فهرستی از اشیاء SecurityPatchLevel را برمی‌گرداند) برای سطح وصله امنیتی فعلی دستگاه در انواع SecurityPatchComponent قابل‌به‌روزرسانی برمی‌گرداند: SYSTEM KERNEL SYSTEM_MODULES (که به‌عنوان ماژول‌های mainline Android نیز شناخته می‌شود)
سطح وصله امنیتی منتشرشده	SoftwareInfo#getPublishedSecurityPatchInfos() فهرستی از اشیاء SoftwareInfo.SecurityPatchInfo (با getComponent() و getSecurityPatchLevel() که فهرستی از اشیاء SecurityPatchLevel را برمی‌گرداند) برای سطح وصله امنیتی منتشرشده فعلی در انواع SecurityPatchComponent قابل‌به‌روزرسانی برمی‌گرداند: SYSTEM KERNEL SYSTEM_MODULES (که به‌عنوان ماژول‌های mainline Android نیز شناخته می‌شود)
جزئیات مهم برنامه	Device#getApplicationReports() جزئیات مربوط به همه برنامه‌های نصب‌شده را به برنامه‌های توسعه‌پذیری و برنامه‌های تماس‌گیرنده با نقش COMPANION_APP در دستگاه تحت‌مدیریت AMAPI برمی‌گرداند (به مدیریت نقش‌های برنامه و پیکربندی خط‌مشی مراجعه کنید؛ وقتی از داخل نمایه کاری فراخوانی شود، گزارش‌ها به برنامه‌های نصب‌شده در نمایه کاری محدود می‌شود). برای همه تماس‌گیرندگان دیگر (مانند برنامه‌های موجود در فهرست مجاز)، Device#getApplicationReports() جزئیات را فقط برای برنامه‌های حیاتی زیر برمی‌گرداند: com.android.chrome com.google.android.gms com.google.android.apps.work.clouddpc com.android.vending بسته «وب‌نمای» فعلی دستگاه (مانند 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 در مانیفست برنامه تماس‌گیرنده برای همه تماس‌گیرندگان نیاز دارد.
وضعیت مدیریت (و برنامه مدیریت)	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 در مانیفست برنامه برقراری تماس برای همه تماس‌گیرندگان نیاز دارد.
سپر ایمنی Google Play VerifyApps	DeviceSettings#getGooglePlayProtectVerifyAppsState() GooglePlayProtectVerifyAppsState کنونی را برمی‌گرداند.
آیا «ساناد ازطریق TLS» فعال است	NetworkParams#getPrivateDnsState() مقدار PrivateDnsState را برمی‌گرداند که نشان می‌دهد آیا از ساناد خصوصی در شبکه استفاده می‌شود یا نه.
بسته وب‌نما	SoftwareInfo#getWebviewPackage() نام بسته «وب‌نما» فعلی را برمی‌گرداند.
نام کسب‌وکار قابل‌خواندن برای انسان ارائه‌دهنده مدیریت	در دستگاه‌های تحت مدیریت AMAPI، Device#getManagementProviderInfo() یک شیء ManagementProviderInfo برمی‌گرداند که روش getBusinessName() آن نام کسب‌وکار قابل‌خواندن برای انسان ارائه‌دهنده مدیریت را ارائه می‌دهد. این فیلد در دستگاه‌های مدیریت‌نشده یا دستگاه‌هایی که با DPC سفارشی مدیریت می‌شوند تنظیم نشده است. این سیگنال از AMAPI SDK نسخه v1.7.0-rc01 دردسترس است.

وضعیت مدیریت

مقادیر برگردانده‌شده برای نشان‌های مدیریت به نمایه‌ای بستگی دارد که برنامه‌تان در آن اجرا می‌شود. برای دسترسی به سیگنال‌ها از داخل «نمایه شخصی»، در دستگاه مدیریت‌نشده، یا در دستگاهی که توسط DPC سفارشی مدیریت می‌شود، برنامه شما باید در فهرست مجاز باشد. در دستگاه کاملاً مدیریت‌شده تحت مدیریت AMAPI یا از داخل «نمایه کاری»، برنامه‌هایی که نقش COMPANION_APP به آن‌ها اختصاص داده شده است نیز می‌توانند بدون قرار گرفتن در فهرست مجاز به این سیگنال‌ها دسترسی داشته باشند (محدود به سیگنال‌های نمایه کاری وقتی که در داخل نمایه کاری فراخوانی شوند).

نکته کلیدی: سیگنال Device.WorkProfileState از AMAPI SDK نسخه v1.4.0-rc01 دردسترس است.

وضعیت مدیریت	سیگنال‌ها هنگام فراخوانی از داخل «نمایه شخصی»	سیگنال‌ها هنگام فراخوانی از داخل «نمایه کاری»
دستگاه مدیریت‌نشده	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 A9-10: WORK_PROFILE_STATE_UNSPECIFIED