NAPDEF Configuration Service Provider

  • Article

4/8/2010

Use the NAPDEF Configuration Service Provider to add, modify, and delete Wireless Application Protocol (WAP) network access points (NAPs)—for example, remote access. For complete information about these settings, see the standard WAP specification WAP-183-ProvCont-20010724-a. For a detailed description of how the device processes these parameters, see the WAP Connectivity Bootstrap Message.

This Configuration Service Provider is managed over the OMA Client Provisioning (formerly WAP Client Provisioning) protocol.

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.

Note

The Microsoft format for NAPDEF contains the provisioning XML attribute mwid. This custom attribute is optional when adding a NAP or a proxy. It is required when updating and deleting existing NAPs and proxies and must have its value set to 1. For more information about the mwid attribute, see characteristic Element and characteristic-query Element.

The following table shows the default settings for all parameters in this Configuration Service Provider. The default security role maps to each subnode unless specific permission is granted to the subnode.

Access type

Read/write

Roles allowed to query and update setting

Manager

Operator

Operator-TPS

AuthenticatedUser

The following image shows the Configuration Service Provider management object in tree format as used by OMA Client Provisioning for initial bootstrapping of the device.

Bb737515.d17c11dc-0e8b-45cb-b894-dc2370eda0e1(en-us,MSDN.10).gif

The following image shows the Configuration Service Provider management object in tree format as used by OMA Client Provisioning for updating the bootstrapping of the device.

Bb737515.d051d586-57ee-4141-ad17-7de7a3b64f30(en-us,MSDN.10).gif

Characteristics

  • NAPAUTHINFO
    Authentication information within a network access point.

Parameters

  • AUTHNAME
    This parameter is used in the NAPAUTHINFO characteristic to identify the ID needed to authenticate the user.
  • AUTHSECRET
    This parameter is used in the NAPAUTHINFO characteristic to identify the password needed to authenticate the user. A query of this parameter results in asterisks (*).

  • AUTHTYPE
    This parameter is used in the NAPAUTHINFO characteristic to identify the authentication protocol. Only Password Authentication Protocol (PAP) and Challenge Handshake Authentication Protocol (CHAP) authentication protocols are supported.

    Note

    AuthName and AuthSecret are not created if AuthType is not included in the initial device configuration. AuthName and AuthSecret cannot be changed if AuthType is not included in the provisioning xml used to make the change.

  • BEARER
    This parameter identifies the type of bearer. Only Global System for Mobile Communication (GSM)-circuit-switched data (CSD) and GSM-General Packet Radio Services (GPRS) are supported.
  • CALLTYPE
    This is a GSM-CSD parameter, which identifies the protocol that will be used for data exchange.

  • DNS-ADDR
    There can be one or two entries for this parameter. This parameter is used in the <entryname> characteristic and the first value is placed in the ipaddrDns member of the RASENTRY structure. The second value is placed in the ipaddrDnsAlt member of the RASENTRY structure. For more information about RASENTRY, see the Microsoft Developers Network.

    Note

    Once configured, the DNS-ADDR parameter cannot be set to null by configuration with a blank string. The setting can be cleared by using <noparm name=”DNS-ADDR”/> for each of the two values.

  • LINKSPEED
    This is a GSM-CSD parameter, which identifies the speed on the uplink channel and optionally the downlink channel.
  • LOCAL-ADDR
    This is a GPRS parameter, which identifies the local address of the WAP client.

  • LOCAL-ADDRTYPE
    This is a GPRS-related parameter, which indicates the address format in the LOCAL-ADDR parameter. LOCAL-ADDR provides the device's GPRS IP address. The value of LOCAL-ADDRTYPE can be either IPv4 or IPv6.

    Note

    Windows Mobile 2003 provides support for IPv6 only in IPv4/IPv6 mixed-mode environments.

  • NAME
    This parameter identifies the logical, user-readable identity of the NAP.
  • NAP-ADDRESS
    This parameter identifies the address of the NAP.
  • NAP-ADDRTYPE
    This parameter identifies the protocol of NAP-ADDRESS. Only Access Point Name (APN) and E164 are supported.
  • NAPID
    A subcharactristic of NAPDEF and synonymous with ConRef. This parameter identifies the NAP. The maximum length for this string is 16 characters.

Microsoft Custom Elements

The following table shows the Microsoft custom elements that this Configuration Service Provider supports for OMA Client Provisioning.

Elements Available

parm-query

Yes. See also the parameter AUTHSECRET.

> [!NOTE] > GPRS parameters will not necessarily contain the exact same value as was set.

noparm

Yes

nocharacteristic

Yes

characteristic-query

Yes

Use these elements to build standard OMA Client Provisioning (formerly WAP Client Provisioning) configuration XML. For information about specific elements, see MSPROV DTD Elements. For examples of how to use the Microsoft custom elements, see OMA Client Provisioning XML File Examples.

For information about OMA Client Provisioning, see OMA Client Provisioning Files.

See Also

Tasks

NAPDEF Configuration Service Provider Examples for OMA Client Provisioning

Reference

WAP NAPDEF

Concepts

Configuration Service Provider Reference for Windows Mobile Devices