With the release of Knox SDK v3.4 in 2019, the Knox VPN framework merges with the Knox SDK. As part of the Knox SDK, partners must update their VPN clients to use the new namespace, as the Knox VPN framework currently uses the legacy namespaces. This blog post discusses why and how you should migrate to the new namespace.
New namespace and your VPN client
All packages, intents, and permission names in the Knox SDK v3.x must migrate to the com.samsung.android.knox namespace in time for the Android Q OS release. Android Q is expected to release around the same time as Knox 3.4, which is expected to release in late 2019 or early 2020.
VPN clients that are still using the legacy namespaces—that is android.app.enterprise and com.sec.enterprise—when Android Q OS is released will stop working, even if they are not using the Android Q OS.
Solution: Migrate your apps to the new namespace
To prevent your VPN clients from malfunctioning and leaving your users without VPN access, we strongly recommend updating your VPN clients to use the new namespace. All VPN clients compatible with Samsung Knox SDK v3.0 or higher must update their namespace. Older devices and VPN clients can continue to use the current process.
Updating an app to use the new namespace is straightforward, especially with an IDE like Android Studio, which can look up the class for an API method. For a tutorial on how to migrate your VPN client to the new namespace, see VPN namespace changes.
In the interim
Until the Knox SDK v3.4 release, use the supportlib.jar library to map old namespaces to the new namespace. This static library acts as a proxy that forwards framework requests from the old namespace to the new namespace. You can download the supportlib.jar library from the Knox SDK Overview page.
We realize that migrating your VPN clients may take longer than anticipated. Currently, the Knox VPN framework binds Knox VPN clients using old namespace classes. In this process, the SupportLib static library works as a proxy and forwards any bind requests originating from the old namespace framework to the new namespace framework.
For the upcoming Samsung Knox SDK v3.3 release, we plan to continue automatic forwarding of requests from VPN clients using the old namespace to the new namespace. This automatic forwarding ensures that VPN clients continue to function until they can update to use the new namespace.
- Migrate your Knox 2.xx app: Our guide on how to migrate your app to the new namespace.
- IMPORTANT NOTICE: Changes to old Samsung Knox namespaces: For more information on the namespace changes.
- Check out the new Knox SDK: For a deeper dive, see the Migration Guide or Developer Guide.
- Enroll in SEAP: To get access to SDKs, forum discussions, developer tools, and more.
- Read the Release Notes: For details about the new and deprecated API methods in this release.
- FAQs, Developer Forum, Contact Us: If you still have questions.