Setting up Gmail with Android Enterprise

You can deploy Gmail to Android Enterprise devices if you have set up Core for Android Enterprise.

If you want to set up Email+ with Android Enterprise, please see Email+ for Android Guide.

Add Gmail to the App Catalog on Core as you would any Android Enterprise app. That is, in the Admin Portal, in Apps > App Catalog, add Gmail from Google Play. When adding it, be sure to select Install this app for Android enterprise.

When you add the Gmail app, its app configurations are displayed in the Configuration Choices section. Edit these choices according to the following table:

Table 1. Gmail configuration parameters

Settings

Description

Email Address

Enter substitution variables to define the email address.

Typically, you enter $EMAIL$.

You can also enter combinations of these variables, depending on your ActiveSync server requirements:

$USERID$, $USER_CUSTOM1$, $USER_CUSTOM2$, $USER_CUSTOM3$, $USER_CUSTOM4$

Hostname or Host

Enter the host name of the mail server to use. Enter the fully qualified domain name of the Exchange server or the Standalone Sentry you are using.

Username

Use variables to define the username for the email account.

SSL Required

Select if you want secure communication using https: to the server that you specified for Exchange host.

Trust all certificates

Select only if you want the app to automatically accept untrusted certificates. Use this option only for debugging or development when working in a test environment.

Login certificate alias

Enter the alias for the login certificate. The value should be a string alias representing a certificate with private key stored in the work profile keystore. For example: $CERT_ALIAS:<certificate config name>$

When a certificate alias is used with a password, Gmail does not send the certificate alias to the server and an “Unable to connect to server” error is displayed. This is a Google issue.

Default email signature

$USERID$

Default sync window

Use the Default sync window drop-down menu to select an interval in minutes for the device to sync with app or data updates.