Share via

Mapping OMA Client Provisioning XML to EMAIL2 Configuration Service Provider (POP3)

  • Article

4/8/2010

The following table shows OMA WAP Configuration Service Provider parm names.

Characteristic Parm name Values Description EMAIL2 Configuration Service Provider

APPLICATION

APPID

110

n/a

SERVICETYPE

APPLICATION

PROVIDER-ID

N/A

Used to bind SMTP and POP3 (or IMAP) settings together.

Used by Configuration Service Provider but not stored.

APPLICATION

NAME

N/A

Email setting name shown to the user.

SERVICENAME

APPLICATION

TO-NAPID

NAPID of access point

The network access point used.

Stored and used to determine network connection

APPADDR

ADDR

N/A

Specifies the address of the receiving POP3 host. If there is no need to specify PORT information then APPLICATION/ADDR can be used instead of APPADDR characteristic.

INSERVER

APPADDR

ADDRTYPE

IPV6

Defines the type of the value in the ADDR parameter.

Not necessary.

PORT

PORTNBR

110 is the default port.

995

or a non-standard port number

Port number to connect to.

INPORTNBR

(new parm name)

PORT

SERVICE

110 default,

STARTTLS,

995

Indicates the protocol used. It is either Secure or Unsecure. If the value is STARTTLS then Secure POP over TLS should be used, as specified in RFC2595.

Value 110 indicates an Unsecure POP connection to the port specified in PORTNBR.

995 indicates that a Secure connection is made to the port specified in PORTNBR.

Not necessary.

APPAUTH

AAUTHTYPE

LOGIN, default.

APOP, CRAM-MD5, DIGEST-MD5, GSSAPI, KERBEROS_V4, PLAIN, SKEY

Specifies the authentication mechanism used.

Not necessary.

APPAUTH

AAUTHNAME

N/A

Login name for POP mailbox

AUTHNAME

APPAUTH

AAUTHSECRET

N/A

Login password for POP mailbox

AUTHSECRET

New and Unsupported OMA WAP Configuration Service Provider Parm Names

The following table shows the new and unsupported OMA WAP Configuration Service Provider parm names.

Parm name Description

APPID

APPID maps to SERVICENAME and is used to identify whether the XML blob is configuring POP3, IMAP or SMTP settings. The mapping is not direct. The mapping is as follows:

  • APPID=110, SERVICETYPE=POP3;
  • APPID=143, SERVICETYPE=IMAP4;
  • APPID=25, SERVICETYPE=SMTP

PROVIDER-ID

Used by the Configuration Service Provider but not stored.

This parm name is only used at provisioning time by the Configuration Service Provider to link SMTP to POP and IMAP XML.

PROVIDER-ID is an arbitrary unique ID, not a GUID, which is only used to bind POP3 and IMAP to SMTP settings together in a single account. It is used specifically in cases where an OMA WAP XML blob is used to create multiple email accounts.

TO-NAPID

Stored and used to determine which network connection to use.

TO-NAPID uses a text value from the Operator to identify the network connection name to be used by the provisioned account. The Operator friendly name for the connection is mapped to an actual Connection Manager GUID.

For Email provisioning, identify and bind the account to a network connection GUID as follows:

  1. Store the TO-NAPID value as a property on the Messaging store at provisioning time.
  2. Flag the account to acquire and specify a ConMan GUID when a TO-NAPID value is set on a Messaging store.
  3. Use the TO-NAPID value to query Connection Manager and acquire the ConMan GUID before attempting to connect to the server.
    • Connection Manager returns the ConMan GUID of the data connection provisioned with this name and uses this data connection to connect to the server.
    • This assumes the same connection name has been provisioned as a data connection prior to email provisioning.
    • When no ConMan GUID exists, for example if the user deleted a Connectoid, attempt to connect using the Connection Manager API. Do this by using ConnMgrMapURL() to pass in the server name preceded by "https://", as necessitated by the API. For example, pass in "https://mail.earthlink.com".

ADDRTYPE

Not supported. Not necessary.

Used to specify whether an address is IPV6 or IPV4. Windows Mobile 6.5 supports IPV6 address formats so no address format designation is necessary.

PORTNBR

Maps to a new parm name to specify a port number

Maps to new INPORTNBR, that is a new parm name for setting the port number of an account.

SERVICE

Not supported. Not necessary.

The following three values are supported for determining the type of secure connection to use when connecting to a POP3 server:

  • 110, Establish an Unsecured connection
  • 995, Establish an SSL Connection
  • STARTTLS, Connect and issue the Start TLS command

It is not essential that Messaging use this setting because it queries the server with multiple attempts to establish an SSL connection.

AAUTHTYPE

Not supported. Not necessary.

Messaging queries the server to find out what authentication method is supported and has an internal prioritization for which to use. There is no way at the transport level to force the use of a particular authentication method.

See Also

Reference

APPLICATION Configuration Service Provider

Concepts

APPLICATION E-Mail Configuration Service Provider for POP3 Example

Other Resources

EMAIL2 Configuration Service Provider Mapping to OMA DM E-mail XML