Android Enterprise zero-touch DPC extras generator

It's a common occurrence to see a full QR/NFC payload pasted into the DPC extras field of a zero-touch configuration, and while it may function, it's not best practice.

To assist in building better configurations, the below form has been created to allow organisations to create a custom payload, similar to that of the QR generators, but provide only the relevant details for zero-touch. Once generated, this can be pasted directly into the zero-touch configuration DPC extras field.

Do you have a JSON payload from your EMM already? Use the form at the bottom of this page to convert it!

No information is stored. If you refresh the page, everything will be reset. This is intentional as I have no interest in holding on to your JSON information, Wi-Fi details, or enrolment tokens. That said, as with all third-party applications you use this at your own risk. Check with your boss before you use this tool if you feel you need to.

When you click Generate JSON, all submitted information is processed locally, and the returned data is embedded ephemerally in this page. Edit the submitted text and click extract again to regenerate it, or refresh the page to clear it.

Where's the DPC input?! - There's no need for this. The DPC is selected from the zero-touch configuration.

Configure DPC Extras

Description

DPC extras allow organisations to pre-configure the DPC with options during enrolment. These may include the EMM server address, staging credentials, enrolment tokens, and more.

Your EMM will have the most up-to-date support DPC extras, however I maintain a resource here which is occasionally also updated by the community.

The generator automatically adds brackets and spacing, so just enter the extras one-per-line, e.g.:

"serverurl":"your.server.com",
"gid":"yourGroupID",
"un":"staginguser",
"pw":"example"

For AMAPI-based EMMs (Intune, NinjaOne, etc) if not using the AMAPI generator it would require:

"com.google.android.apps.work.clouddpc.EXTRA_ENROLLMENT_TOKEN": "YourEnrolmentToken" 

Remember: This field requires valid JSON, so don't forget those commas on all but the last line of extras, otherwise the QR code will error.

Head's up

DPC extras should be closely guarded as they may grant access to the organisation's EMM platform and sensitive corporate resources. If details are compromised, they should be revoked immediately and new ones generated.

Configure provisioning options

Description

These provisioning options are optional configuration items that affect the behaviour during and after the provisioning process. Here's a brief description of each:

android.app.extra.PROVISIONING_LEAVE_ALL_SYSTEM_APPS_ENABLED
If set to true, all system apps will be enabled during the provisioning process. If false, only the necessary, vital system apps required for device functionality will be enabled. Learn more about vital apps.
android.app.extra.PROVISIONING_USE_MOBILE_DATA
If set to true, the device will be forced to use mobile data during the provisioning process. If false, the device will use Wi-Fi.
android.app.extra.PROVISIONING_KEEP_SCREEN_ON
If set to true, the device's screen will stay on during the provisioning process. If false, the screen may turn off according to the device's usual settings. Note this is only applicable for Android 13. Below 13 this has no impact. Above 13 it is enabled by default.
android.app.extra.PROVISIONING_ALLOW_OFFLINE
If set to true, the device can be provisioned offline, provided the DPC supports it. If false, an internet connection is required for provisioning.
android.app.extra.PROVISIONING_SKIP_ENCRYPTION
If set to true, the device will skip the encryption step during provisioning. If false, the device will be encrypted as part of the provisioning process.
android.app.extra.PROVISIONING_SKIP_EDUCATION_SCREENS
If set to true, the device will skip some of the introductory screens during the provisioning process. If false, all provisioning screens will be shown as normal.
Locale & timezone configuration

Description

When setting up a new device or re-provisioning an existing one, the android.app.extra.PROVISIONING_LOCALE key can be configured to specify the locale. This key expects a string value in the format of language-country, where language is a two-letter ISO 639-1 language code and country is a two-letter ISO 3166-1 alpha-2 country code. See the example reference provided next to the input for guidance.

The android.app.extra.PROVISIONING_TIME_ZONE key is used during the provisioning of Android devices to set the device time zone. Modern Android devices can pick this up automatically and with Wi-Fi only, but for older Android versions (sub 12) it is far more rigid, and this setting avoids frustrating users down the line.

These settings are particularly useful in use cases where devices need to be configured with specific time and region parameters, and allows admins to configure these ahead of time when staging devices for global distribution.

Generate JSON

Convert an existing JSON payload

Paste an existing QR JSON payload provided - presumably by an EMM - to convert it into a zero-touch-friendly DPC extras payload.

Description

This conversion tool allows you to input a full QR JSON payload and retrieve only the relevant information for the zero-touch DPC extras field.

Usage:

  1. Paste your JSON payload into the input box.
  2. Click Convert.
  3. The form will display the converted JSON if the relevant key(s) exist(s).

If the JSON is not valid, an error will be shown. This form will not attempt to correct invalid keys or missing data.

Convert JSON

mail Reply by email | edit_note Edit this page.