User Guide

Appendix B Configuration Profile Format 73

Email Payload

The email payload is designated by the com.apple.mail.managed PayloadType value.

This payload creates an email account on the device. In addition to the settings

common to all payloads, this payload defines the following:

maxFailedAttempts Number, optional. Default 11. Allowed range [2...11]. Specifies the

number of allowed failed attempts to enter the passcode at the

iPhone lock screen. Once this number is exceeded, the device is

locked and must be connected to its designated iTunes in order

to be unlocked.

maxInactivity Number, optional. Default Infinity. Specifies the number of days

for which the device can be idle (without being unlocked by the

user) before it’s locked by the system. Once this limit is reached,

the device is locked and the passcode must be entered.

maxPINAgeInDays Number, optional. Default Infinity. Specifies the number of days

for which the passcode can remain unchanged. After this

number of days, the user is forced to change the passcode

before the device is unlocked.

minComplexChars Number, optional. Default 0. Specifies the minimum number of

complex characters that a passcode must contain. A “complex”

character is a character other than a number or a letter, such as

&%$#.

minLength Number, optional. Default 0. Specifies the minimum overall

length of the passcode. This parameter is independent of the

also optional minComplexChars argument.

requireAlphanumeric Boolean, optional. Default NO. Specifies whether the user must

enter alphabetic characters (“abcd”), or if numbers are sufficient.

pinHistory Number, optional. When the user changes the passcode, it has

to be unique within the last N entries in the history. Minimum

value is 1, maximum value is 50.

manualFetchingWhenRoaming Boolean, optional. If set, all push operations will be disabled

when roaming. The user has to manually fetch new data.

maxGracePeriod Number, optional. The maximum grace period, in minutes, to

unlock the phone without entering a passcode. Default is 0,

that is no grace period, which requires a passcode immediately.

Key Value

EmailAccountDescription String, optional. A user-visible description of the email account,

shown in the Mail and Settings applications.

EmailAccountName String, optional. The full user name for the account. This is the

user name in sent messages, etc.

EmailAccountType String, mandatory. Allowed values are EmailTypePOP and

EmailTypeIMAP. Defines the protocol to be used for that

account.