Configuring a web.config file with ExCM settings

Some behavior of the ExCM application can be configure by editing the contents of your Web Application's web.config file. Behavior configured by editing the web.config file is applied globally to each site or sub-site of the Web Application. Behavior that can be configured from the web.config file include a list of approved domain name expressions, password help messages and the ability to enforce the use of the e-mail address as the username. These web.config modifications are optional. If these entries are omitted then the default behavior is assumed.

Setup the ExCM Section Handlers

The ExCM section handlers inform the .NET framework how to handle the configuration of the <extranet /> tag. This section should be a child of the <configSections /> tag.

ExCM Section Handlers	Copy Code
<sectionGroup name="extranet"> <section name="membershipSettings" type="SPSolutions.SharePoint.Delegation.Configuration.MembershipSettingsSection, SPSolutions.SharePoint.Delegation, Version=1.0.0.0, Culture=neutral, PublicKeyToken=08a33cc09f006379" /> <section name="approvedDomainNames" type="SPSolutions.SharePoint.Delegation.Configuration.ApprovedDomainNamesSection, SPSolutions.SharePoint.Delegation, Version=1.0.0.0, Culture=neutral, PublicKeyToken=08a33cc09f006379" /> </sectionGroup>

ExCM Section Handlers

Copy Code

ExCM Extranet Tag

The <extranet /> tag contains all ExCM configuration settings. Options include a list of approved domain name expressions, password help messages and the ability to enforce the use of the e-mail address as the username. This section should be a child of the <configuration /> tag.

Extranet Section	Copy Code
<extranet> <membershipSettings useEmailAsUsername="true" passwordMessage="Password message" passwordExample="Password example" /> <approvedDomainNames> <add expression="^gmail\.com$" /> <add expression="^hotmail\.com$" /> </approvedDomainNames> </extranet>

ExCM Extranet Tag Properties

Configuration Option Possible Values Description

useEmailAsUsername true/false
When true the Username input fields are removed from the Register, Add User To Authorization Store, Add User and Manage Profile pages. The e-mail address is used as the username.

Default Value: false

passwordMessage string
Provides guidance regarding the password complexity to users completing password fields. This message is displayed on the Register, Add User To Authorization Store and Add User pages.

Default Value: Empty

passwordExample string
Provides guidance regarding the password complexity to users completing password fields. This example is displayed on the Register, Add User To Authorization Store and Add User pages.

Default Value: Empty

approvedDomainNames Collection of Expressions
List of regular expressions used to validate the domain name of the e-mail address provided during registration and profile updates.

Sample Expressions:

^gmail\.com$ - (allow only e-mails with gmail.com domain)

^(.*\.)?gmail\.com$ - (allow only e-mails with gmail.com domain including sub-domains)

^gmail\.(com|gov|edu)$ - (allow only e-mails from gmail.com, gmail.gov or gmail.edu)

Extranet Collaboration Manager
Configuring a web.config file with ExCM settings
Send Feedback

Configuration Option	Possible Values	Description
useEmailAsUsername	true/false	When true the Username input fields are removed from the Register, Add User To Authorization Store, Add User and Manage Profile pages. The e-mail address is used as the username. Default Value: false
passwordMessage	string	Provides guidance regarding the password complexity to users completing password fields. This message is displayed on the Register, Add User To Authorization Store and Add User pages. Default Value: Empty
passwordExample	string	Provides guidance regarding the password complexity to users completing password fields. This example is displayed on the Register, Add User To Authorization Store and Add User pages. Default Value: Empty
approvedDomainNames	Collection of Expressions	List of regular expressions used to validate the domain name of the e-mail address provided during registration and profile updates. Sample Expressions: ^gmail\.com$ - (allow only e-mails with gmail.com domain) ^(.*\.)?gmail\.com$ - (allow only e-mails with gmail.com domain including sub-domains) ^gmail\.(com\|gov\|edu)$ - (allow only e-mails from gmail.com, gmail.gov or gmail.edu)