Learn more about SQL Server tools

mssqltips logo
 

Tutorials          DBA          Dev          BI          Career          Categories          Webcasts          Whitepapers          Today's Tip          Join

Tutorials      DBA      Dev      BI      Categories      Webcasts

DBA    Dev    BI    Categories

Special Announcement: SQL Server Performance Tuning Tips and Tricks Webinar
 

Creating and Deploying a Custom Login Page for SharePoint 2010 Forms Based Authentication


By:   |   Read Comments   |   Related Tips: > Sharepoint

Problem

Many applications need Claim Based Authentication instead of Classic Mode Authentication. The Form Based Authentication (FBA) is one type of Claim Based Authentication. The default login page of FBA in SharePoint 2010 is very simple which only provides a simple Login control with the user name, password and remember me option. But many developers want to implement a customized login page for a better looking experience or more options according to business requirements.

Solution

This article will demonstrate how to create a custom login page for a SharePoint site using Visual Studio 2010 and deploy it in a server farm. It will also include how to change the default login page URL from the Central Administration Application Provider Settings.

Step 1:

Create a new project type "Empty SharePoint Project" in Visual Studio 2010 as showed below:

new project

Provide a Project name and Press "OK". You will be prompted with a Wizard to specify the SharePoint site where you want to deploy the custom login page. You can validate the site URL to ensure that your site is fine to deploy in this solution. Remember that you have to choose Deploy as Server Farm solution instead of deploying as a sandboxed solution (default selected as below). Otherwise you will get an error when you deploy the solution:

 "The deployment type "TemplateFile" of file "CustomLogin.aspx" in the Project Item "Layouts" is not compatible with a Package in a Sandboxed Solution". Because Layout is root place to deploy in SharePoint server farm which is mapped {SharePointRoot}\Template\Layouts.

So you will select Deploy as Server Farm solution after validation of the site URL.

configuration wizard

Then "Click to Finish" and the project creation should be successful.

Step 2:

You have to add a new Application Page with a right-click on the project Solution Explorer -> New item to create Custom Login page

online templates

The form will auto-generate some code where you:

  • Need to remove asp:Content ID="Content1" runat="server" from the CustomLogin.aspx
  • Need to remove DynamicMasterPageFile="~masterurl/default.master" from the @Page Register tag
  • Write simple HTML code for the Login Box user interface including username and password textboxes anda  Login Button like below:
login

Step 3:

  • Add the Microsoft.SharePoint.IdentityModel DLL reference from .\assembly\GAC_MSIL\Microsoft.SharePoint.IdentityModel\14.0.0.0__71e9bce111e9429c \Microsoft.SharePoint.IdentityModel.dll to access SPClaimsUtility
  • Include using Microsoft.SharePoint.IdentityModel; at CustomLogin.aspx.cs
  • Change Inheritance LayoutsPageBase to System.Web.UI.Page
  • Execute the following code inside the Login button click event as below:
bool status = SPClaimsUtility.AuthenticateFormsUser(
                Context.Request.UrlReferrer,
                UserName.Text,
                Password.Text);
if (!status)// if auth failed
{
    lblError.Text = "Wrong Userid or Password";

}
else //if success
{
    Response.Redirect("http://fba.contosto.com"); //Use site url

}

Step 4:

Build the solution. Then Deploy the solution package which will create a folder inside .\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\CustomLoginPageFBA 

Step 5:

Change the custom page URL using following steps:

  • Go to Central Administration.
  • Select Site from Application Management.
  • Click on Authentication Provider.
  • Select Zone and go inside it to get the following Sign In Page URL Section.
  • Change Custom Sign In Page URL.
sign in page
Next Steps
  • Download the complete source code from here
  • Check for a future article on how to register a new user for FBA authentication.


Last Update:


next webcast button


next tip button



About the author





Post a comment or let the author know this tip helped.

All comments are reviewed, so stay on subject or we may delete your comment. Note: your email address is not published. Required fields are marked with an asterisk (*).

*Name    *Email    Email me updates 


Signup for our newsletter
 I agree by submitting my data to receive communications, account updates and/or special offers about SQL Server from MSSQLTips and/or its Sponsors. I have read the privacy statement and understand I may unsubscribe at any time.



    



Learn more about SQL Server tools