E-Mail APPLICATION Configuration Service Provider

4/8/2010

OMA considers each transport to be an application and requires a corresponding APPLICATION configuration service provider.

Note

This configuration service provider is managed over the OMA Client Provisioning protocol. For OMA DM, you use the EMAIL2 Configuration Service Provider to create a POP3 or IMAP4 account.

The following list shows the supported EMAIL transports:

• 25, for Simple Mail Transfer Protocol (SMTP)
• 110, for Post Office Protocol 3 (POP3)
• 143, for Internet Message Access Protocol (IMAP)

The following image shows the configuration service provider in tree format as used by OMA Client Provisioning.

In the root characteristic, the default security roles are defined. The default security role maps to each subnode unless specific permission is granted to the subnode. The following table shows the default settings

Access type	Read/Write
Roles allowed to query and update setting	Manager Operator Operator - TPS

Characteristics

• APPLICATION
  The root node for the APPLICATION object.

• APPAUTH
  This characteristic is used to specify authentication information.

• APPADDR
  This characteristic is used specify the address of the incoming or outgoing e-mail server.

• PORT
  This characteristic is used in the APPADDR characteristic.

Parameters

• APPID
  The APPID parameter is used in the APPLICATION characteristic to differentiate application protocols.

  The following list shows the port numbers that are used to identify the individual APPLICATION configuration service providers.

  • 25, for SMTP
  • 110, for POP3
  • 143, for IMAP

  You can specify only one folder for each APPLICATION section. The folder should be defined outside of any resource that uses the NAME parameter.

  APPIDs must be registered with OMA. When you register an APPID, you should also register application-specific parameters that are not defined in the OMA Client Provisioning XML schema.

  The following table shows the default settings.

  Access type	Read/Write
  Data type	string
  Occurs	One

• AAUTHNAME
  The AAUTHNAME parameter is used in the APPAUTH characteristic to provide the ID used to authenticate the user. This is a Messaging specific parameter. This parameter is used in the following APPIDs:

  • 110, Required for POP3
  • 143, Required for IMAP

  The following table shows the default settings.

  Access type	Read/Write
  Data type	string
  Occurs	ZeroOrOne

• AAUTHSECRET
  The AAUTHSECRET parameter is used in the APPAUTH characteristic to specify the Login password for POP mailbox.

  The following table shows the default settings.

  Access type	Read/Write
  Data type	string
  Occurs	ZeroOrOne

• ADDR
  The ADDR parameter is used in the APPADDR characteristic to specify the address of the receiving POP3 or IMAP4 application host. If there is no need to specify PORT information, then APPLICATION/ADDR can be used instead of the APPADDR characteristic.

  The following table shows the default settings.

  Access type	Read/Write
  Data type	string
  Occurs	ZeroOrMore

• FROM
  The FROM parameter is used in the APPLICATION characteristic to specify the user's e-mail address.

  Note

  This parameter is used only when the APPID is 25.

  Format the data for this parameter as specified in RFC822. The field name corresponds to FROM field in the e-mail message header as specified in RFC822. This field can hold a nickname according to RFC 2822 (Example: "Nickname" <nick.name@domain.com>).

  The following table shows the default settings.

  Access type	Read/Write
  Data type	E-mail address
  Occurs	ZeroOrOne

• NAME
  The NAME parameter is used in the APPLICATION characteristic to specify the E-mail setting name shown to the user.

  The following table shows the default settings.

  Access type	Read/Write
  Data type	string
  Occurs	ZeroOrOne

• PORTNBR
  The PORTNBR parameter is used in the PORT characteristic to specify the port number to connect to. Use 110 or 995 or some non-standard port number.

  The following table shows the default settings.

  Access type	Read/Write
  Data type	string
  Occurs	ZeroOrOne

• PROVIDER-ID
  The PROVIDER-ID parameter is used in the APPLICATION characteristic to bind SMTP and POP3 settings together, and to identify an application service access point.

  The following table shows the default settings.

  Access type	Read/Write
  Data type	string
  Occurs	ZeroOrOne

• TO-NAPID
  The TO-NAPID parameter is used in the APPLICATION characteristic to specify the NAPID of the access point. If multiple TO-NAPID parameters are specified, only the first TO-NAPID value will be stored.

  The following table shows the default settings.

  Access type	Read/Write
  Data type	string
  Occurs	ZeroOrOne

See Also

Reference

APPLICATION Configuration Service Provider