Push notification support for device management

The DMClient CSP supports the ability to configure push-initiated device management sessions. Using the Windows Notification Services (WNS), a management server can request a device to establish a management session with the server through a push notification. A device is provided with a PFN for an application. This provision results in the device getting configured, to support a push to it by the management server. Once the device is configured, it registers a persistent connection with the WNS cloud (Battery Sense and Data Sense conditions permitting).

To initiate a device management session, the management server must first authenticate with WNS using its SID and client secret. Once authenticated, the server receives a token to initiate a raw push notification for any ChannelURI. When the management server wants to initiate a management session with a device, it can utilize the token and the device ChannelURI, and begin communicating with the device.

For more information about how to get push credentials (SID and client secret) and PFN to use in WNS, see Get WNS credentials and PFN for MDM push notification.

Because a device may not always be connected to the internet, WNS supports caching notifications for delivery to the device once it reconnects. To ensure your notification is cached for delivery, set the X-WNS-Cache-Policy header to Cache. Additionally, if the server wants to send a time-bound raw push notification, the server can use the X-WNS-TTL header that will provide WNS with a time-to-live binding so that the notification will expire after the time has passed. For more information, see Raw notification overview (Windows Runtime apps).

The following restrictions are related to push notifications and WNS:

  • Push for device management uses raw push notifications. This restriction means that these raw push notifications don't support or utilize push notification payloads.

  • Receipt of push notifications is sensitive to the Battery Saver and Data Sense settings on the device. For example, if the battery drops below certain thresholds, the persistent connection of the device with WNS will be terminated. Additionally, if the user is utilizing Data Sense and has exceeded their monthly allotment of data, the persistent connection of the device with WNS will also be terminated.

  • A ChannelURI provided to the management server by the device is only valid for 30 days. The device automatically renews the ChannelURI after 15 days and triggers a management session on successful renewal of the ChannelURI. It's strongly recommended that, during every management session, the management server queries the ChannelURI value to ensure that it has received the latest value. This will ensure that the management server won't attempt to use a ChannelURI that has expired.

  • Push isn't a replacement for having a polling schedule.

  • WNS reserves the right to block push notifications to your PFN if improper use of notifications is detected. Any devices being managed using this PFN will cease to have push initiated device management support.

  • On Windows 10, version 1511 as well as Windows 8 and 8.1, MDM Push may fail to renew the WNS Push channel automatically causing it to expire. It can also potentially hang when setting the PFN for the channel.

    To work around this issue, when a 410 is returned by the WNS server when attempting to send a Push notification to the device the PFN should be set during the next sync session. To prevent the push channel from expiring on older builds, servers can reset the PFN before the channel expires (~30 days). If they’re already running Windows 10, there should be an update available that they can install that should fix the issue.

  • On Windows 10, version 1511, we use the following retry logic for the DMClient:

    • If ExpiryTime is greater than 15 days, a schedule is set for when 15 days are left.
    • If ExpiryTime is between now and 15 days, a schedule set for 4 +/- 1 hours from now.
    • If ExpiryTime has passed, a schedule is set for 1 day +/- 4 hours from now.
  • On Windows 10, version 1607, we check for network connectivity before retrying. We don't check for internet connectivity. If network connectivity isn't available, we'll skip the retry and set schedule for 4+/-1 hours to try again.

Get WNS credentials and PFN for MDM push notification

To get a PFN and WNS credentials, you must create a Microsoft Store app.

  1. Go to the Windows Dashboard and sign in with your developer account.

    mdm push notification1.

  2. Create a new app.

    mdm push notification2.

  3. Reserve an app name.

    mdm push notification3.

  4. Click Services.

    mdm push notification4.

  5. Click Push notifications.

    mdm push notification5.

  6. Click Live Services site. A new window opens for the Application Registration Portal page.

    mdm push notification6.

  7. In the Application Registration Portal page, you'll see the properties for the app that you created, such as:

    • Application ID
    • Application Secrets
    • Microsoft Store Package SID, Application Identity, and Publisher.

    mdm push notification7.

  8. Click Save.

  9. Close the Application Registration Portal window and go back to the Windows Dev Center Dashboard.

  10. Select your app from the list on the left.

  11. From the left nav, expand App management and then click App identity.

    mdm push notification10.

  12. In the App identity page, you'll see the Package Family Name (PFN) of your app.