Key-value pairs for customization Ivanti Email+ for iOS (Cont.)
1 min
you can configure and customize the following features with key value pairs prompt the device user for password docid\ o4pxaus2z e7y5nh8cumykeyboard extension docid\ o4pxaus2z e7y5nh8cumyenable show pictures docid\ o4pxaus2z e7y5nh8cumyphoto library docid\ o4pxaus2z e7y5nh8cumycalendar customization docid\ o4pxaus2z e7y5nh8cumynotes customization docid\ o4pxaus2z e7y5nh8cumydefault network timeout docid\ o4pxaus2z e7y5nh8cumyapp feedback docid\ o4pxaus2z e7y5nh8cumytroubleshooting docid\ o4pxaus2z e7y5nh8cumymiscellaneous docid\ o4pxaus2z e7y5nh8cumy table 1 key value pairs for customization key value enter/ select one description prompt the device user for password prompt email password (ivanti epmm only) true false true email+ prompts the user for the email password before attempting to connect to the email server when email+ first launches and connects to the email server, email+ provides the user’s email password to the email server false when email+ first launches and connects to the email server, it does not provide the device user’s email password to the server after establishing a connection with the email server, email+ prompts the user for an email password if the email server limits the number of password attempts, it counts the connection as one failed attempt set the value of this key to true if the email server allows only a small number of password attempts example it he email server allows only three attempts, setting this value to true ensures that device users get three attempts, not two attempts default if key value is not configured false allow prompt password 0 1 0 = users are allowed access without a prompt for a password 1 = users are prompted for a password to access email default if key value is not configured 1 mail password (ivanti epmm only) user’s password for the activesync server you can use the ivanti epmm variable $password$ if you have checked save user password in settings > preferences ivanti epmm then passes the user’s password as the value to the device if you plan to use the $password$ variable, be sure to set \<font color="#323232">save user password\</font> to yes before any device users register if a device user was registered before you set save user password, email+ prompts the user to enter the password manually ivanti recommends deleting the key if the password is not being saved on ivanti epmm default if key value is not configured email+ requests device users to enter the password keyboard extension mi ac ios allow custom keyboards true false true email+ allows the use of keyboards extensions false email+ does not allow the use of keyboards extensions this key value pair is case sensitive default if key value is not configured false enable show pictures show pictures default (ivanti epmm only) true false true enables the show pictures option device users automatically see images when opening an email false disables the show pictures option device users must tap show pictures to view images when opening an email device users can override the value you configure by toggling the show pictures option on or off when changing the value of this key, email+ does not change the show pictures option until after completing a full synchronization a full synchronization occurs only when you change certain fundamental key value pairs, like email address, or when the device user uninstalls and reinstalls email+ for ios default if key value is not configured false photo library allow photo library access true false true users can attach photos and video files from their personal photo library on the device false disables access to the personal photo library, including video files, from email+ device users cannot attach photos or videos from their personal photo library however, users can take new photos or videos directly from the email they are composing in email+ and attach to the email this feature allows administrators to clearly separate work related and personal content on device default if key value is not configured true calendar customization calendar default reminder 1 0 5 10 15 30 60 120 1440 2880 specifies the default calendar alert 1 no alert 0 at the time of event 5 5 minutes before the event 10 10 minutes before the event 15 15 minutes before the event 30 30 minutes before the event 60 1 hour before the event 120 2 hours before the event 1440 1 day before the event 2880 2 days before the event device users can edit the alert as desired after creating the event default if key value is not configured 1 calendar default mode tablet day week month list sets the default calendar view on an ipad device users can change the view in the calendar's settings the device user’s choice overrides the default set by the administrator default if key value is not configured week calendar default mode phone day month list sets the default calendar view on an iphone device users can change the view in the calendar's settings the device user’s choice overrides the default set by the administrator default if key value is not configured day calendar reset view threshold a number sets the inactivity threshold after which the calendar view is reset to the default view the inactivity threshold is measured in seconds if the device screen is auto locked or the app is in background for more than the configured time, the default view is loaded when users launch calendar default if key value is not configured 300 seconds the minimum value 120 seconds calendars sync period the kvp can contain numbers 0, 1, 3, 6 where 0 sync all events 1 sync events for 1 month (default) 3 sync events for 3 months 6 sync events for 6 months configures an extended sync period for calendar events after the events are synced, the users can view and search events on all calendar screens notes customization allow notes title true false true email+ users are presented with a separate title field to add a title to a note false a separate title field for a notes is not available, instead, the first line of the note is used as a title default if key value is not configured false default network timeout default network timeout a positive integer sets the app’s default timeout for all activesync network requests the value is measured in seconds example 30 in this example, for activesync network requests, email+ will timeout after 30 seconds default if key value is not configured 90 seconds app feedback feedback email address (ivanti epmm only) an email address device user app feedback and log messages are sent to the email address default if key value is not configured app feedback is not available to email+ users email watermark email watermark any alphanumeric string adds watermark in an email for mail view and mail compose screens supported the text for the watermark is unique to a customer email watermark parameters textcolor, textsize, horizontalspacing, verticalspacing where textcolor is #aarrggbb and textsize, horizontalspacing, and verticalspacing are integer values sets the watermark parameters such as text color, size, horizontal and vertical spacing troubleshooting allow logging (ivanti epmm only) true false true email+ logs data to the device console, and allows the log file to be attached to a feedback email entering true is useful for problem diagnosis if an msal related error occurs during authentication, you can now share the email+ logs using the " collect logs " button displayed in the error alert default if key value is not configured false allow show configuration true false true enables the display of configuration information while setting up email+ on an ios device set this value to true for test devices first, then disable the key value pair when it is time to roll out email+ for ios to device users default if key value is not configured false exit on configuration error true false true email+ simply shuts down without any notification if there is an error in the email+ configuration that is pushed to the device false if email+ encounters an error in the configuration, device users are provided with the option to email the email+ logs the email+ logs are helpful in debugging configuration errors not all configuration errors are considered critical example a missing s/mime signing or encryption certificate is not considered a critical error default if key value is not configured true enable calendar dump true false true enables calendar dump to email+ feedback logs for troubleshooting calendar data is encrypted false disables calendar dump to email+ feedback logs default if key value is not configured false allow logging insecure true false true enables insecure logs for troubleshooting false disables insecure logs for troubleshooting default if key value is not configured false allow logging responses true false true enables to record requests and responses for troubleshooting false disables record requests and responses for troubleshooting default if key value is not configured false miscellaneous disabled features move button local cache mail local cache calendar local cache all attach files openin compose document viewer email priority support modern mail list eas 16 with the disabled features key value pair the admin can disable the values that are enabled by default move button disables the move button in the move to screen in email+ emails are moved without confirmation when users tap on a folder local cache mail disables local caching of email addresses from mail (recipients from to, cc, bcc fields will not be added to local cache) local cache calendar disables local caching of email addresses from calendar (recipients from invitees field will not be added to local cache) local cache all disables all local caching attach files disables the attach files option in email+ openin compose disables opening of files into email+ from other apps document viewer disables opening of attachments in email+ instead, users are provided the open in option to choose an app in which to view the attachment however, some attachments, such as text, eml, audio, and certificate files are opened in email+ the email+ app does not support msg file attachments in open in option configure the value if you are also using the watermark capability in docs\@work if you want watermarks to be shown on all documents, configure the value to disable the document viewer in email+ and use docs\@work exclusively email priority support disables the priority setting for emails modern mail list disables new mail list is, this feature is enabled by default eas 16 disables support for exchange activesync16, for more information, see activesync16 for ios devices https //help ivanti com/mi/help/en us/eml/4 x x/gdi/activesync16 support htm enabled features gmail smart folders rms support fit to width smime suppress certificate email check calendar delegation personal calendar delegated shared mailbox export contacts ai tools microsoft teams meetings graph api with the enabled features key value pair, the admins can enable the values that are disabled by default enables smart folders, all mails, spam, and starred, for gmail accounts enables fetching, displaying and composing of the protected messages if rms support is enabled with configured server, list of fetched templates is displayed in settings/troubleshooting/available permissions due to activesync protocol limitations, maximum of 20 templates are displayed in email+ enables scaling down the size of an email to fit the width of the screen, but will not reduce it to less than 25% of its original size enables automatic certificate verification using email address is suppressed and the user can manually add a certificate from gal and keystore using "add encryption certificate" option the smime suppress certificate email check feature works only when the modern sync engine value is configured for the enabled features key value pair enables the delegated calendar personal calendar to enable personal calendar function this feature is enabled only for modern sync engine which was enabled by default from email+ 4 4 0 release onwards delegated shared mailbox to enable the following options in the settings section delegated mailbox delegated calendar shared mailbox export contacts to automatically sync email+ contacts to native contacts app ai tools to enable apple intelligence controls microsoft teams meetings to enable microsoft teams in the calendar settings graph api to enable microsoft graph based functionality in email+ when enabled, supported microsoft 365 email and calendar features use microsoft graph api always fetch mime true false use this option to set the default value for email+ setting of always fetch mime enable this option only when applications fail to launch when you click the links in the email body default if key value is not configured false allow callkit true false use this option to disable callkit functionality, which is restricted in china by apple customers are advised to set allow callkit to false for all their users in china true callkit functionality enabled false callkit functionality disabled default if key value is not configured true disable analytics true false use this option to disable crash analytics default if key value is not configured false filepass key identifier a unique, sufficiently complex alphanumeric string this key allows admin to enable sharing documents securely between docs\@work and microsoft intunemam protected office365 apps through filepass the value for this key value pair needs to be same for the all the supported productivity apps (docs\@work, email+, and filepass) participating in file sharing with microsoft office 365 apps migrate from email exchange host the value is the previous email exchange host key that was set up on ivanti epmm this key allows the admin to configure ivanti epmm to ivanti neurons for mdm migration for the email exchange host post migration of a device, the email+ app needs to be re synced to continue receiving and sending email messages the content in local folders, such as draft and outbox, will be removed and no longer available the inbox folder should be refreshed for the email list to display eas request frequency limit the recommended value is 400 this kvp is added to specify the throttling limit as x requests per 10 minutes, where x is the kvp value implicit encryption true false the encryption logic for the email+ 4 10 1 is now improved and enhanced in case of any issues related to this update, it can now be rolled back by setting the implicit encryption = true key value pair in the appconnect configuration microsoft office 365 authority and resource url modern auth authority url https //login microsoftonline com/common this kvp is added to specify microsoft office 365 authority url modern auth resource url https //outlook office365 com this kvp is added to specify microsoft office 365 resource url phishing reporting report phishing address email address enabling 'report phishing' option on view screen in the "more" menu phishing email will be sent to email address set in value weekend alerts notifications default weekend alerts true false the email+ app now supports weekend alert notification for new users by default when a user installs the app the first time or after the application is reinstalled after the app was wiped, the "weekend alerts" would be set to notifications default weekend alerts value (the reinstall of email+ app will have no impact as weekend alerts settings are stored in keychain) the default is set to true mail organization organize by date true false disables email threading for email messages when a user installs the app for the first time or after the application wipe, the " organize by thread "is set to organize by date opposite value avaya workplace dialer app default dialer avaya workplace native when "avaya workplace" value is selected, the avaya workplace app is used as a default dialer app native dialer is used as the default value, if avaya workplace dialer is not available or installed in the email+app settings > contacts "default dialer" option is available with pre selected default dialer allowed dialers avaya workplace the allowed dialers kvp allows the email+ app to use the avaya workplace dialer app as the default dialer along with the native dialer allow universal links true false this key allows the admin to open links in the associated application(like native ios mail app) if the value is set to false the link opens in the web\@work app custom microsoft authentication library (msal) configuration options msal resource scope defines the resource scope required by msal to acquire access tokens for protected resources specify the multiple scopes with a single comma separated string (for example, user read, mail read, and so on) this kvp is optional and required only if the customer has their own email+ azure application in their azure tenant msal client id replaces the default application id used by the microsoft authentication library (msal) with a custom value this kvp is optional and required only if the customer has their own email+ azure application in their azure tenant msal redirect url redirects the url for msal this kvp is optional and required only if the customer has their own email+ azure application in their azure tenant msal internal web view true false true msal should use the internal web view (wkwebview) false msal should use safari view controller default if key value is not configured false modern auth with certificate based authentication is not supported by safari view controller msal disable authenticator use true false this key allows the admin to disable the launching of microsoft authenticator to authorization purpose true disables launching microsoft authenticator false forces launching microsoft authenticator if it's installed default if key value is not configured false this kvp is optional; it's required for per app vpn configuration if microsoft authenticator is not tunnelled so it's not part of the authentication data flow graph api calls configuration options email graph host msal graph resource scope msg min allowed auth mode realtime notifications protocol graph microsoft com https //graph microsoft com/ default modern auth 1 this key allows the admin to enable or disable graph api operations
