--- title: DMAcc DDF file description: View the XML file containing the device description framework (DDF) for the DMAcc configuration service provider. ms.date: 06/28/2024 --- # DMAcc DDF file The following XML file contains the device description framework (DDF) for the DMAcc configuration service provider. ```xml ]> 1.2 DMAcc ./SyncML This interior node is a common parent to all OMA DM server account nodes that use OMA DM 1.2 protocol. 10.0.10586 1.0 0x4;0x1B;0x30;0x31;0x48;0x54;0x62;0x63;0x64;0x65;0x79;0x7A;0x7D;0x7E;0x81;0x82;0x88;0x8A;0x8B;0xA1;0xA2;0xA4;0xA5;0xAB;0xAC;0xAF;0xBC;0xBF;0xCA;0xCB;0xCD;0xCF;0xD2; This interior node acts as a placeholder for zero or more OMA DM server accounts. If this OMA DM server account is bootstrapped using the w7 APPLICATION, the name of this node is generated from the 256-bit version of SHA-2 hash of the w7 PROVIDER-ID parm. AccountUID AppID w7 Specifies the application identifier for the OMA DM account.. The only supported value is w7. Application ID for DM Account MO w7 The only supported value. ServerID Specifies the OMA DM server's unique identifier for the current OMA DM account. This value is case-sensitive. Server Identifier Name Specifies the display name of the application. Displayable name for the Management Server PrefConRef The only supported values include the NAPID of a bootstrapped NAP management object or a connection GUID used by connection manager. If this node is missing, the device will use the default connection provided by connection manager. Reference to preferred connectivity AppAddr Interior node for DM server address. A collection of references to DM server address Defines the OMA DM server address. Only one server address can be configured. When mapping the w7 APPLICATION configuration service provider to the DMAcc Configuration Service Provider, the name of this element is "1". This is the first DM address encountered in the w7 APPLICATION configuration service provider, other DM accounts are ignored. ObjectName Addr Specifies the address of the OMA DM account. The type of address stored is specified by the AddrType element. Management Server Address AddrType URI Specifies the format and interpretation of the Addr node value. The default is "URI". The default value of "URI" specifies that the OMA DM account address in Addr is a URI address. A value of "IPv4" specifies that the OMA DM account address in Addr is an IP address. Management Server Address Type URI The OMA DM account address in Addr is a URI address. IPv4 The OMA DM account address in Addr is an IP address. Port Interior node for port information. A collection of all Port objects Only one port number can be configured. When mapping the w7 APPLICATION configuration service provider to the DMAcc Configuration Service Provider, the name of this element is "1". ObjectName PortNbr Specifies the port number of the OMA MD account address. This must be a decimal number that fits within the range of a 16-bit unsigned integer. Port AAuthPref Specifies the application authentication preference. Supported values: BASIC, DIGEST. If this value is empty, the client attempts to use the authentication mechanism negotiated in the previous session if one exists. If the value is empty, no previous session exists, and MD5 credentials exist, clients try MD5 authorization first. If the criteria are not met then the client tries BASIC authorization first. Application Authentication Type preference BASIC The client attempts BASIC authentication. DIGEST The client attempts MD5 authentication. AppAuth Defines authentication settings. A collection of all references to multiple Application Authentication objects Defines one set of authentication settings. When mapping the w7 APPLICATION configuration service provider to the DMAcc Configuration Service Provider, the name of this element is same name as the AAuthLevel value ("CLRED" or "SRVCRED"). ObjectName AAuthLevel Specifies the application authentication level. A value of "CLCRED" indicates that the credentials client will authenticate itself to the OMA DM server at the OMA DM protocol level. A value of "SRVCRED" indicates that the credentials server will authenticate itself to the OMA DM Client at the OMA DM protocol level. Application Authentication level CLCRED The credentials client will authenticate itself to the OMA DM server at the OMA DM protocol level. SRVCRED The credentials server will authenticate itself to the OMA DM Client at the OMA DM protocol level. AAuthType Specifies the authentication type. If AAuthLevel is CLCRED, the supported types include BASIC and DIGEST. If AAuthLevel is SRVCRED, the only supported type is DIGEST. Application Authentication Type BASIC BASIC DIGEST DIGEST DIGEST DIGEST SyncML/DMAcc/{AccountUID}/AppAuth/{ObjectName}/AAuthLevel SRVCRED SRVCRED AAuthName Specifies the authentication name. Application Authentication Name AAuthSecret Specifies the password or secret used for authentication. Application Authentication Secret AAuthData Specifies the next nonce used for authentication. "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. Application Authentication Data Ext Defines a set of extended parameters. This element holds vendor-specific information about the OMA DM account and is created automatically when the OMA DM account is created. Vendor specific information Microsoft Defines a set of Microsoft-specific extended parameters. This element is created automatically when the OMA DM account is created. The collection of Microsoft specific settings Role If this node is unspecified, its default value is the access role of the session that created the server account. The value for this node must be a subset of the roles used in creating this server account. The security role mask that the DM session should run with 4 SECROLE_OPERATOR 8 SECROLE_MANAGER 16 SECROLE_USER_AUTH 128 SECROLE_OPERATOR_TPS ProtoVer This node value corresponds to what the client would put in the VerDTD element of an OMA-DM package. No default value is assumed. The only valid value for this node is 1.1 or 1.2. The OMA-DM protocol version that the client should use in communicating with the server 1.1 1.1 1.2 1.2 DefaultEncoding This node specifies the encoding that the OMA-DM client will use to encode its first package. Valid values include "application/vnd.syncml.dm+xml" (for XML) and "application/vnd.syncml.dm+wbxml" (for WBXML). If this node is left unspecified, the OMA-DM client defaults to "application/vnd.syncml.dm+xml". application/vnd.syncml.dm+xml XML is used application/vnd.syncml.dm+wbxml WBXML is used UseHwDevID 0 A value of true indicates that, during an OMA-DM session with this server, the value of the ./DevInfo/DevId node is the hardware ID of device (e.g, IMEI for a GSM device, ESN for a CDMA Device, hashed UUID for a non-radio device). The default value of false indicates that the value of ./DevInfo/DevId node is a hash of the UUID of the device. 0 An application-specific GUID is returned for the ./DevInfo/DevID rather than the hardware device ID. 1 The hardware device ID will be provided for the ./DevInfo/DevID element and the Source LocURI for the OMA DM package that is sent to the server. ConnRetryFreq 3 This node specifies how many times DM client will retry a connection to the server if the connection fails. The default value is 3 retries. InitialBackOffTime 16000 This node specifies the initial amount of time (in milliseconds) that the DM client waits before attempting a connection retry. After the initial wait, the wait time grows exponentially. The default value is 16000 milliseconds. MaxBackOffTime 86400000 This node specifies the maximum number of milliseconds to wait before attempting a connection retry. The default value is 86400000. BackCompatRetryDisabled 0 This node specifies whether to disable the ability of the DM client to communicate with a down-level server. Possible Values: false (default) -- Compatibility with down-level servers is enabled true -- Compatibility with down-level servers is disabled 0 Backward-compatible retries are enabled. 1 Backward-compatible retries are disabled. UseNonceResync 0 This node specifies whether the DM client can use the nonce resynchronization protocol when authentication of a server notification fails. If nonce resynchronization is disabled and authentication of the server notification fails, the notification is dropped. Possible Values: false (default) : Nonce resynchronization is disabled. true : Nonce resynchronization is enabled. 0 The client does not try to authenticate the notification with the backup server nonce if authentication to the stored nonce fails. 1 The client initiates a DM session if the backup server nonce is received after authentication failed. CRLCheck Allows connection to the DM server to check the Certificate Revocation List (CRL). Set to true to enable SSL revocation. CRLCheck 0 False 1 True DisableOnRoaming Determines whether the OMA DM client should be launched when roaming. DisableOnRoaming 0 False 1 True SSLCLIENTCERTSEARCHCRITERIA SSLCLIENTCERTSEARCHCRITERIA InitiateSession When this node is added, a session is started with the MDM server. 10.0.15063 1.1 ``` ## Related articles [DMAcc configuration service provider reference](dmacc-csp.md)