profilesWebService Element
The profilesWebService element provides the means to configure the behavior of the Profiles Web service. This element is required, and should be used only in the web.config file for the Profiles Web Service (<drive>:\Inetpub\wwwroot\ProfilesWebService\Web.config).
The following table lists the attributes of the profilesWebService element.
Attribute |
Data type |
Description |
|---|---|---|
authorizationPolicyPath |
String |
File path of the Windows Authorization Manager authorization policy store. If the disableAuthorization attribute is true, this attribute is not validated. This attribute is required. |
backgroundThreadActive |
String |
Determines whether the Profiles Web service will run a background thread that will periodically clean up expired entries from the profile object cache. If the value of this attribute is true, the background thread will be run. If false, the thread will not be run. The value of this attribute must represent a Boolean. This attribute is optional. |
bypassProfileCache |
String |
Determines whether the Profiles Web service will always go to the data source when retrieving profile instances. If the value of this attribute is true, the Profiles Web service will always go to the data source when retrieving profile instances. If false, the Profiles Web service will not always go to the data source. Setting the value to true effectively disables caching at the Web service. The purpose of this flag is to enable the Profiles Web service to operate in a Web farm deployment without the risk of cache inconsistency between servers. The value of this attribute must represent a Boolean. This attribute is optional. |
connectionRetries |
String |
The number of times the Profiles Web Service will retry connecting to a data source before failing. The value of this attribute must represent an integer. This attribute is optional. |
connectionRetryDelaySeconds |
String |
The number of seconds to wait between attempts to connect to a data source. The value of this attribute must represent an integer. This attribute is optional. |
disableAuthorization |
String |
Determines whether the Profiles Web service will perform authorization checks. If the value of this attribute is true, the Web service will not perform any authorization checks. If false, authorization checks will be performed. The value of this attribute must represent a Boolean. This attribute is optional. |
keyIndex |
String |
Specifies which private key token corresponds to. Valid values are the following:
|
privateKey1 |
String |
Hexadecimal string that represents the private key for keyIndex 1. Alternatively, you can use the format: registry:{hive}[\{subkey}],[{valuename}] where hive is the key hive name (for example, HKEY_LOCAL_MACHINE) and subkey is an optional subkey name. If valuename is not specified, the (Default) value is used. Keys formatted in this manner are encrypted in the specified registry value. You can create these types of keys using Using the Profile Key Manager with the /reg flag. This attribute is optional. |
privateKey2 |
String |
Hexadecimal string that represents the private key for keyIndex 2. Alternatively, you can use the format: registry:{hive}[\{subkey}],[{valuename}] where hive is the key hive name (for example, HKEY_LOCAL_MACHINE) and subkey is an optional subkey name. If valuename is not specified, the (Default) value is used. Keys formatted in this manner are encrypted in the specified registry value. You can create these types of keys using Using the Profile Key Manager with the /reg flag. This attribute is optional. |
profileObjectAgeoutTimeMilliseconds |
String |
The number of milliseconds that an unreferenced profile object can remain in the cache without being discarded. The value of this attribute must represent an integer. This attribute is optional. |
profileObjectCacheSize |
String |
The size of the Profiles Web service profile object cache. The value of this attribute must represent an integer. This attribute is optional. |
profileSchemaCacheSize |
String |
The size of the Profiles Web service profile schema cache. The value of this attribute must represent an integer. This attribute is optional. |
publicKey |
String |
Hexadecimal string that represents the public key that the Profiles Web service uses. Alternatively, you can use the format: registry:{hive}[\{subkey}],[{valuename}] where hive is the key hive name (for example, HKEY_LOCAL_MACHINE) and subkey is an optional subkey name. If valuename is not specified, the (Default) value is used. Keys formatted in this manner are encrypted in the specified registry value. You can create these types of keys using Using the Profile Key Manager with the /reg flag. This attribute is optional. |
searchResultsLimit |
String |
The maximum number of records that can be returned from a search operation. This only affects SELECT bulk query operations through the agent/Web service. The value of this attribute must represent an integer. This attribute is optional. |
siteName |
String |
The name of the site with which this Web service is operating. This attribute is required and is automatically set during the Pup process. |
Example
<configuration>
<CommerceServer>
<profilesWebService
siteName=”string”
authorizationPolicyPath=”string”
disableAuthorization=”boolean”
searchResultsLimit=”integer”
bypassProfileCache=”Boolean"
profileObjectCacheSize=”integer”
profileSchemaCacheSize=”integer”
backgroundThreadActive=”Boolean”
profileObjectAgeoutTimeMilliseconds=”integer”
connectionRetries=”integer”
connectionRetryDelaySeconds=”integer”
publicKey=”string”
keyIndex=”integer”
privateKey1=”string”
privateKey2=”string”>
<presentationConfiguration>
<cultureConfig filePath=”string” isDefault=”bool”/>
…
</presentationConfiguration>
</profilesWebService>
</CommerceServer>
<configuration> />