Stack Configuration File Settings
.NET Stack Links
When you add the Stack package to your project, your application's configuration file (App.config
or Web.config
) will be modified. This article explains the modifications that are made and what additional settings you may wish to change.
Contents
Lds.Stack Configuration Section
The Lds.Stack
section defines most of the settings for core Stack functionality. With the exception of the <ignorepaths>
setting, which you define manually, these are the default settings when you add the .NET Stack Library to your project.
<Lds.Stack>
<stackSecurity ssoEnabled="false">
<ldsAccountConnection userName="{Your Application Account}" password="{Your Application Password}" server="{Directory Server}"/>
<stackAuthorization>
<providers>
<add name="Example" type="MyApplication.Security.MyAuthorizationInformationProvider, MyApplication"/>
</providers>
</stackAuthorization>
<ignorePaths>
<add name="Images Folder" value="Content/Images"/>
<add name="Scripts Folder" value="Scripts"/>
</ignorePaths>
</stackSecurity>
</Lds.Stack>
Stack Configuration Settings
Core configuration for general areas of the Stack.
Enabling or disabling single sign-on:
Set ssoEnabled
to true
or false
to enable or disable your web application to participate in WAM SSO.
<stackSecurity ssoEnabled="false|true">
More details are available on SSO-enabling your application.
LDS Account that your application will use when using the Stack:
<ldsAccountConnection userName="{Your Application Account}" password="{Your Application Password}" server="{Directory Server}" />
Stack Authorization Providers:
<stackAuthorization>
<providers>
<add name="Example" type="MyApplication.Security.MyAuthorizationInformationProvider, MyApplication"/>
</providers>
</stackAuthorization>
Ignore Paths - Specify the folders where any files requested from that location will skip authentication. Paths are relative from the application root and the name you choose can be anything you want.
<ignorePaths>
<add name="Images Folder" value="Content/Images"/>
<add name="Scripts Folder" value="Scripts"/>
</ignorePaths>
Membership
Configuration for using the LDS Account Membership Provider.
Providers:
<system.web>
<membership defaultProvider="LdsAccountMembershipProvider">
<providers>
<clear/>
<add name="LdsAccountMembershipProvider" type="Lds.Stack.Security.LdsAccountMembershipProvider, Lds.Stack"/>
</providers>
</membership>
</system.web>
Other Sections
General stack sections that enable your application for the Stack.
Config Section:
<configuration>
<configSections>
<sectionGroup name="Lds.Stack">
<section name="stackSecurity" type="Lds.Stack.Security.Configuration.StackSecurityConfigurationSection, Lds.Stack">
</sectionGroup>
</configSections>
</configuration>
Http Module:
<system.web>
<httpModules>
<add name="Stack" type="Lds.Stack.Security.StackSecurityModule, Lds.Stack">
</httpModules>
</system.web>
<system.webServer>
<modules>
<add name="Stack" type="Lds.Stack.Security.StackSecurityModule, Lds.Stack">
</modules>
</system.webServer>