DevicePolicyManager.SetAlwaysOnVpnPackage Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
SetAlwaysOnVpnPackage(ComponentName, String, Boolean) |
Вызывается владельцем устройства или профиля для настройки vpn-подключения постоянного подключения через определенное приложение для текущего пользователя. |
SetAlwaysOnVpnPackage(ComponentName, String, Boolean, ICollection<String>) |
Версия |
SetAlwaysOnVpnPackage(ComponentName, String, Boolean)
Вызывается владельцем устройства или профиля для настройки vpn-подключения постоянного подключения через определенное приложение для текущего пользователя.
[Android.Runtime.Register("setAlwaysOnVpnPackage", "(Landroid/content/ComponentName;Ljava/lang/String;Z)V", "GetSetAlwaysOnVpnPackage_Landroid_content_ComponentName_Ljava_lang_String_ZHandler", ApiSince=24)]
public virtual void SetAlwaysOnVpnPackage (Android.Content.ComponentName admin, string? vpnPackage, bool lockdownEnabled);
[<Android.Runtime.Register("setAlwaysOnVpnPackage", "(Landroid/content/ComponentName;Ljava/lang/String;Z)V", "GetSetAlwaysOnVpnPackage_Landroid_content_ComponentName_Ljava_lang_String_ZHandler", ApiSince=24)>]
abstract member SetAlwaysOnVpnPackage : Android.Content.ComponentName * string * bool -> unit
override this.SetAlwaysOnVpnPackage : Android.Content.ComponentName * string * bool -> unit
Параметры
- admin
- ComponentName
- vpnPackage
- String
Имя пакета для установленного VPN-приложения на устройстве или null
удаление существующей конфигурации VPN постоянного подключения.
- lockdownEnabled
- Boolean
true
для запрета сети, если VPN не подключен или false
в противном случае. Это не влияет на очистку.
- Атрибуты
Комментарии
Вызывается владельцем устройства или профиля для настройки vpn-подключения постоянного подключения через определенное приложение для текущего пользователя. Это подключение автоматически предоставляется и сохраняется после перезагрузки.
Для поддержки функции always-on приложение должно <объявлять в манифесте приложение android.net.VpnService
ul<>li>, защищенное ;<android.Manifest.permission#BIND_VPN_SERVICE
/li>li target или выше; и</li><li не> явно отказаться от функции через .<android.net.VpnService#SERVICE_META_DATA_SUPPORTS_ALWAYS_ON
android.os.Build.VERSION_CODES#N API 24
></li></ul> Вызов завершится ошибкой, если он вызывается с именем пакета неподдерживаемого VPN-приложения.
Включение блокировки с помощью lockdownEnabled
аргумента несет риск того, что любой сбой VPN-поставщика может нарушить сеть для всех приложений. Этот метод очищает список разрешений блокировки, заданный по #setAlwaysOnVpnPackage(ComponentName, String, boolean, Set)
.
Начиная с android.os.Build.VERSION_CODES#S API 31
вызова этого метода с vpnPackage
набором для null
удаления существующей конфигурации, если она была ранее создана этим администратором. Удаление конфигурации VPN, созданной пользователем UserManager#DISALLOW_CONFIG_VPN
.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.
Применяется к
SetAlwaysOnVpnPackage(ComponentName, String, Boolean, ICollection<String>)
Версия #setAlwaysOnVpnPackage(ComponentName, String, boolean)
, которая позволяет администратору указать набор приложений, которые должны иметь доступ к сети напрямую, если VPN не подключен.
[Android.Runtime.Register("setAlwaysOnVpnPackage", "(Landroid/content/ComponentName;Ljava/lang/String;ZLjava/util/Set;)V", "GetSetAlwaysOnVpnPackage_Landroid_content_ComponentName_Ljava_lang_String_ZLjava_util_Set_Handler", ApiSince=29)]
public virtual void SetAlwaysOnVpnPackage (Android.Content.ComponentName admin, string? vpnPackage, bool lockdownEnabled, System.Collections.Generic.ICollection<string>? lockdownAllowlist);
[<Android.Runtime.Register("setAlwaysOnVpnPackage", "(Landroid/content/ComponentName;Ljava/lang/String;ZLjava/util/Set;)V", "GetSetAlwaysOnVpnPackage_Landroid_content_ComponentName_Ljava_lang_String_ZLjava_util_Set_Handler", ApiSince=29)>]
abstract member SetAlwaysOnVpnPackage : Android.Content.ComponentName * string * bool * System.Collections.Generic.ICollection<string> -> unit
override this.SetAlwaysOnVpnPackage : Android.Content.ComponentName * string * bool * System.Collections.Generic.ICollection<string> -> unit
Параметры
- admin
- ComponentName
- vpnPackage
- String
имя пакета для установленного VPN-приложения на устройстве или null
удаление существующей конфигурации VPN для постоянного подключения
- lockdownEnabled
- Boolean
true
для запрета сети, если VPN не подключен или false
в противном случае. Это не влияет на очистку.
- lockdownAllowlist
- ICollection<String>
Пакеты, которые смогут получить доступ к сети напрямую, если VPN находится в режиме блокировки, но не подключен. Не действует при очистке.
- Атрибуты
Комментарии
Версия #setAlwaysOnVpnPackage(ComponentName, String, boolean)
, которая позволяет администратору указать набор приложений, которые должны иметь доступ к сети напрямую, если VPN не подключен. Когда VPN подключает эти приложения к VPN, если разрешено использовать этот VPN. Системные приложения всегда могут обходить VPN.
Обратите внимание, что система не обновляет список разрешений при установке или удалении пакетов, приложение администратора должно вызвать этот метод, чтобы сохранить список в актуальном состоянии.
Если lockdownEnabled
значение false lockdownAllowlist
игнорируется. Если lockdownEnabled
это true
null
или lockdownAllowlist
пусто, только системные приложения могут обойти VPN.
Настройка пакета null
VPN всегда на уровне или использование #setAlwaysOnVpnPackage(ComponentName, String, boolean)
списка разрешений блокировки.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.