Registration and Reset Portal Web.config settings

  • Article

Registration and Reset Portal Web.config settings

The following is a list of the web.config settings that can be configured on the Password Registration and Reset Portals.

Setting Values Relevance Configuration element belongs to the following web.config section: Description

SecurityContextAssertion

Contains one of the following:

  • Extranet

  • NotSpecified

The following setting is relevant to:

  • Registration Portal

  • Reset Portal

<settings>

SOAP property that identifies whether the portal is deployed on the extranet or not.

Example: <add key=”SecurityContextAssertion” value=”Extranet” />

SessionTimeoutInMinutes

Numerical value

The following setting is relevant to:

  • Registration Portal

  • Reset Portal

<settings>

The number of minutes until the session will timeout from inactivity.

Example: <add key=”SessionTimeoutInMinutes” value=”20” />

ShowTroubleshootingInfoOnErrorPage

Contains one of the following:

  • true

  • False

The following setting is relevant to:

  • Registration Portal

  • Reset Portal

<settings>

When this value is set to true then the following user intefaces are shown on the error page:

  1. A Stack Trace

  2. Copy to Clipboard

  3. Send information by Email

Send information by Email will only be available if TroubleshootingEmailRecipient has a value assigned to it.

Example: <add key=” ShowTroubleshootingInfoOnErrorPage” value=”true” />

TroubleshootingEmailRecipient

A Valid Email Address

The following setting is relevant to:

  • Registration Portal

  • Reset Portal

<settings>

Used with the Send information by Email link on an error page. This is the recipient of the email.

Example: <add key=” TroubleshootingEmailRecipient” value=”Administrator@corp.contoso.com” />

TroubleshootingEmailSubject

A specific subject to denote a Troubleshooting email

The following setting is relevant to:

  • Registration Portal

  • Reset Portal

<settings>

Used with the Send information by Email link on an error page. This is the subject of the email.

Example: <add key="TroubleshootingEmailSubject" value="There was an error with the Web Portal"/>

PrivacyPolicyLink

A valid URL

The following setting is relevant to:

  • Registration Portal

  • Reset Portal

<customizationSettings>

The URL that the Privacy Statement link points to on the About page.

Example: <add key="PrivacyPolicyLink" value="https://go.microsoft.com/fwlink/?LinkId=233314"/>

HomepageLink

A valid URL

The following setting is relevant to:

  • Registration Portal

  • Reset Portal

<customizationSettings>

Used on the error page to provide a link to the home page of either the registration or reset portal. It is used to restart the process.

Example: <add key=" HomepageLink" value="https://passwordregistration.corp.contoso.com"/>

PasswordResetLink

A valid URL

The following setting is relevant to:

  • Registration Portal

  •  

<customizationSettings>

If this value is specified, the user will be provided with a hyperlink to the password reset portal on the password registration success page.

Example: <add key=" PasswordResetLink " value="https://passwordreset.corp.contoso.com"/>

DisplayUsernameInUPNFormat

Contains one of the following:

  • true

  • False

The following setting is relevant to:

  • Registration Portal

  •  

<customizationSettings>

It value can be used to ensure that during registration, the user only sees the UPN format.

Example: <add key=”DisplayUsernameInUPNFormat value=”true” />

FinishURL

A valid URL

The following setting is relevant to:

  • Registration Portal

  • Reset Portal

<customizationSettings>

If this value is specified, the user will be provided with a Finish button once registration or reset has been completed. By clicking this Finish button, the user will be redirected to the URL provided.

If this value is not specified and clicking on the Finish button will take you to the “Session Ended” portal page.

Example: <add key=" FinishURL " value="https://passwordregistration.corp.contoso.com"/>

ValidResetUsernameRegex

A Regular expression.

The following setting is relevant to:

  • Reset Portal

<customizationSettings>

A Regular expression of acceptable characters for a username entered into the Reset portal.

Example: <add key="ValidResetUsernameRegex" value="^[^@\\]+((@|\\)[^@\\]+)?$" />

DefaultDomainName

A valid domain.

The following setting is relevant to:

  • Reset Portal

<customizationSettings>

This value is the default domain that will be used for fallback if a user enters a username without a domain in the reset portal.

Example: <add key=” DefaultDomainName” value=”CONTOSO” />

CancelURL

A valid URL

The following setting is relevant to:

  • Registration Portal

  • Reset Portal

<customizationSettings>

If this value is specified, the user will be redirected to the URL by clicking the Cancel button.

If this value is not specified and clicking on the Cancel button will take you to the “Session Ended” portal page.

Example: <add key=" CancelURL " value="https://passwordregistration.corp.contoso.com"/>