Merge "docs: New "Android for Work Changes" preview doc" into mnc-mr-docs

page.title=Android for Work Updates

page.metaDescription=New Android for Work APIs and features in the N Developer Preview.

page.keywords="android for work", "android N", "enterprise", "QR code"

@jd:body

<div id="qv-wrapper">

  <div id="qv">

    <h2>In this document</h2>

      <ol>

        <li><a href="#qr">QR Code Provisioning

                </a></li>

        <li><a href="#sec-challenge">Work Profile Security Challenge

                </a></li>

        <li><a href="#suspend">Disable Access to Apps

                </a></li>

        <li><a href="#toggle-work">Toggle Work Mode

                </a></li>

        <li><a href="#always-on-vpn">Always-On VPN

                </a></li>

        <li><a href="#contacts">Contacts Integration with Work Profile

                </a></li>

        <li><a href="#remote-reboot">Remote Reboot

                </a></li>

        <li><a href="#disable-roaming">Disable Data Roaming

                </a></li>

        <li><a href="#process-logging">Enterprise Process Logging

                </a></li>

        <li><a href="#bug-reports">Remote Bug Reports

                </a></li>

        <li><a href="#remove-cert">Remove a Client Certificate

                </a></li>

        <li><a href="#grant-cert-on-install">Grant Access to Client Certificate

                on Installation</a></li>

        <li><a href="#ui-policy">System UI Policy Transparency

                </a></li>

        <li><a href="#restrictions-mgmt">App Restrictions Management Enhancements

                </a></li>

        <li><a href="#location-off">Location Off Switch

                </a></li>

        <li><a href="#custom-provisioning">Customized Provisioning

                </a></li>

        <li><a href="#multi-wifi-ca">Multiple Wi-Fi CA Certificates

                </a></li>

        <li><a href="#custom-lock">Customized Lockscreen Message

                </a></li>

        <li><a href="#work-connectionservice">Work Profile ConnectionService

                </a></li>

        <li><a href="#lock-wp">Lock Down Wallpaper

                </a></li>

        <li><a href="#lock-user-icon">Lock Down User Icon

                </a></li>

        <li><a href="#health-monitoring">Device Health Monitoring

                </a></li>

      </ol>

    <h2>See Also</h2>

    <ul>

      <li><a href="{@docRoot}preview/download.html#docs">N Preview SDK

            Reference</a></li>

    </ul>

  </div>

</div>

<p>This document describes the new Android for Work features provided in the

N Developer Preview.</p>

<h2 id="qr">QR Code Provisioning</h2>

<p>

  Android for Work now supports using QR codes to provision corporate-liable

  devices. The setup wizard now allows you to scan a QR code to provision

  the device.

</p>

<h2 id="sec-challenge">Work Profile Security Challenge</h2>

<p>

  Profile owners can require users to specify a security challenge for apps

  running in the work profile. The system shows the security challenge when the

  user attempts to open any work apps. If the user successfully completes the

  security challenge, the system unlocks the work profile and decrypts it if

  necessary.

</p>

<p>

  If a profile owner sends an {@link

  android.app.admin.DevicePolicyManager#ACTION_SET_NEW_PASSWORD} intent, the

  system prompts a user to set up a security challenge. The profile owner can

  also send an <code>ACTION_SET_NEW_PARENT_PROFILE_PASSWORD</code> intent to

  prompt the user to set a device lock.

</p>

<p>

  Profile owners can choose to set the password policies for the work challenge

  differently from the policies for other device passwords. For example, the

  minimum length for the device challenge response can be different from the

  length required for other passwords. Profile owners set the challenge

  policies using the usual {@link android.app.admin.DevicePolicyManager}

  methods, such as {@link

  android.app.admin.DevicePolicyManager#setPasswordQuality

  setPasswordQuality()} and {@link

  android.app.admin.DevicePolicyManager#setPasswordMinimumLength

  setPasswordMinimumLength()}. The profile owner can also set the device lock,

  by using the {@link android.app.admin.DevicePolicyManager} instance returned

  by the new <code>DevicePolicyManager.getParentProfileInstance()</code>

  method. Additionally, profile owners can customize the credentials screen for

  the work challenge by using the {@link android.app.admin.DevicePolicyManager}

  class's new <code>setOrganizationColor()</code> and

  <code>setOrganizationName()</code> methods.

</p>

<p>

  For details on the new methods and constants, see the

  <code>DevicePolicyManager</code> reference page in the <a href=

  "{@docRoot}preview/download.html#docs">N Preview SDK Reference</a>.

</p>

<h2 id="suspend">Disable Access to Apps</h2>

<p>

  Device owners and profile owners can temporarily suspend access to packages

  by calling the new <code>DevicePolicyManager.getPackagesSuspended()</code>

  method.Owners can use the same method to re-enable those packages.

</p>

<p>

  While a package is suspended, it cannot start activities, and notifications

  to the package are suppressed. Suspended packages do not show in the <a href=

  "{@docRoot}guide/components/recents.html">overview screen</a>, and they

  cannot show dialogs (including toasts and snackbars). They also cannot play

  audio or vibrate the device.

</p>

<p>

  Launchers should apply a distinctive UI to suspended apps to show that the

  apps aren't currently available; for example, they might render the app icon

  in gray. Launchers can find out which apps are suspended by calling the new

  <code>DevicePolicyManager.getPackagesSuspended()</code> method.

</p>

<h2 id="toggle-work">Toggle Work Mode</h2>

<p>On dual-profile devices, users can toggle work mode on and off. While work

  mode is turned off, the managed profile is temporarily shut down. Work profile apps, background sync, and notifications are all disabled, including the profile

  owner app. While the work profile is disabled, the system  displays a persistent status icon to remind users that they can't launch work apps. The system launcher

  indicates that work apps and widgets are not accessible.

</p>

<h2 id="always-on-vpn">Always-On VPN</h2>

<p>

  Device owners and profile owners can require that work apps always connect to

  the network through a specified VPN. If owners set this requirement, the

  device automatically starts that VPN at boot time.

</p>

<p>

  Owners can require use of a VPN by calling the new

  <code>DevicePolicyManager.setAlwaysOnVpnPackage()</code> method. To find out

  if the owner has set a VPN requirement, call the new

  <code>DevicePolicyManager.GetAlwaysOnVpnPackage()</code> method.

</p>

<p>

  Because the system can directly bind VPN services without app interaction,

  VPN clients need to handle new entry points for always-on VPN. As before, you

  can find active services by using an intent filter that matches the action

  {@link android.net.VpnService android.net.VpnService}.

</p>

<p>

  Users can manually set an always-on VPN client that implement {@link

  android.net.VpnService} by using the <strong>Settings &gt; More &gt;

  VPN</strong> screen.

</p>

<h2 id="contacts">Contacts Integration with Work Profile</h2>

<p>

  Profile owners can allow local search and directory lookup of work contacts

  from the primary user. For example, a user can access both personal and work

  directory contacts from their personal dialer or contacts application (if

  permitted by their profile administrator).

</p>

<p>

  Developers that leverage the Contact Provider can use the Enterprise Contacts

  API to access work profile directory entries from the primary user if allowed

  by policy:

</p>

<ul>

  <li><code>ContactsContract.Contacts.ENTERPRISE_CONTENT_FILTER_URI</code>

  </li>

  <li><code>ContactsContract.Phone.ENTERPRISE_CONTENT_FILTER_URI</code>

  </li>

  <li><code>ContactsContract.Email.ENTERPRISE_CONTENT_FILTER_URI</code>

  </li>

  <li><code>ContactsContract.Callable.ENTERPRISE_CONTENT_FILTER_URI</code>

  </li>

  <li><code>ContactsContract.Directory.ENTERPRISE_CONTENT_URI</code>

  </li>

  <li><code>ContactsContract.Directory.isEntepriseDirectoryId()</code>

  </li>

</ul>

<p>

  Profile owners can control the visibility of work contacts in the primary

  user using the following new methods:

</p>

<ul>

  <li>

    <code>DevicePolicyManager.setCrossProfileContactsSearchDisabled()</code>

  </li>

  <li>

    <code>DevicePolicyManager.getCrossProfileContactsSearchDisabled()</code>

  </li>

</ul>

<h2 id="remote-reboot">Remote Reboot</h2>

<p>

  Device owners can remotely reboot devices. In some cases, devices deployed in

  public places inside enclosures can prevent access to the power button. If a

  device needs to be rebooted, administrators can do so using the new

  <code>DevicePolicyManager.reboot()</code> method.

</p>

<h2 id="disable-roaming">Disable Data Roaming</h2>

<p>

  Device owners can disable data roaming using the new {@link

  android.os.UserManager} user restriction <code>DISALLOW_DATA_ROAMING</code>.

</p>

<h2 id="process-logging">Enterprise Process Logging</h2>

<p>

  Device owners can identify suspicious activity by remotely tracking device

  activity, including app launches, adb activity, and screen unlocks. Process

  logs don’t require user consent. To retrieve logs, device owners enable

  device logging using <code>setDeviceLoggingEnabled()</code>.

</p>

<p>

  The new <code>android.auditing.SecurityLog</code> class includes these

  methods:

</p>

<ul>

  <li>

    <code>void DevicePolicyManager.setDeviceLoggingEnabled()</code>

  </li>

  <li>

    <code>boolean DevicePolicyManager.getDeviceLoggingEnabled()</code>

  </li>

  <li>

    <code>List DevicePolicyManager.retrieveDeviceLogs()</code>

  </li>

  <li>

    <code>List DevicePolicyManager.retrievePreviousDeviceLogs()</code>

  </li>

  <li>

    <code>void DeviceAdminReceiver.onSecurityLogsAvailable()</code>

  </li>

</ul>

<h2 id="bug-reports">Remote Bug Reports</h2>

<p>

  Device owners can remotely trigger and retrieve a bug report that contains a

  device state dump file, which allows forensic investigation of a known

  incident or compromised device. Due to the detailed nature of the bug report,

  user consent is required.

</p>

<p>

  The Preview includes the following API additions to support this feature. For

  details, see the <a href="{@docRoot}preview/download.html#docs">N Preview SDK

  Reference</a>.

</p>

<ul>

  <li>

    <code>DevicePolicyManager.requestBugreport()</code>

  </li>

  <li>

    <code>DeviceAdminReceiver.onBugreportFailed()</code>

  </li>

  <li>

    <code>DeviceAdminReceiver.onBugreportShared()</code>

  </li>

  <li>

    <code>DeviceAdminReceiver.onBugreportSharingDeclined()</code>

  </li>

  <li>

    <code>DeviceAdminReceiver.BUGREPORT_FAILURE_FAILED_COMPLETING</code>

  </li>

  <li>

    <code>DeviceAdminReceiver.BUGREPORT_FAILURE_FILE_NO_LONGER_AVAILABLE</code>

  </li>

</ul>

<h2 id="remove-cert">Remove a Client Certificate</h2>

<p>

  Profile owners and device owners can now remove client certificates that were

  installed through {@link android.app.admin.DevicePolicyManager#installKeyPair

  installKeyPair()} by calling the new method

  <code>DevicePolicyManager.removeKeyPair()</code>.

</p>

<h2 id="grant-cert-on-install">Grant Access to Client Certificate on

  Installation</h2>

<p>

  If a profile owner or device owner grants a third-party app the ability to

  manage certificates, the app can grant itself access to certificates it

  installs without any intervention by the owner.

</p>

<p>

  The existing API for managing certificates is extended to include:

</p>

<ul>

  <li><code>DevicePolicyManager.installKeyPair()</code>

  </li>

</ul>

<h2 id="ui-policy">System UI Policy Transparency</h2>

<p>

  Policies that affect the user experience or restrict user Settings are fully

  disclosed to the user, and profile owners and device owners can attribute the

  policy to their company’s IT department. In addition to a consistent “Action

  not allowed” message in Settings, IT administrators can set an

  organization-specific support message in device settings with the following

  new {@link android.app.admin.DevicePolicyManager} methods:

</p>

<ul>

  <li>

    <code>DevicePolicyManager.setShortSupportMessage()</code>

  </li>

  <li>

    <code>DevicePolicyManager.setLongSupportMessage()</code>

  </li>

</ul>

<h2 id="restrictions-mgmt">App Restrictions Management Enhancements</h2>

<p>

  The device or profile owner can enable another application to manage app

  restrictions via the new

  <code>DevicePolicyManager.setApplicationRestrictionsManagingPackage()</code>

  method. The nominated application can check whether this permission has been

  granted by calling

  <code>DevicePolicyManager.isCallerApplicationRestrictionsManagingPackage()</code>.

</p>

<p>

  An application nominated to manage app restrictions can call {@link

  android.app.admin.DevicePolicyManager#setApplicationRestrictions

  setApplicationRestrictions()} and {@link

  android.app.admin.DevicePolicyManager#getApplicationRestrictions

  getApplicationRestrictions()} for any packages within that user or profile.

</p>

<h2 id="location-off">Location Off Switch</h2>

<p>

  Users can disable location permissions for work apps while continuing to

  access location information in their personal apps. A separate location

  access switch in Location Settings allows users to deny location updates or

  last-location queries for apps running in the work profile.

</p>

<p>

  The top level location off switch disables location access for both the

  primary profile and the managed profile.

</p>

<h2 id="custom-provisioning">Customized Provisioning</h2>

<p>

  An application can customize the profile owner and device owner provisioning

  flows with corporate colors and logos.

</p>

<dl>

  <dt>

    <code>DevicePolicyManager.EXTRA_PROVISIONING_MAIN_COLOR</code>

  </dt>

  <dd>

    Customizes flow color.

  </dd>

  <dt>

    <code>DevicePolicyManager.EXTRA_PROVISIONING_LOGO_URI</code>

  </dt>

  <dd>

    Customizes the flow with a corporate logo.

  </dd>

</dl>

<h2 id="multi-wifi-ca">Multiple Wi-Fi CA Certificates</h2>

<p>

  Profile owners and device owners can set multiple CA certificates for a given

  Wi-Fi configuration. When corporate Wi-Fi networks have separate CAs for

  separate access points with the same SSID, IT administrators can include all

  relevant CAs in the Wi-Fi configuration using the new method

  <code>setCaCertificates()</code>.

</p>

<p>

  APIs added are:

</p>

<ul>

  <li>

    <code>WifiEnterpriseConfig.setCaCertificates()</code>

  </li>

  <li>

    <code>WifiEnterpriseConfig.getCaCertificates()</code>

  </li>

</ul>

<h2 id="custom-lock">Customized Lockscreen Message</h2>

<p>

  Device owners can provide owner information to be shownon the lockscreen.

  This information takes precedence the user lock screen message (if one is

  set). New {@link android.app.admin.DevicePolicyManager} methods are:

</p>

<ul>

  <li>

    <code>setDeviceOwnerLockScreenInfo()</code>

  </li>

  <li>

    <code>getDeviceOwnerLockScreenInfo()</code>

  </li>

</ul>

<h2 id="work-connectionservice">Work Profile ConnectionService</h2>

<p>

  Profile owners can specify a work dialer application that uses a

  work-specific {@link android.telecom.ConnectionService} for the calling

  backend (calling accounts). The work dialer maintains a work-only call log

  and relies on work contacts only. Users have a consistent in-call UI

  experience regardless of dialing application. Incoming work calls to the work

  calling accounts are distinguished from personal incoming calls to the

  personal calling accounts.

</p>

<p>

  The dialer should check for the new flag

  <code>android.telecom.Call.PROPERTY_WORK_CALL</code> to determine if a call

  is a work call. If a call is a work call, the dialer should indicate this,

  such as by adding a work badge.

</p>

<h2 id="lock-wp">Lock Down Wallpaper</h2>

<p>

  A new user restriction (<code>DISALLOW_SET_WALLPAPER</code>) prevents the

  user from changing their wallpaper. The device owner or profile owner can

  still change the wallpaper, but they can only change the wallpaper for the

  user or profile they control. For example, a profile owner can’t change the

  wallpaper of the parent user, but a profile owner in the primary profile or

  device owner can. A profile owner or device owner that wants to change the

  wallpaper should check whether the the user or profile they manage has a

  wallpaper ({@link android.app.WallpaperManager#isWallpaperSupported

  isWallpaperSupported()}) and whether they are allowed to change it (with the

  new method <code>WallpaperManager.isWallpaperSettingAllowed()</code>)

</p>

<h2 id="lock-user-icon">Lock Down User Icon</h2>

<p>

  A new user restriction (<code>DISALLOW_SET_USER_ICON</code>) prevents the

  user from changing their user icon. The user’s device owner or profile owner

  can still change the icon. However, a profile owner can only change the user

  icon for the profile it controls.

</p>

<h2 id="health-monitoring">Device Health Monitoring</h2>

<p>

  A device owner or profile owner can use the new

  <code>HardwarePropertiesManager</code> interface to retrieve information

  about device health, such as CPU or GPU temperatures and CPU usage. The new

  monitoring interface is especially useful for monitoring unattended devices

  running in a remote location.

</p>

        >Notifications</a></li>

        <li><a href="<?cs var:toroot ?>preview/features/multilingual-support.html"

        >Language and Locale</a></li>

      </ul>

        <li><a href="<?cs var:toroot ?>preview/features/afw.html"

        >Android for Work</a></li>      </ul>

  </li>

  <li class="nav-section">