NAP Configuration Service Provider

4/8/2010

The NAP (Network Access Point) Configuration Service Provider is used to provision the following types of connections:

• CSD connections on GSM and CDMA networks
• GPRS connections
• RAS connections
• 1xRTT connections
• Desktop Passthrough (DTPT) connections

The ACCESS Configuration Service Provider must be configured before configuring the NAP object. The ACCESS Configuration Service Provider maps a particular connection (using the ConRef field) to a metanetwork, such as the Internet or Work.

Network access points provisioned using the NAP configuration service provider can be deleted using the Windows Mobile user interface. However, the corresponding ACCESS mappings to metanetworks cannot be deleted through the user interface. When reprovisioning a network access point after it has been deleted, you must delete and reprovision the corresponding ACCESS mappings before reconfiguring the network using NAP.

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.

This Configuration Service Provider is part of the OMA DM protocol, with some proprietary extensions, and must be used when provisioning devices using OMA DM. To provision devices using the OMA Client Provisioning (formerly WAP Client Provisioning) protocol use the CM_* Configuration Service Providers instead. The following table provides links to the CM_* Configuration Service Providers for cellular or other data networks.

Connection type	WAP configuration service provider
CSD Connections	CM_PPPEntries Configuration Service Provider
GPRS Connections	CM_GPRSEntries Configuration Service Provider
RAS Connections	CM_PPPEntries Configuration Service Provider and CM_GPRSEntries Configuration Service Provider
1xRTT Connections	CM_PPPEntries Configuration Service Provider
DTPT Connections	CM_NetEntries Configuration Service Provider

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

• NAP
  The root node for NAP object. The following table shows the default settings.

  Data Type	Node
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser
  Access Type	Read/Write
  Occurs	Once

• NAP/NAP XXX
  Specifies the network access point. The suggested name of this node is NAPXXX, a numbered node beginning at zero. For example, if you wanted to provision two network access points, you would use two nodes, NAP0 and NAP1. You can use any unique name (such as "GPRS-NAP") for this node, but no spaces may appear in the node name (use %20 instead).

  Data Type	Node
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• NAP/NAP XXX /NAPID
  Specifies the identifier of the destination network. The value of the NAPID must match a ConRef specified using the ACCESS Configuration Service Provider. The NAPID must be unique.

  The following table shows the default settings.

  Data Type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• NAP/NAP XXX /NAME
  Specifies the user-friendly name of the connection.

  The following table shows the default settings.

  Data Type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• NAP/NAP XXX /ADDR
  Specifies the address of the destination network. The ADDR may be the URL of an access point, the telephone number of an answering modem, or any other string used to uniquely identify the address of the destination network.

  The following table shows the default settings.

  Data Type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• NAP/NAP XXX /ADDRTYPE
  Specifies the type of address used to identify the destination network. The following table shows some commonly used ADDRTYPE values, and the types of connection corresponding with each value.

  Value	Connection Types
  E164	RAS connections
  APN	GPRS connections
  ALPHA	Wi-Fi-based connections, DTPT connections

  The following table shows the default settings.

  Data Type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• NAP/NAP XXX /AUTHINFO
  Specifies the authentication information, including the protocol, user name, and password.

  The following table shows the default settings.

  Data Type	Node
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• NAP/NAP XXX /AUTHINFO/AUTHTYPE
  Specifies the method of authentication. Some supported protocols are PAP and CHAP.

  The following table shows the default settings.

  Data Type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• NAP/NAP XXX /AUTHINFO/AUTHNAME
  Specifies the user name and domain to be used during authentication. This field is in the form Domain\UserName.

  The following table shows the default settings.

  Data Type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• NAP/NAP XXX /AUTHINFO/AUTHSECRET
  Specifies the password used during authentication. Queries of this field will return a string composed of sixteen asterisks (*).

  The following table shows the default settings.

  Data Type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• NAP/NAP XXX /BEARER/BEARERTYPE
  Specifies the network type of the destination network. Valid values are CDMA2000, CSD, DTPT, GPRS, TDMA, WCDMA and WiFi.

  The following table shows the BEARERTYPE to use with some commonly used connection types.

  Connection Type	BEARERTYPE
  CSD Connections	CSD
  GPRS Connections	GPRS
  RAS Connections	CSD
  1xRTT Connections	CDMA2000
  DTPT Connections	DTPT

  The following table shows the default settings.

  Data Type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• NAP/NAPXXX/Ext
  Stores extended parameters.

• NAP/NAPXXX/Ext/Microsoft
  Stores Microsoft-specific parameters.

• NAP/NAPXXX/Ext/Microsoft/GUID
  The GUID for the unique ID of the network to which this entry connects.

• NAP/NAPXXX/Ext/Microsoft/AlwaysOn
  Specifies whether the connection supports AlwaysOn. Permitted values are false (AlwaysOn not supported) and true (AlwaysOn supported). For more information about AlwaysOn, see Making an AlwaysOn Data Connection.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Boolean
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• NAP/NAPXXX/Ext/Microsoft/ReadOnly
  This parameter determines whether users are able to modify NAP settings. Permitted values are 0 for false and 1 for true. If the value is set to 1, users will be able to view, but not change, the NAP settings on the device.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Boolean
  Roles allowed to query and update setting	Manager Operator TPS

• NAP/NAPXXX/Ext/Microsoft/Secure
  Specifies whether the connection is marked as secure. Permitted values are false (not secure) and true (secure). See Connection Manager Security for more information.

  The following table shows the default settings.

  ermissions	Read/Write
  Data type	Boolean
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• NAP/NAPXXX/Ext/Microsoft/SecureLevel
  If the connection is marked as secure (the value of NAP/NAPXXX/Ext/Microsoft/Secure is true), this parameter specifies the security level. See Security Levels of Connection Types for more information.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	int
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

See Also

Concepts

Configuration Service Provider Reference for Windows Mobile Devices
NAP Configuration Service Provider Examples for OMA DM