Share via


DMAcc Configuration Service Provider

4/8/2010

This configuration service provider handles the OMA DM DMAcc management object that stores the OMA DM server-specific settings. These settings are collectively referred to as an OMA DM account. The DMAcc node is the parent to all OMA DM account nodes.

Note

Access to this Configuration Service Provider is determined by security roles. Because OEMs and mobile operators can selectively disallow access, ask them about the availability of this Configuration Service Provider. For more information about roles, see Security Roles and Default Roles for Configuration Service Providers.

The following image shows the management object used by OMA DM.

Bb737293.d688f621-a64a-4c26-bf54-4f32e5bb3998(en-us,MSDN.10).gif

The following table shows the default settings for DMAcc. The default security role maps to each subnode unless specific permission is granted to the subnode.

Data type

node

Roles allowed to query and update setting

Operator

Manager

Operator TPS

Bb737293.security(en-us,MSDN.10).gifSecurity Note:
Security roles for the DMAcc Configuration Service Provider and the DMS Configuration Service Provider should be synchronized. Because they share the same data store, having different roles could result in elevated privileges.
  • DMAcc
    The root node for the DMAcc object. The following table shows the default settings.

    Data type

    node

    Access Type

    Get

    Occurs

    One

    Scope

    Permanent

  • DMAcc/<x>
    A placeholder for one or more SyncML DM account nodes. The <x> is a unique identifier for the OMA DM account settings, making each DMAcc/<x> node the unique parent node for an account. This node name is assigned by the server at bootstrap. If the device is bootstrapped with the w7 Application Configuration Service Provider, then the value for <x> is a hash of the server ID.

    The following table shows the default settings.

    Data type

    node

    Access Type

    Add, Get, Delete, Replace

    Occurs

    ZeroOrMore

    Scope

    Dynamic

  • DMAcc/<x>/Addr
    Stores various addresses. The type of address stored is specified by the value of the AddrType node.

    The following table shows the default settings.

    Data type

    chr

    Access Type

    Add, Get, Delete, Replace

    Occurs

    One

    Scope

    Dynamic

  • DMAcc/<x>/AddrType
    Specifies the format and interpretation of the <x>/Addr node value. The value is encoded as an inline string, as specified in the following table:

    Address Type Value Description

    HTTP

    1

    URL (See RFC2396)

    The following table shows the default settings.

    Data type

    chr

    Access Type

    Add, Get, Delete, Replace

    Occurs

    One

    Scope

    Dynamic

  • DMAcc/<x>/PortNbr
    Specifies the port number to use for the current bearer, if applicable. This must be a decimal number and must fit within the range of a 16-bit unsigned integer.

    The following table shows the default settings.

    Data type

    chr

    Access Type

    Add, Get, Delete, Replace

    Occurs

    ZeroOrOne

    Scope

    Dynamic

  • DMAcc/<x>/ConRef
    Points to connectivity information that is stored elsewhere in the device. This is used to locate connectivity information that is stored separately from the SyncML DM management object.

    This should provide a logical link to an existing connectivity object anywhere in the device.

    The following table shows the default settings.

    Data type

    chr

    Access Type

    Add, Get, Delete, Replace

    Occurs

    One

    Scope

    Dynamic

  • DMAcc/<x>/ServerId
    The server identifier for the current OMA DM account. This value is set during bootstrap.

    Note

    After the ServerId is set, it cannot be changed in a regular OMA DM session.

    Note

    In a server trigger, the client treats ServerID as UTF-8 encoding, instead of US-ASCII character. UTF-8 is the super set of US-ASCII.

    The following table shows the default settings.

    Data type

    chr

    Access Type

    Add, Get, Delete

    Occurs

    One

    Scope

    Dynamic

  • DMAcc/<x>/ServerPW
    Holds the password or secret that the server uses to authenticate itself to the client.

    The following table shows the default settings.

    Data type

    chr

    Access Type

    Add, Delete, Replace

    Occurs

    One

    Scope

    Dynamic

  • DMAcc/<x>/ServerNonce
    Stores the next nonce that the server will use to authenticate itself to the client. Nonce refers to a number used once. It is often a random or pseudo-random number issued in an authentication protocol to ensure that old communications cannot be reused in repeat attacks.

    The following table shows the default settings.

    Data type

    bin

    Access Type

    Add, Delete, Replace

    Occurs

    One

    Scope

    Dynamic

  • DMAcc/<x>/UserName
    Stores the name of the user or device. This information is used in OMA DM authentication.

    The following table shows the default settings.

    Data type

    chr

    Access Type

    Add, Get, Delete, Replace

    Occurs

    One

    Scope

    Dynamic

  • DMAcc/<x>/ClientPW
    Holds the password or secret that the client uses to authenticate itself to the server.

    The following table shows the default settings.

    Data type

    chr

    Access Type

    Add, Delete, Replace

    Occurs

    One

    Scope

    Dynamic

  • DMAcc/<x>/ClientNonce
    Stores the next nonce that the client will use to authenticate itself to the server. Nonce refers to a number used once. It is often a random or pseudo-random number issued in an authentication protocol to ensure that old communications cannot be reused in repeat attacks.

    The following table shows the default settings.

    Data type

    bin

    Access Type

    Add, Delete, Replace

    Occurs

    One

    Scope

    Dynamic

  • DMAcc/<x>/AuthPref
    (Optional) A string-valued parameter whose possible values are the names of the various SyncML authentication types. For example, syncml:auth-md5. If this node is present, the client uses this authentication type when connecting to the server. The use of this node reduces the number of round trips between client and server that would be caused by authentication challenges.

    The following table shows the default settings.

    Data type

    chr

    Access Type

    Add, Get, Delete, Replace

    Occurs

    ZeroOrOne

    Scope

    Dynamic

  • DMAcc/<x>/Name
    (Optional) Stores the name for the current SyncML DM account.

    The following table shows the default settings.

    Data type

    chr

    Access Type

    Add, Get, Delete, Replace

    Occurs

    ZeroOrOne

    Scope

    Dynamic

  • DMAcc/<x>/Ext
    Stores extended parameters.

    The following table shows the default settings.

    Data type

    Node

    Access Type

    Get

    Occurs

    One

    Scope

    Dynamic

  • DMAcc/<x>/Ext/Microsoft
    Stores Microsoft-specific parameters.

    The following table shows the default settings.

    Data type

    node

    Access Type

    Get

    Occurs

    One

    Scope

    Dynamic

  • DMAcc/<x>/Ext/Microsoft/Role
    Specifies the role mask that the DM session runs with when it communicates with the server.

    If this parameter is not present, the DM session is given the role mask of the DM session that the server is created.

    Note

    The acceptable access roles for this node cannot be more than the roles assigned to the DMS object.

    The following table shows the default settings.

    Data type

    chr

    Access Type

    Get, Replace

    Occurs

    One

    Scope

    Dynamic

  • DMAcc/<x>/Ext/Microsoft/DefaultEncoding
    Specifies whether the DM client will use WBXML or XML for the DM package when communicating with the server.

    The following list shows the possible values:

    • application/vnd.syncml.dm+xml (Default)
    • application/vnd.syncml.dm+wbxml

    The following table shows the default settings.

    Data type

    Chr

    Access type

    Get, Replace, Add, Delete

    Occurs

    ZeroOrOne

    Scope

    Dynamic

  • DMAcc/<x>/Ext/Microsoft/UseHwDevID
    Specifies whether to use the hardware ID for the ./DevInfo/DevID node in the DM accoung to identify the device.

    The following list shows the possible values:

    • If the value is True, the hardware device ID will be provided at the ./DevInfo/DevID node and Source LocURI for the DM package that is sent to the server: IMEI is returned for a GSM device, the ESN for a CDMA device, and a GUID for a non-radio device. These values and their formats are described in the DevInfo Configuration Service Provider.
    • If the value is False or absent, an application-specific GUID is returned rather than the hardware device ID. This is the default behavior.

    The following table shows the default settings.

    Note

    Parent node roles for security permissions do not apply to this node.

    The following table shows the default settings.

    Data type

    bool

    Access Type

    Add, Get, Delete, Replace

    Occurs

    ZeroOrOne

    Scope

    Dynamic

    Roles allowed to query and update

    Manager

    Operator TPS

  • DMAcc/<x>/Ext/Microsoft/BackCompatRetryDisabled
    Specifies whether to retry resending a package with an older protocol version (for example, 1.1) in the SyncHdr (not including the first time).

    Valid values are:

    FALSE: back compat retry is enabled

    TRUE: back compat retry is disabled

    Data type

    bool

    Access type

    Add, Get, Replace, Delete

    Occurs

    ZeroOrOne

    Default value

    FALSE

  • DMAcc/<x>/Ext/Microsoft/ConnRetryFreq
    Specifies how many retries the DM client performs when there are Connection Manager level or wininet level errors.

    Data type

    int

    Access type

    Add, Get, Replace, Delete

    Occurs

    ZeroOrOne

    Default value

    3

  • DMAcc/<x>/Ext/Microsoft/InitialBackOffTime
    Specifies the initial wait time in milliseconds when the DM client retries for the first time. The wait time grows exponentially.

    Data type

    int

    Access type

    Add, Get, Replace, Delete

    Occurs

    ZeroOrOne

    Default value

    16000

  • DMAcc/<x>/Ext/Microsoft/MaxBackOffTime
    Specifies the maximum number of milliseconds to sleep after package-sending failure.

    Data type

    int

    Access type

    Add, Get, Replace, Delete

    Occurs

    ZeroOrOne

    Default value

    86400000

See Also

Concepts

Configuration Service Provider Reference for Windows Mobile Devices
DMAcc DDF File
DMAcc Configuration Service Provider Examples for OMA DM