Configuring the CS Authentication Resource

You can view and edit CS Authentication properties for the global CS Authentication resource.

Ee810620.note(en-US,CS.20).gifNotes

  • Many authentication properties are set at the site level. For information about configuring site level authentication properties, see Configuring an Application.
  • The following authentication properties are set in the App Default Config resource: Site ticket options, Site privacy options, Form login options, and AuthManager Auth Ticket Timeout. These properties apply if you are developing a site using the Commerce Server Solution Sites. For information about configuring these App Default Config properties, see Configuring the App Default Config Resource.

To configure the CS Authentication resource properties

  1. Expand Commerce Server Manager, and then click Global Resources.

  2. In the right-hand pane, right-click CS Authentication(sitename) resource, where (sitename) is the name of the site you are configuring, and then click Properties.

    The CS Authentication(sitename) Properties dialog box appears.

  3. In the Properties box, select the property for which you want to set a value.

  4. In the Selected Property Value box, type the new value, and then click OK.

The following table lists the CS Authentication properties you can set at the global resource level for a Commerce Server site.

Property Description
Login Form The name of the form to be used for logging on users. You can specify one of the following:
  • The relative path to the Login.asp page. Uses http://<servername> and AuthFilter Helper Folder.
  • The full path to the Login.asp page.

If you use Secure Sockets Layer (SSL), you must specify the full path to the Login.asp page, for example:

https://www.microsoft.com/authfilter/login.asp.

Login Retries The number of times users are prompted to type their user name and password before a message instructing them to call customer service is displayed.

This property applies only when you are using Windows Authentication.

Password-Cache Size The maximum number of users whose credentials can be stored in AuthFilter User-Password-Cache. This property is used only with Windows Authentication mode.
Password-Cache TTL The length of time in minutes that the authentication credentials are stored in the Password-Cache. This property is used only with Windows Authentication mode.
AuthProfile-Name The name of the profile object to use when the data source for the Profiling system is partitioned. If you are using default schema, this value must be Profile Definitions.UserObject.
AuthFilter Helper Folder The name of the folder that AuthFilter uses to store helper files. You must keep all files related to AuthFilter in this one folder. The default subfolder is \AuthFiles. All AuthFilter files must have Anonymous Access enabled.
Error Form The name of the form to be used when an access denied error occurs. You can specify one of the following:
  • The relative path to the form. Uses http://<servername> and AuthFilter Helper Folder.
  • The full path to the form.
Help Form The name of the form that contains help information for logging in. You can specify one of the following:
  • The relative path to the form. Uses http://<servername> and AuthFilter Helper Folder.
  • Full path to the form.
Internal Error Form The name of the error form to display when there is an internal error. You can specify one of the following:
  • The relative path to the form. Uses http://<servername> and AuthFilter Helper Folder.
  • The full path to the form.
No-Cookie form The name of the form to display when the browser does not have cookies enabled or does not support cookies. You can specify one of the following:
  • The relative path to the form. Uses http://<servername> and AuthFilter Helper Folder.
  • The full path to the form.
AutoCookie Form The name of the form to be redirected to when Autocookies are enabled. You can specify one of the following:
  • The relative path to the form. Uses http://<servername> and AuthFilter Helper Folder.
  • The full path to the form.
Profile Cookie Expiration Date The end date after which the cookie is no longer valid.
Enable Encryption To enable encryption of cookie data, set this property at the Commerce site level. For instructions, see Configuring an Application.
Encryption Key for Cookie Data The encryption key used for encrypting or decrypting cookie data. To generate a new encryption key, see Generating a New Cookie Encryption Key.

Ee810620.note(en-US,CS.20).gifNotes

  • You must keep all files related to AuthFilter in one folder, specified in Auth Filter Helper Folder property. The default subfolder is \AuthFiles. All AuthFilter files must have Anonymous Access enabled.
  • After you change a global CS Authentication property, and if you are using AuthFilter, you must restart Internet Information Services (IIS) 5.0 by using the net stop and net start commands. For instructions, see Restarting IIS and Commerce Server Services.

See Also

Configuring the App Default Config Resource

BDSecurity Object

AuthManager Object

Copyright © 2005 Microsoft Corporation.
All rights reserved.