Documentation of Social Login version 1.0

AutoUpdate DLL

checkforupdate(this.Context, signature);

Parameters

Social Login

Reference

• Add reference to StesCodes_SL.dll
• Import the namespace "StesCodes_SocialLogin"

Settings

Add the below appsettings on your web.config file

    <add key="licensekey" value="StesCodes signature key here"/>
    
    
    <add key="FBApiKey_" value="your facebook api key"/>
    <add key="FBSecretKey_" value="your facebook api secret key"/>
    
    <add key="consumerKey_twitter" value="your twitter api key"/>
    <add key="consumerSecret_twitter" value="your twitter api secret key"/>

    <add key="LiApiKey" value="your linkedin api key" />
    <add key="LiSecretKey" value="your linkedin api secret key" />

    <add key="GPlusApiKey" value="your googleplus api key"/>
    <add key="GPlusSecretKey" value="your googleplus api secret key"/>

    <add key="GoogleApiKey" value="your google api key"/>
    <add key="GoogleSecretKey" value="your google api secret key"/>

    <add key="OrkutApiKey" value="your orkut api key"/>
    <add key="OrkutSecretKey" value="your orkut api secret key"/>

    <add key="consumerKey_yahoo" value="your yahoo api key"/>
    <add key ="consumerSecret_yahoo" value="your yahoo api secret key"/>

    <add key="consumerKey_myspace" value="your myspace api key"/>
    <add key ="consumerSecret_myspace" value="your myspace api secret key"/>

    <add key="wll_appid" value="your live api key"/>
    <add key="wll_secret" value="your live api secret key"/>

    <add key="consumerKey_foursquare" value="your foursquare api key"/>
    <add key ="consumerSecret_foursquare" value="your foursquare api secret key"/>

    <add key="AOL_developerkey" value="your aol api key"/>

    <add key="soundcloudApiKey" value="your soundcloud api key"/>
    <add key="soundcloudSecretKey" value="your soundcloud api secret key"/>

    <add key="MeetupApiKey" value="your meetup api key"/>
    <add key="MeetupSecretKey" value="your meetup api secret key"/>

    <add key="GithubApiKey" value="your github api key"/>
    <add key="GithubSecretKey" value="your github api secret key"/>

    <add key="lastfmApiKey" value="your lastfm api key"/>
    <add key="lastfmSecretKey" value="your lastfm api secret key"/>

    <add key="upcommingApiKey" value="your upcoming api key"/>

    <add key="consumerKey_flickr" value="your flickr api key"/>
    <add key ="consumerSecret_flickr" value="your flickr api secret key"/>
    
            

Login/Register

In-order to start social login, you have to make request to three functions

1. getAuthenticationUrl
2. getAccessToken
3. getUserInformation

To configure API keys, click here How to configure API keys.

Function for getAuthenticationUrl

getAuthenticationUrl(servicename, ConsumerKey, ConsumerSecret, callbackurl);

Parameters

Return type

1. authUrl
2. token
3. tokenSecret
4. tokenVerifier
5. UID
6. error

Function for getAccessToken

getAccessToken(servicename, token, tokensecret, tokenverifier, callbackurl, ConsumerKey, ConsumerSecret);

Parameters

Return type

1. authUrl
2. token
3. tokenSecret
4. tokenVerifier
5. UID
6. error

Function for getUserInformation

getUserInformation(servicename, token, tokensecret, tokenverifier, UID, ConsumerKey, ConsumerSecret, OpenIDData, this.context, IMFile path);

Parameters

Return Types

1. aboutme
2. id
3. displayName
4. firstName
5. lastName
6. email
7. profileUrl
8. photo
9. location
10. phone
11. gender
12. relationship
13. dob
14. error

Function for getOpenIDAuthURL

getOpenIDAuthURL(username, servicename, callbackurl, domainurl);

Parameters

Return type

1. openidurl

Function for getOpenIdData

getOpenIdData(username, querystringallvalue);

Parameters

Return type

1. aboutme
2. dob
3. email
4. fname
5. gender
6. id
7. lname
8. location
9. nickname
10. phone
11. photo
12. profilelink
13. relationship

Debugging

Debugging Windows Live:

1. Upload the socialoauth.aspx page to your server.
2. Do the below five steps when the user is redirected after authentication.
3. Get the post data and construct as a url with querystring parameter(for ex: token=xxx&tokensecret=yyyy as http://youdomain.com/auth.aspx?token=xxx&tokensecret=yyyy)
4. After constructing the parameter change the constructed url to localhost url(for ex: http://youdomain.com/auth.aspx?token=xxx&tokensecret=yyyy to http://localhost:2345/yourproject/auth.aspx?token=xxx&tokensecret=yyyy
5. Redirect to the localhost url(for ex: Response.Redirect(http://localhost:2345/yourproject/auth.aspx?token=xxx&tokensecret=yyyy);)
6. Now you will get the token in localhost for debugging.
7. Remove the redirection part after you done with your debugging.

Binding

Error Handling

Error Message

Configurations

Inorder to perform the autoupdate process successfully, your project should be read/write enabled. Once found update, two files will be updated, one is Social Login dll which is inside bin folder and other is stescodes.im which is outside the bin folder. The stescodes.im file has the details of update info.

If you don't want to provide write permission for the entire project, then follow the below steps:

• Create a folder with write permission or specify a folder with write permission for IMfile
• Pass the location of folder to "checkforupdate" function as fourth parameter(eg: checkforupdate(this.Context, signature,bin location,IMfile location);)
• Also specify the path as additional parameter to "getUserInformation"(specify as additional parameter) function

Permissions

Turn On/Off AutoUpdate

Turn OFF:

In order to turn off autoupdate, login to http://stescodes.com/sourceupdate.aspx then click OFF button. Once autoupdate is set OFF, the DLL with latest updates will not be updated on your server automatically, you have to manually update by downloading the latest DLL from customer login. No need to providing write permission for bin folder.

Even though you turn OFF the autoupdate feature, you should have the below on your project.

• Either you should create a folder with write permission OR provide write permission to root folder. This process is necessary for the stescodes.im file to be created which keeps track of the service validations.
• If you create a folder with write permission then specify that location as parameter for "autoupdate" function and "getUserInformation" function(refer above for passing parameter).

Turn ON:

In order to turn ON autoupdate, login to http://stescodes.com/sourceupdate.aspx then click ON button. Once autoupdate is set ON, the DLL with latest updates will be updated on your server automatically.

If you turn ON the autoupdate feature, you should have the below on your project

• Either you should create a folder with write permission OR provide write permission to root folder.
• If you create a folder with write permission then specify that location as parameter for "autoupdate" function and "getUserInformation" function(refer above for passing parameter).

Change Domain

Edit/Change Domain

• Login to http://stescodes.com/sourceupdate.aspx
• You shall login using email and password which you received in email during purchase or you shall use the StesCodes transaction id
• Once you login, click the edit link near website
• Enter the domain details
• Click "proceed" to save.