Поделиться через


DevicePolicyManager.SetAlwaysOnVpnPackage Метод

Определение

Перегрузки

SetAlwaysOnVpnPackage(ComponentName, String, Boolean)

Вызывается владельцем устройства или профиля для настройки vpn-подключения постоянного подключения через определенное приложение для текущего пользователя.

SetAlwaysOnVpnPackage(ComponentName, String, Boolean, ICollection<String>)

Версия #setAlwaysOnVpnPackage(ComponentName, String, boolean) , которая позволяет администратору указать набор приложений, которые должны иметь доступ к сети напрямую, если VPN не подключен.

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

Параметры

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_ONandroid.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.

Документация по Java для android.app.admin.DevicePolicyManager.setAlwaysOnVpnPackage(android.content.ComponentName, java.lang.String, boolean).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом 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

Параметры

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) списка разрешений блокировки.

Документация по Java для android.app.admin.DevicePolicyManager.setAlwaysOnVpnPackage(android.content.ComponentName, java.lang.String, boolean, java.util.Set<java.lang.String>).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

Применяется к