This project has moved and is read-only. For the latest updates, please go here.

Version History

Customizing the Web Part Layout

Localizing the SharePoint 2010 FBA Pack

Installing and Configuring the SharePoint 2010 FBA Pack

Configure SharePoint 2010 to use Forms Based Authentication

Before you can use the SharePoint 2010 FBA Pack, SharePoint must be configured to use Forms Based Authentication:

Install (or upgrade) the SharePoint 2010 FBA Pack

  • Download and unzip to the SharePoint server.
  • Open PowerShell and navigate to the folder the files were unzipped to.
  • Run the following command:
    .\deploy [Site Collection URL]
    e.g.  .\deploy http://demo2010a:13824/
  • The FBA Pack will be deployed to SharePoint and activated on the specified site collection. If the site collection url is omitted, you will need to manually activate the 'Forms Based Authentication Management' feature in each site collection you wish to use it.
  • To uninstall run:
    .\undeploy [Site Collection URL]


  • Ensure that the SharePoint 2010 Administration service is running prior to running the deployment scripts, or the deployment will fail.
  • Depending on your PowerShell security settings, it may prevent you from running the deployment scripts because they are not signed.  To change the setting to allow unsigned scripts to run, run the following command: 

Set-ExecutionPolicy Unrestricted

  • Upgrading the FBA Pack will clear the Membership Review List. Please approve any pending membership requests before performing an upgrade.

Configure the FBA Pack

The configuration and management pages can be opened from the Site Settings page:

Select ‘FBA Site Configuration’ to open the configuration page:
Enable Roles: Allows users to be assigned Membership Roles instead of SharePoint Groups on the User Management page.
Review Membership Requests: Specifies whether new users requests should be automatically granted, or reviewed by an administrator.
Membership Review Site URLs: URLs for pages that can be used in the email templates.
Membership Email XSLT: The location of the email templates to use.

Note that these items can only been seen and used by the site collection administrators.

Add the web parts to pages

There are three highly customizable web parts available: Membership Request, Change Password and Password Recovery. They must be manually added to the page you’d like to use them on:

Change Password

Membership Request:

Password Recovery:

Changing your Password

A Change Password item has been added to the user menu that will bring the user to a Change Password page:

Reviewing Membership Requests

If “Review Membership Requests” was selected on the configuration page, new registered users will appear in the Membership Request Management page before being enabled on the site.  Each user can be edited, and their status changed to either Approved or Rejected.  The user will be sent an email with the new status of their account request.

Managing Users

Users can be created, deleted and edited from the FBA User Management page:


Managing Roles

Roles can be created and deleted from the FBA Roles Management page:



Last edited Apr 29, 2013 at 4:41 PM by ccoulson, version 17


tgriffinesc4 Aug 27, 2013 at 9:17 PM 
Excellent Pack - I was able to install and deploy exactly as stated by following the instructions!!
Thank you for making FBA management so easy!
I do have one question -- What is your suggestion to lock down the User Management and Users and Roles Management pages? Currently, even 'Read Only' users can go to "Site Actions" | "All Site content" and access those pages.

hsiungst Mar 4, 2013 at 9:06 PM 
Hi, after a logon is successful - is there a way to redirect user to a custom page?

rubrodmon Sep 14, 2012 at 1:10 PM 
Hello, we have all installed correctly but we have a small problem. When a new user is registered we can see it in Review Membership Request. We change his status but anyone email is sent to him. Can you give me any clue to resolve this problem?

Thank you very much

elforey Aug 11, 2012 at 10:07 PM 
¡¡¡¡Gracias Totales!!!! ....

Voldemaring Aug 9, 2012 at 2:41 PM 
I had the "A Membership Provider has not been configured correctly. Check the web.config setttings for this web application" as well. <b>Turned out that the user of the AppPool didn't have rights on the membership database.</b>

jainamit Aug 3, 2012 at 7:31 AM 
Read how to setup FBA using IIS

kamranrafi May 1, 2012 at 9:59 AM 
I have deployed everything successfully, but user register webpart upon submission shows "Unknown Error" message. Any thing I am missing?

sams177 Apr 27, 2012 at 6:13 AM 
Thanks for the kit. I am successfully able to add all the configuration.

Now, my need is to add "Forgot Password" and "Membership Request' links on sign in page (_forms/default.aspx). Please let me know the steps/ideas.


luzhanxun Mar 16, 2012 at 1:21 AM 

Thanks very much for this great pack.

For the FBA, I have create a custom login page, How can I add the password recovery part into the login page?

octopus Mar 7, 2012 at 9:39 PM 
Thank Youvery much for the solution, very much like it. One question how do we add new fields in membership access form to capture more data then just username first name last name and email. i want to add department name department number phone number etc..

Any help would be appreciated.
Thank You

octopus Mar 7, 2012 at 4:54 PM 
Thank You very much for this solution. But is there a way to capture more data when user is registering for user access using memebership access form. I want to add fields like department name, department manager, phone number and some other information. Can you please provide me right direction to accomplish this task.
Thank You

ibrahimsa3d Mar 4, 2012 at 3:03 PM 
hi ,,
I get an error when i trying to deploy FBA PAck
error msg: Disable -SPFeature : then feature not foundprovide a Guide and -Force parameter then try again
anybody have asolution plz

AshrafH Feb 8, 2012 at 5:16 AM 
For installation the following steps will be helpful,
1.configure Form based authentication as this
2.Open SharePoint Powershell as "Run As Administrator" and navigate to the FBAPack download folder.
3. Run this command, Set-ExecutionPolicy Unrestricted
4. then run, .\deploy http://demo2010a:13824/

ArnoldVilleneuve Feb 1, 2012 at 6:19 PM 

Cool stuff.

I followed the instructions and got the software deployed. Enabled the Role. Added the Change Password webpart to a web page but then I get the following error:

A Membership Provider has not been configured correctly. Check the web.config setttings for this web application.

I'm using SharePoint 2010 Foundation.

dannyjessee Jan 27, 2012 at 12:04 AM 
I had to add ".en-US" before .resx for the following files in order for this to work:

C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\Resources\

Also, is there a way to bypass the SMTP server requirement for sending email?

Thank you for this great project! I really like what you've put together.

Ahmedbohoty Dec 22, 2011 at 3:06 PM 
This error appears to me when i'm tried to deploy it
The Web application at http://http://win-rtt4l2rllsg:46265/sites/FBADemoSite cou
ld not be found. Verify that you have typed the URL correctly. If the URL should
be serving existing content, the system administrator may need to add a new req
uest URL mapping to the intended application.

elked Dec 21, 2011 at 8:01 AM 
where can I configure the email-address that sends the new password?

ccoulson Dec 1, 2011 at 12:35 AM 
Please post any questions to the discussion forums

ToddLeeCarter Oct 12, 2011 at 7:33 PM 
Hi, I am using 2010 Foundation. Most everything seems to be working correctly. The issue I am having is with Membership Request. After a request is made and the account is set to Approved there is no email sent out. IsInSharePoint is ser to “Yes” in Manage Forms Based Authentication Users. Other emails are sent (IE New User from FBA User Management). Also, I can find no way to set the users initial password. When you approve the user via the Edit context menu in Site Membership Review List there is no place to set the password. If you edit the user through FBA User Management there is no Reset Password button as seen in your screen shot. Am I missing something or did the feature not fully deploy?

brk007 Sep 27, 2011 at 11:31 AM 
Everything is okay but emails are not going out to the registered users. How to configure mail for FBA pack

Liakath Sep 21, 2011 at 11:26 AM 
thank you very much for your FBA feature. It help me a lot. I did everything fine. and all features are working fine.
Query: I have enabled roles and created one role(named with Standard User). If a new user want to create his account in my anonymous access site . I gave a link((/_layouts/FBA/Management/UserNew.aspx)) to quick launch panel in Anonymous access site.
When the new user will click on this link to create his account, it is asking for Authentication(asking for login).
actually new user will not have any account, he needs to create account. but the link asking to log first and create user next. NewUser.aspx page should be public.
Hope you can get my point and reply me soon.

eakawie Sep 9, 2011 at 7:21 PM 
I've got everything installed, and can add users through the Management page, but when I try to add one of the webparts to a page I get the following error:

A Web Part or Web Form Control on this Page cannot be displayed or imported. The type is not registered as safe.

Any ideas?

kocabian Jul 8, 2011 at 4:38 PM 
I deployed the feature to a specific site collection ,
Then after a month i uninsllated without giving URL by .\undeploy without URL, it went and undeployed on all site collections, is this by design or a bug ?!
I do not see it in none of my site collection features.

ofergal Jul 7, 2011 at 1:08 AM 
I deployed SharePoint2010FBAPack.1.0.3 with no problem to an empty site collection (not team)
All is fine except "FBA Membership Request Management " throws an error:
<nativehr>0x8107058a</nativehr><nativestack></nativestack>Operation is not valid due to the current state of the object.
I also do not see the List created. What am I missing?

syerneni84 Jun 16, 2011 at 3:45 PM 

I installed Sharepoint FBA pack, all the links under site settings are working fine. expect the FBA Role Management. When ever I clicked on this link, it shows the below error page. I checked web.config file custom errors are turned Off. Any idea why Role Management link is not working under site settings.

Server Error in '/' Application.

Runtime Error
Description: An application error occurred on the server. The current custom error settings for this application prevent the details of the application error from being viewed.

Details: To enable the details of this specific error message to be viewable on the local server machine, please create a <customErrors> tag within a "web.config" configuration file located in the root directory of the current web application. This <customErrors> tag should then have its "mode" attribute set to "RemoteOnly". To enable the details to be viewable on remote machines, please set "mode" to "Off".

<!-- Web.Config Configuration File -->

<customErrors mode="RemoteOnly"/>

Notes: The current error page you are seeing can be replaced by a custom error page by modifying the "defaultRedirect" attribute of the application's <customErrors> configuration tag to point to a custom error page URL.

<!-- Web.Config Configuration File -->

<customErrors mode="On" defaultRedirect="mycustompage.htm"/>

mdorland Jun 6, 2011 at 11:03 PM 
Okay I'm sure I'm missing something simple or did something but I am not seeing any of the FBA choices under Users and Permissions after I've got everything else working. I can manually create accounts in the database and log in with them. Sharepoint says the solution is installed for the site, yet only seeing the default three choices under Users and Permissions. I'm sure it's probably something simple I've overlooked but I think my brain has melted and could use some advice.

ccoulson Jun 6, 2011 at 3:25 AM 
Please post any questions to the discussion forums

ccoulson Jun 6, 2011 at 3:25 AM 
cchaney_64: It's fairly trivial to remove the Administrator requirement - just edit each of the pages - there's a "RequiresSiteAdministrator" property on each - just set it to return false instead of true. You have to be careful though, as the membership database is shared between all site collections on the web application - so users from all site collections could be edited (which is why i've set it to require administrator privileges).

tbarber Jun 3, 2011 at 3:29 AM 
I have installed everything just fine and am able to add the Membership Request webpart. However, when I try to create a new user, I receive an error message and the following entry is in my logs:

System.Exception: Error sending mail notification at Visigo.Sharepoint.FormsBasedAuthentication.MembershipRequest.ApproveMembership(MembershipRequest request, SPWeb web)

I have no problem receiving outgoing emails, as I have tested this with a notification. Am I missing something?

richardkelly May 24, 2011 at 6:15 AM 
I’m having an issue with part of the application. I successfully installed this yesterday and was able to use all of the features from the Site Settings page and even added a couple test users.
Today, I managed to break the “FBA Membership Management” page and I’m not sure how. I haven’t modified anything and the undeploy to remove it then deploy to add it back didn’t do any good.
Please advise on what other steps I should either test or reset to gain this feature back. Thanks!

cchaney_64 May 24, 2011 at 12:15 AM 

We have multiple customer sites within our customer site collection and would like to give each customer a site admin account where they can maintain their own users. In the instructions it states the user must be a site collection administrator in order to use the management tools. How would we go about changing the package to remove this requirement so site-level admins don't have to be a site-collection admin in order to administer users? Is it possible?

itpreneur May 23, 2011 at 4:36 PM 
I got this working and was about to create a new user to try it out. Apparently, I'm always having an issue on password. It always says "Password answer is invalid". Not sure what it means but I'm pretty I got it right pass@word1 as my example password. The page also indicates if there are mismatch password on the confirmation box.

itpreneur May 23, 2011 at 4:25 PM 
When running the powershell script deploy, also run simultaneously in the command prompt as admin, and run the following stsadm -o execadmsvcjobs.
this would resolve to finish the timer job set. you may like to to target particular webapplications and edit the deploy scripts by remove -allwebapplications and using -WebApplications IntranetSite so it is targeted only.

mohannaid May 23, 2011 at 11:19 AM 

I have configured FBA in my Sharepoint foundation site successfully. But when i try to Install the SharePoint 2010 FBA Pack, it is giving the below message and taking long time in power shell.


Going to add solution

Name SolutionId Deployed
---- ---------- --------
visigo.sharepoint.formsbase... 956715d5-f34c-4b00-bfb7-8c35d5fa0f62 False

Going to install solution to all web applications
Install-SPSolution : Admin SVC must be running in order to create deployment timer job.
At D:\.....\SharePoint2010FBAPack.1.0.2\Deploy.ps1:50 char:19+ Install-SPSolution <<<< -identity $solutionName -allwebapplications -GACDeployment + CategoryInfo : InvalidData: (Microsoft.Share...InstallSolution: SPCmdletInstallSolution) [Install-SPSolution], SPCmdletException + FullyQualifiedErrorId : Microsoft.SharePoint.PowerShell.SPCmdletInstallSolution

Waiting for job to finish
Waiting to finish job solution-deployment-visigo.sharepoint.formsbasedauthentica


There is no end for this. Now my question is, what is the problem in executing this. If there is any mistake i did, please correct me...


Daniluk May 21, 2011 at 7:23 PM 
Howdy! Ok, got everything working...somewhat. I set the provider for .NET Users to require Question and Answer. (Prior to installation of FBAPack. There is not a Q & A field on the new user page, so when I attempt to add a new user I get the error that the Q & A are invalid. Changing the provider to NOT require Q & A allows the add user to work. Am I missing a configuration item somewhere, or ???


brandtsmith May 18, 2011 at 3:15 AM 
how would you go about adding a few more fields to the registration page...collect a little more data that will help an approver determine whether or not to approve the registration request...not much info in that request???

ccoulson May 9, 2011 at 9:31 AM 
Currently I don't include a custom login page, so you'll have to create your own. There's lots of sites with directions, such as this:

tylercranston May 4, 2011 at 6:17 PM 
Or am I supposed to be redirecting the login page to a different page?

tylercranston May 4, 2011 at 6:01 PM 

How do I add a link to the password recovery page from the login page?

poulterhd Apr 27, 2011 at 5:52 PM 
Read the directions at the top about "Set-ExecutionPolicy Unrestricted"

dharmbhav Apr 24, 2011 at 4:14 AM 
I tried to install the package but got this error: "File ...\Deploy.ps1" cannot be loaded. The file .....\Deploy.ps1 is not digitally signed. The script will not execute on the system. .....