Administration: Set up external STS login

You can setup Sitefinity CMS 6.0 and above to use external Security Token Service (STS), such as Facebook, Google, or Amazon.

PREREQUISITES: You must be running your project on IIS. For more information, see Run projects on IIS.

This way, your user do not need to explicitly register in Sitefinity CMS, but can use their Facebook, Google, or Amazon credentials.

1. Download and install NuGet from https://nuget.org/. 
2. Download and extract the zip file from https://github.com/Sitefinity/Sitefinity-External-STS-Integration.
3. Open you Sitefinity CMS project in Visual Studio.
4. In the Solution Explorer, in the context menu of your solution, click Add... » Existing Project…
5. Open the extracted archive, find and select OauthExternalAuthentication.csproj file.
   The OauthExternalAuthentication project is added to your solution.
6. In the Solution Explorer, under OauthExternalAuthentication project, open the context menu of References and click Add Reference… 
7. Select Browse tab and browse to the folder with your Sitefinity CMS project.
8. Open the bin folder of your Sitefinity CMS project and select the following .dll files:
   
   • Telerik.Sitefinity
   • Telerik.Sitefinity.Model
   • Telerik.Sitefinity.Utilities
   • Telerik.OpenAccess
9. Click OK.
10. In Visual Studio, open the Package Management Console, by clicking Tools » Library Package Manager » Package Management Console.
    The console opens. Perform the following:
    1. In Default project: dropdown box, select OauthExternalAuthentication and perform the following:
       1. In the console, enter Install-Package Microsoft.AspNet.Membership.OpenAuth and press ENTER.
       2. In the console, enter Install-Package DotNetOpenAuth.AspNet and press ENTER.
    2. In Default project: dropdown box, select SitefinityWebApp and perform the following:
       1. In the console, enter Install-Package Microsoft.AspNet.Membership.OpenAuth and press ENTER.
       2. In the console, enter Install-Package DotNetOpenAuth.AspNet and press ENTER.
       3. If you are running a Sitefinity CMS 6.1 project, in the console, enter Install-Package Newtonsoft.Json and press ENTER.
11. Under your SitefinityWebApp project, open the context menu of References folder.
12. On the Projects tab, select OauthExternalAuthentication and click OK.
13. Build you solution.
14. Login to your Sitefinity CMS backend and click Administration » Modules & Services » Install a module.
15. In Name, enter OauthExternalAuthentication.
16. In Type, enter OauthExternalAuthentication.OAuthAuthenticationModule, OauthExternalAuthentication
17. Click Save.
    The OAE module is registered as a module and has its own configuration section.
18. To configure the parameters of the login providers, click Administration » Settings » Advanced.
19. In the treeview on the left, click OAE and perform the following:
    
    • To configure Facebook login, you must setup a Facebook application.
      For more information, see Setting Up The Authentication Integration with Facebook » Part 1: Setting Up a Facebook Application.
      

      In Facebook Application ID Title, enter the acquired App ID and in Facebook Application Secret Key Title, enter the App Secret.

    • To configure Google login, select Enable Google Plus checkbox.
20. Click Save changes.
21. On your login page, instead of the Login widget, drop the OAutLogin widget.
22. Click its Edit button and click Select a page.
23. You can select a page where the Profile widget is added.
    This way your users will be able to create and complete their profiles in Sitefinity.
    The page that you selected is the page where the users are redirected after authenticating.
24. Restart your application.