Exchange Web Services (EWS) MDM payload settings for Apple devices
You can configure Microsoft Exchange accounts for users of Mac computers enrolled in a mobile device management (MDM) solution. Use the Exchange Web Services (EWS) payload to enter the user’s settings for your Microsoft Exchange Server.
For information about requirements and supported features, see Integrate Apple devices with Microsoft Exchange.
The Exchange Web Services (EWS) payload supports the following. For more information, see Payload information.
Supported payload identifier: com.apple.ews.account
Supported operating systems and channels: macOS user.
Supported enrollment types: User Enrollment, Device Enrollment, Automated Device Enrollment.
Duplicates allowed: True—more than one Exchange Web Services payload can be delivered to a user.
You can use the settings in the table below with the Exchange Web Services payload.
Setting | Description | Required | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Account name | The display name for the account. | Yes | |||||||||
Account user name | The user name with the optional domain. | Yes | |||||||||
Account email address | The email address for the account. | Yes | |||||||||
Account password | The password of the user account. If you leave this field empty, users must enter their password after the payload is installed on the device. | No | |||||||||
Use OAuth for authentication | Specifies whether the connection should use OAuth for authentication. If OAuth is specified, the password field should be left empty. | No | |||||||||
OAuth URL | The URL to load into a web view for OAuth authentication if auto-discovery isn’t used. Also requires the hostname. | No | |||||||||
Internal Exchange hostname | The IP address or fully qualified domain name (FQDN) of the internal Exchange host. | Yes | |||||||||
Internal server path | The server path for the internal Exchange host. | No | |||||||||
Use SSL for internal server | When the Use SSL option is selected and the internal server’s SSL certificate isn’t issued by a trusted certificate authority known to the devices, use the Certificates payload to add any root or intermediate certificates that are necessary to validate the internal server’s SSL certificate. | No | |||||||||
External Exchange hostname | The IP address or fully qualified domain name (FQDN) of the external Exchange host. | No | |||||||||
External server path | The server path for the external Exchange host. | No | |||||||||
Use SSL for external server | When the Use SSL option is selected and the external server’s SSL certificate isn’t issued by a trusted certificate authority known to the devices, use the Certificates payload to add any root or intermediate certificates that are necessary to validate the external server’s SSL certificate. | No | |||||||||
Allow Mail Drop | Specify whether Mail Drop appears as an option when sending large files using the Mail app. | No | |||||||||
Note: Each MDM vendor implements these settings differently. To learn how various Exchange Web Services (EWS) settings are applied to your users, consult your MDM vendor’s documentation.