Share via


Csapp.ini File

For the latest version of Commerce Server 2007 Help, see the Microsoft Web site.

Commerce Server Site Packager generates the Csapp.ini file during the unpacking process. After the unpacking process is complete, do not delete Csapp.ini; both AuthManager and AuthFilter require this file, and it must be located in the site root folder.

The following table lists the properties that are contained in the Csapp.ini file and their descriptions.

  • Path
    The physical path of the root of the application.

  • SiteName
    The name of the site as it appears in the Administration database.

    This value is used to initialize the SiteConfigReadOnly component to retrieve information pertaining to the site.

    Aa544653.alert_caution(en-US,CS.70).gifImportant Note:

    Commerce Server supports site names of 1 to 127 characters only.

  • AddressKeyName
    The name of the application in the Administration database under which all information for the IIS application is placed. This value is used to retrieve information pertaining to the application within the site defined by the SiteName key.

  • RelativeURL
    The name of the IIS virtual directory for the application relative to the default Web site. For example, if the application was installed at the root of the IIS Web site, it is relative to the base root of a given IIS Web site.

  • AbsoluteURL
    The address of the application, which also includes the computer name.

  • PackagePath
    The package from which the application was extracted.

The only property in this file that should be changed is the RelativeURL property. If you manually move an application to a different IIS path, the RelativeURL property must be modified to point to the accurate relative virtual directory under the IIS Web site. If the application is moved to the root of a Web site, it must contain a slash (/), for example, RelativeURL=/. The RelativeURL exists so that the CS Authentication service can determine from where it is operating. The RelativeURL property is recreated every time that it is unpacked.

Note

Secure the Csappi.ini file by deselecting read, write, and script source access to it in IIS. If you use NTFS permissions to help secure this file, you must grant read access to all user accounts that access the site, such as the IUSR_computername account. Also, after you unpack a site, do not delete Csapp.ini; both AuthManager and AuthFilter require this file, and it must be located in the site root folder. AuthManager retrieves the SiteName and AddressKeyName properties from the Csapp.ini file.

See Also

Other Resources

Authentication Concepts and Tasks

What Is AuthFilter?

What Is AuthManager?