Documents‎ > ‎1. Installation‎ > ‎

1. Quick Start

This document helps you to deploy, install and configure your SharePoint web application to use Shetab SharePoint Live Authentication. All steps can be done and customized with stsadm command, but for simplicity we provide batch file to make to process more easily.

Note: After you purchase commercial license you need do some additional steps to install your certificate and deploying a Security Token (STS), but free trial users can simply ignore them and just do the following steps.

Video Tutorial

You can watch the following video tutorial or just follow the instruction in this document. This video tutorial created for SharePoint 2010 but there is exactly the same step for SharePoint 2013.

How to install and configure SharePoint Live Authentication

Check Requirements

  1. SharePoint Foundation 2010 or SharePoint Server 2010 or SharePoint Foundation 2013 or SharePoint Server 2013 should be installed on your server.
  2. You have root access to a server with an administrator privilege account, otherwise you will get an access denied error while executing batch file. You can do one of the following to run the bat file:
    • Run with "administrator" account. Account name should be exactly "administrator" not a user that exists in the administrators group
    • Run Batch File as Administrator.
    • Turn off UAC (User Account Control).
  3. Make sure the date and time of your SharePoint machine is valid.
  4. Make sure your SharePoint Web Application created with "Claims Based Authentication" not Classic Authentication.

Download and deploy Shetab SharePoint Live Authentication Solution

  1. Download the Free Trial edition from here.
  2. Extract zip file.
  3. Open the Deployment folder from the extracted folder.
  4. Run Deploy.bat file.
Note: if you have already deployed the solution you should run Redeploy.bat.
Note: If you run Redeploy.bat at first time, you will see just some error message that the solution doesn't exist, these errors can be ignored.

Install Shetab SharePoint Live Authentication as Trusted Identity provider

  1. Open Configure folder where you extract the product.
  2. Run Install.bat file.
Note: If you already run install.bat before, you will see some error that can be ignored.
Note: Only one instance of Trusted Identity provider can be installed on the server, so if you have installed one before, you should un-install it before running Install.bat.

Configure your SharePoint Web Application to use Shetab SharePoint Live Authentication

  1. Open Configure folder where you extract the product.
  2. Open Vars.bat file with a text editor such as Notepad and set your SharePoint web application URL in url parameter and save the file. 
    Example: @SET url=http://lo​calhost
  3. Run Add.bat file.
  4. Congratulation, Now everyone can sign-in to your site with any OpenID provider, such as Facebook, Microsoft, Google and Yahoo!
Note 1: SharePoint Application at specified URL should be created with Claims Based Authentication not Classic Authentication.
Note 2: Make sure the date and time of your SharePoint machine is valid, otherwise the timestamp of sign-in message will be invalid and you will redirect back to sign-in page each time.
Note 3: If no site collection exists in the web application URL, you should set Profile Site too. Example: @ProfileSiteUrl=http://lo​calhost/sites/site1
Note 4: Current user of Windows which you logged with , should exist in Site Collection Administrators of the Profile Site otherwise you will get Access Denied Error.
Note 5: If you have "alternative mapping address" for your SharePoint site, you should repeat this process for each mapping address.

Optional Parameters

These parameters is optional and you can simply ignore them.

Changing Profile Site

Shetab SharePoint Live Authentication use SharePoint lists to store its database such as user profiles, this list will be created in your web application and only site collection administrator can see them. You can tell Shetab SharePoint Live Authentication to create these lists to another SharePoint site with following ProfileSiteUrl parameter in "vars.bat" file.
Example: @SET ProfileSiteUrl=http://localhost:500

User's E-Mail Compulsion

You can set whether the user should enter their emails or not by set the EmailRequired parameter in "vars.bat" file, but Shetab SharePoint Live Authentication always tries to verify users emails' by the email verification system, it means even you set Email Required to false, it just don’t force users to enter e-mail but if they enter email, they should verify it. 
Example: @SET EmailRequired=false

Use SharePoint default sign-in page

Shetab SharePoint Live Authentication redirects user to its own sign-in page by default, if you like to use original SharePoint multi login page that ask the user the authentication system first, you can set ​SetAsDefaultSignInPage parameter to false.
Example: @SET SetAsDefaultSignInPage=false