PROBLEM
I want to create custom iOS configuration profiles for my users.

ENVIRONMENT

• On-Premise Server + WebMail Installations: Version 6.0 > Current Version
• Webmail Only Installations: Version 6.0 > Current Version

CAUSE
Custom iOS profiles requirement.

RESOLUTION

The iPhone Configuration Utility lets you easily create, maintain, encrypt, and install configuration profiles, track and install provisioning profiles and authorized applications, and capture device information including console logs.

Configuration profiles are XML files that contain device security policies, VPN configuration information, Wi-Fi settings, APN settings, Exchange account settings, mail settings, and certificates that permit iPhone and iPod touch to work with your enterprise systems.

This guide will take you through how it can be used with Atmail.

Download

iPhone Configuration Utility 3.3 for Mac OS X

iPhone Configuration Utility 3.3 for Windows

Setting Up Mail + CalDAV Profile

Setup an iPhone or iPod touch Mail and CalDAV profile for imap mail and CalDAV calendar access.

Create new Atmail user

Click 'New User' to create a new email account. Specify the new user's details in the appropriate fields, using the green ”+” (plus sign) and red ”-” (minus sign) buttons to add or remove fields as needed. Fields marked with an asterisk “*” are required. You can toggle optional fields using the “More Information” drop-down box. Click the “Create User” button when finished.

Note: A new user is not required. You can setup iPhone profile using pre-existing accounts.

Create new configuration profile

Click onto 'Configuration Profiles' on the library. Click 'New' to create a new profile. Configure the profile as follows, changing details to suit.

General (mandatory)

Name: Test Atmail Email + Calendar

Identifier: Atmail Test

Organization: Atmail

Description: Test Atmail Email + Calendar Profile

Email

Account Description: Test Atmail Email

Account Type: IMAP

User Display Name: Atmail Test

Email Address: test@domain.com

Incoming Mail

Mail Server: 192.168.0.16 Port: 143

Username: test@domain.com

Authentication Type: Password

Password: test (leave blank to prompt the user on the device to enter the password)

Use SSL: Select if you have SSL setup on your mail server.

Outgoing Mail

Mail Server: 192.168.0.16 Port: 25

Username: test@domain.com

Authentication Type: Password

Outgoing password same as incoming: yes

Use SSL: Select if you have SSL setup on your mail server.

CalDAV

Account Description: Test Atmail CalDAV

Account Hostname: 192.168.0.16 Port: 8008

Principal URL: leave blank

Account Username: test@domain.com

Account Password: test (leave blank to prompt the user on the device to enter the password)

Use SSL: Select if you have SSL setup on your mail server.

Export configuration profile

Click onto 'Export' to export your newly created profile.

Under 'Security' select 'None'.

Enter file name and save your newly created profile.

Upload configuration file to your server

Make a new directory within your webmail folder called 'profiles'.

/usr/local/atmail/webmail/profiles/

Upload your newly created profile to this folder.

/usr/local/atmail/webmail/profiles/Atmail.Test-Mail+Calendar.mobileconfig

Install configuration profile onto your iPhone or iPod touch

Access the configuration file via Safari on your iPhone or iPod touch.

http://192.168.0.16/mail/profiles/Atmail.Test-Mail+Calendar.mobileconfig

Click onto 'More Details' to see configuration profile details.

Click onto 'Install' then 'Install Now' to install the configuration profile onto your iPhone or iPod touch.

Installation of the configuration profile onto your iPhone or iPod touch is now complete.

Sample Screenshots