Configuring the Web Server Registry (Windows Embedded CE 6.0)

  • Article

1/6/2010

After you have created an OS design for your Web Server device, you need to modify the registry to create virtual root directories and specify the access rights for your users. To gain access to a virtual path, a user must be authenticated using NTLM authentication or Basic authentication. Specify the authentication level by setting the "a" value for each virtual path. For more information, about authentication levels, see Web Server Authentication.

Note

To configure user access rights for virtual roots using Basic and NTLM authentication, you must use Windows CE .NET 4.2 or later.

  1. In Platform Builder, in the Solution Explorer window, expand the ParameterFiles node.

  2. Expand the CEPC folder, and then locate project.reg.

  3. To open the file, double-click project.reg.

  4. To create virtual roots, set up access rights for your users, and include the sample Web-based configuration page (httpadm.dll) in your OS design, add the following registry keys and values to project.reg:

    HKEY_LOCAL_MACHINE\COMM\HTTPD\VROOTS\/WebAdmin]
@="\\windows\\httpdadm.dll"
"a"=dword:0

    Note

    Setting the "a" value to zero (0), enables anonymous users to have access to all files in the virtual directory. This completely opens the device up to hackers. Setting this value to zero (0) is permissible for internal development and testing purposes. However, you should never ship a Web Server device with the "a" value set to zero (0) for any configuration page.

    [HKEY_LOCAL_MACHINE\COMM\HTTPD\VROOTS\/BasicOnly]
@="\\"
"a"=dword:1
"Basic"=dword:1
"NTLM"=dword:0
"dirbrowse"=dword:1
[HKEY_LOCAL_MACHINE\COMM\HTTPD\VROOTS\/NTLMOnly]
@="\\"
"a"=dword:1
"Basic"=dword:0
"NTLM"=dword:1
"dirbrowse"=dword:1
[HKEY_LOCAL_MACHINE\COMM\HTTPD\VROOTS\/BothAuth]
@="\\"
"a"=dword:1
"Basic"=dword:1
"NTLM"=dword:1
"dirbrowse"=dword:1

    Adding these values will create virtual root directories for the Basic and NTLM-based authentication methods.

    Note

    To set the password for the entire Web Server device for Basic authentication, you can create an application that runs on the device, and calls the SetPassword function. Setting the password programmatically through SetPassword is the equivalent of the password setting that you add in Control Panel on the target device.

  5. Save and then close project.reg.

See Also

Tasks

How to Configure the Web Server

Concepts

Web Server (HTTPD) Application Development