Web Service Configuration Settings

There are configuration settings for the FIM Service web services stored in the .NET app.config file and in the local computer registry. By default, the app.config file is named Microsoft.ResourceManagementService.exe.config. This file is consumed once when the FIM Service starts; therefore, the service must be restarted to consume any changes.

Web Service Configuration File Settings

The web service configuration is stored in two parts of the app.config file. The first part is the ResourceManagementService section and the second part is .NET appSettings. Generally, settings related to the service behavior such as endpoint addresses or workflow host configuration is stored in the ResourceManagementService section. Some settings, however, are also stored in the appSettings section. All of the configuration settings are optional, and the common settings are configured by initial setup. Some settings should only be changed as directed by customer support; they are included in this list for completeness. When making changes to an existing deployment, it may be necessary to edit the app.config file directly rather than running a change install.

Example

The following is an example Web service configuration file.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
 <!-- ... -->

 <resourceManagementService workflowManagerEndpointBaseAddress="ResourceManagementService/WorkflowManager" 
               dataReadTimeoutInSeconds="58" 
               dataWriteTimeoutInSeconds="58" 
               defaultKeySize="256" 
               defaultTokenLifetimeInMinutes="10" 
               externalHostName="identitymanagement.fabrikam.com" 
               hostActivationIntervalInMilliseconds="120000" 
               intranetRegistrationEndpointAddress="ResourceManagementService/SecurityTokenService/Registration" 
               metadataEndpointAddress="ResourceManagementService/MEX" 
               passwordResetEndpointAddress="ResourceManagementService/Alternate" 
               policyManagerIntervalInMilliseconds="5000" 
               receiveTimeoutInSeconds="300" 
               resourceEndpointAddress="ResourceManagementService/Resource" 
               resourceMailEndpointAddress="ResourceManagementService/ResourceMail" 
               resourceFactoryEndpointAddress="ResourceManagementService/ResourceFactory"
               securityTokenServiceEndpointAddress="ResourceManagementService/SecurityTokenService" 
               securityTokenServiceMetadataEndpointAddress="SecurityTokenService/MEX" 
               servicePrincipalName="fimservice@fabrikam.com" 
               maxReceivedMessageSizeInBytes="10485760"
               mailBatchSize="100"
 />
 <appSettings>
  <add key="synchronizationEngineAccountName" value="fimsyncservice"/>
  <add key="mailServer" value="http://exchange.fabrikam.com/ews/exchange.asmx"/>
  <add key="isExchange" value="1"/>
  <add key="exchangeListenerInterval" value="30"/>
 </appSettings>
</configuration>

Web Service Registry Settings

The registry settings configure how the FIM Service are stored in the current control set of the FIM Service. All of these settings may be updated by running a change install. Additional registry values may be present in the same registry key, but these are not used by the FIM Service.

Remarks

There is no general principle behind why some settings are stored in the registry and others are in the app.config file. When configuration settings are available in both locations, the registry generally takes precedence.

See Also

Other Resources

Web Services API