%META:TOPICPARENT{name="OdsSetLoginAuthenticaionKeys"}%

---+Using LinkedIn OAuth key-secret Configuration Guidelines

%TOC%

---++ What?
Use LinkedIn as 3rd party application for registering a new user or logging into ODS DataSpace as already registered ODS User which account is associated with a given LinkedIn account.


---++ Why? 
Makes the process of managing users register/log in activities easier. 


---++ How?

In order to be able to register a new user or to log in into ODS Dataspace as already registered ODS user, you need to:
   * Create ODS application within LinkedIn:
      1 Get an API Key -- for identification;
      1 Get an Secret Key -- for hash salting;
      1 Provide a Callback URL -- for request & access token exchange via redirection.
   * Configure as ODS Administrator in Site Settings->Login Authentication Keys the LinkedIn API to use the generate from above API and Secret Key.

When the above is done, you can perform the following activities in ODS:
   * Register in ODS using your LinkedIn credentials, or:
   * For a regular ODS user, for ex. with name XXX you can add in Profile->Personal->Online Accounts your LinkedIn account, which then will enable you to log in in your ODS XXX user dataspace using the LinkedIn account credentials.



---++ Examples


---+++ Prerequisites

   * A [[http://linkedin.com/][LinkedIn user account]] 
   * Administrative (DBA) access to a [[http://virtuoso.openlinksw.com/][Virtuoso Server]] instance, on which the following have been installed --
      * [[https://virtuoso.openlinksw.com/download/][ODS-Framework VAD package]]


---++++ Steps for Configuring LinkedIn API Key and Secret Key

---+++++ 1 -- Get LinkedIn API Key and Secret Key for use with ODS 

   1 Browse to <[[https://www.linkedin.com/secure/developer][https://www.linkedin.com/secure/developer]]> and enter your LinkedIn use credentials:
%BR%%BR%<a href="%ATTACHURLPATH%/step1-1.png" target="_blank"><img src="%ATTACHURLPATH%/step1-1.png" width="600px" /></a>%BR%%BR%
%BR%%BR%<a href="%ATTACHURLPATH%/step1-2.png" target="_blank"><img src="%ATTACHURLPATH%/step1-2.png" width="600px" /></a>%BR%%BR%
   1 Click on <b>Add New Application</b>:
%BR%%BR%<a href="%ATTACHURLPATH%/step1-2a.png" target="_blank"><img src="%ATTACHURLPATH%/step1-2a.png" width="600px" /></a>%BR%%BR%
%BR%%BR%<a href="%ATTACHURLPATH%/step1-3.png" target="_blank"><img src="%ATTACHURLPATH%/step1-3.png" width="600px" /></a>%BR%%BR%
   1 In the presented form:
      1 "Company Info" section: enter company details if such are required for new companies;
      1 ""Application Info" section:
         1 Enter a name for your LinkedIn client application to be known by, e.g., "<nop>MySimpleExample";
         1 Enter a description, e.g., "My LinkedIn Example Application";
         1 Enter Website URL, e.g., http://example.com/;
         1 Set "Application Use";
      1 "Contact Info" section:
         1 Enter developer contact email;
         1 Enter phone for contact
      1 "OAuth User Agreement" section:
         1 <b>Provide a Callback URL</b> -- enter in "OAuth Redirect URL" your ODS site URL that should match the host of the ODS installation. For ex. if ODS runs at http://example.com/ods/ then the URL in the Facebook app should be http://example.com.com;
         1 Set language.
      1 "Term of Service" section: hatch the "Agree" check-box.
%BR%%BR%<a href="%ATTACHURLPATH%/step1-4.png" target="_blank"><img src="%ATTACHURLPATH%/step1-4.png" width="600px" /></a>%BR%%BR%
%BR%%BR%<a href="%ATTACHURLPATH%/step1-5.png" target="_blank"><img src="%ATTACHURLPATH%/step1-5.png" width="600px" /></a>%BR%%BR%
%BR%%BR%<a href="%ATTACHURLPATH%/step1-6.png" target="_blank"><img src="%ATTACHURLPATH%/step1-6.png" width="600px" /></a>%BR%%BR%
   1 Click "Add Application".
   1 The application should be registered and you will be shown a <b>API Key</b> and <b>Secret Key</b> for the newly registered application. You can copy these now as you will need these in the steps that follow:
%BR%%BR%<a href="%ATTACHURLPATH%/step1-7.png" target="_blank"><img src="%ATTACHURLPATH%/step1-7.png" width="600px" /></a>%BR%%BR% 

---+++++ 2 -- Configure ODS to use your LinkedIn Consumer Key and Secret 

   1 Browse to your Virtuoso + ODS instance, <code>http://&lt;cname&gt;[:&lt;port&gt;]/ods</code>, e.g., &lt;[[http://example.com/ods/][http://example.com/ods/]]&gt;, and click <b>Sign In</b>.
%BR%%BR%<a href="%ATTACHURLPATH%/step2-1.png" target="_blank"><img src="%ATTACHURLPATH%/step2-1.png" width="600px" /></a>%BR%%BR%
   1 Log in as a Virtuoso+ODS user with Administrator privileges, e.g., <code>dba</code>.
%BR%%BR%<a href="%ATTACHURLPATH%/step2-2.png" target="_blank"><img src="%ATTACHURLPATH%/step2-2.png" width="600px" /></a>%BR%%BR%
   1 Click on <b>Site Settings</b>:
%BR%%BR%<a href="%ATTACHURLPATH%/step2-3.png" target="_blank"><img src="%ATTACHURLPATH%/step2-3.png" width="600px" /></a>%BR%%BR%
   1 Click on <b>Login Authentication Keys</b>:
%BR%%BR%<a href="%ATTACHURLPATH%/step2-4.png" target="_blank"><img src="%ATTACHURLPATH%/step2-4.png" width="600px" /></a>%BR%%BR%
   1 Select <b><nop>LinkedInAPI</b> in the <b>API Name</b> menu, provide the <b>API Key</b> and <b>Secret Key</b> from the new LinkedIn application you created above, and click <b>Add</b>.
%BR%%BR%<a href="%ATTACHURLPATH%/step2-5.png" target="_blank"><img src="%ATTACHURLPATH%/step2-5.png" width="600px" /></a>%BR%%BR%
   1 ODS is now configured to use <nop>LinkedIn.
%BR%%BR%<a href="%ATTACHURLPATH%/step2-6.png" target="_blank"><img src="%ATTACHURLPATH%/step2-6.png" width="600px" /></a>%BR%%BR%


---+++Example for Configuring regular ODS user to log in into ODS using LinkedIn Account credentials

Here is a sample scenario how to configure a regular ODS user to be able to log in in its ODS Dataspace using his/her own LinkedIn Account:
  
   1 Browse to your Virtuoso + ODS instance, <code>http://&lt;cname&gt;[:&lt;port&gt;]/ods</code>, e.g., &lt;[[http://example.com/ods/][http://example.com/ods/]]&gt;.
%BR%%BR%<a href="%ATTACHURLPATH%/step3-1.png" target="_blank"><img src="%ATTACHURLPATH%/step3-1.png" width="600px" /></a>%BR%%BR%
   1 Log in as a Virtuoso+ODS user with normal privileges, e.g., <code>demo</code>.
%BR%%BR%<a href="%ATTACHURLPATH%/step3-2.png" target="_blank"><img src="%ATTACHURLPATH%/step3-2.png" width="600px" /></a>%BR%%BR%
   1 Go to Profile Edit->Personal->Online Accounts:
%BR%%BR%<a href="%ATTACHURLPATH%/step3-3.png" target="_blank"><img src="%ATTACHURLPATH%/step3-3.png" width="600px" /></a>%BR%%BR%
   1 Click "Add":
%BR%%BR%<a href="%ATTACHURLPATH%/step3-4.png" target="_blank"><img src="%ATTACHURLPATH%/step3-4.png" width="600px" /></a>%BR%%BR%
   1 In the presented form select service LinkedIn. By default the "<code>Member Home Page URI</code>" has <code> http://linkedin.com/in/&lt;your-ODS-user-name&gt; </code> and the "<code>Account URI</code>" has value <code> http://host:port/about/id/entity/http/linkedin.com/in/&lt;your-ODS-user-name&gt;#this </code>. You need to change the <code> &lt;your-ODS-user-name&gt; </code> from these URLs with your LinkedIn account name.
%BR%%BR%<a href="%ATTACHURLPATH%/step3-4b.png" target="_blank"><img src="%ATTACHURLPATH%/step3-4b.png" width="600px" /></a>%BR%%BR%
   1 Click the "Link" button from "Action" column:
%BR%%BR%<a href="%ATTACHURLPATH%/step3-4a.png" target="_blank"><img src="%ATTACHURLPATH%/step3-4a.png" width="600px" /></a>%BR%%BR%
   1 Finally click "Save".
   1 Log out from ODS DataSpace.
   1 Make sure LinkedIn Login is enabled from admin user available at Site Settings -> Members Registrations:
%BR%%BR%<a href="%ATTACHURLPATH%/step3-5.png" target="_blank"><img src="%ATTACHURLPATH%/step3-5.png" width="600px" /></a>%BR%%BR%
   1 Click Sign In.
   1 Go to "LinkedIn" tab:
%BR%%BR%<a href="%ATTACHURLPATH%/step3-6.png" target="_blank"><img src="%ATTACHURLPATH%/step3-6.png" width="600px" /></a>%BR%%BR%
   1 Click "LinkedIn Login".
   1 LinkedIn should ask you to for authorization for the created application from above:
%BR%%BR%<a href="%ATTACHURLPATH%/step3-7.png" target="_blank"><img src="%ATTACHURLPATH%/step3-7.png" width="600px" /></a>%BR%%BR%
   1 Click "Allow Access" in the LinkedIn form.
   1 On a successful authorization you should be redirected back to the ODS DataSpace and should be logged in as the regular user from above, e.g: user "demo".
%BR%%BR%<a href="%ATTACHURLPATH%/step3-8.png" target="_blank"><img src="%ATTACHURLPATH%/step3-8.png" width="600px" /></a>%BR%%BR%

---++Related

   * [[OdsSetLoginAuthenticaionKeys][Set up Login Authentication Keys in ODS]]
      1 Examples using 3rd Party Accounts for register/log in in ODS DataSpace:
      * [[OdsFacebookAPIKeySecretExUsage][Using Facebook -- OAuth consumer key-secret Configuration Guidelines]]
      * [[OdsTwitterAPIKeySecretExUsage][Using Twitter -- OAuth consumer key-secret Configuration Guidelines]]
      1 Examples using 3rd Party Services for data management:
         * [[OdsBriefcaseAmazonS3][Using ODS-Briefcase to mediate access to data stored on Amazon S3]]   
         * [[OdsBriefcaseBoxNet][Using ODS-Briefcase to mediate access to data stored on Box (a/k/a box.com or box.net)]]
         * [[OdsBriefcaseDropBox][Using ODS-Briefcase to mediate access to data stored on DropBox]]
         * [[OdsBriefcaseGoogleDrive][Using ODS-Briefcase to mediate access to data stored on Google Drive]]   
         * [[OdsBriefcaseSkyDrive][Using ODS-Briefcase to mediate access to data stored on Microsoft OneDrive (formerly SkyDrive)]] 
   * Virtuoso Cartridges Configuration:
      * [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtCartConfigFacebook][Facebook Cartridge - Configuration Guidelines]]
      * [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtCartConfigGooglePlus][Google+ Cartridge - Configuration Guidelines]]
      * [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtCartConfigLinkedIn][LinkedIn Cartridge - Configuration Guidelines]]
      * [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtCartConfigTwitter][Twitter Cartridge - Configuration Guidelines]]
   * [[VirtOAuthControllers][OAuth Generate Keys for ODS Controllers (Web Services)]]
   * [[http://virtuoso.openlinksw.com/wiki/main/Main/VirtuosoOAuthProgrammersGuide][Use OAuth for authentication, SPARQL queries, Ubiquity commands]]
   * [[VirtOAuthTestTool][Use the Virtuoso OAuth Test tool to manage my Data Space data]]
   * [[VirtuosoOdsControllers][Manipulate User Data via REST using authentication based on OAuth, sessions, or password hash]]
   * [[ODSProgrammersGuide][ODS Programmers' Guide]]
   * [[http://virtuoso.openlinksw.com/wiki/main/Main/VirtuosoOAuthProgrammersGuide][Virtuoso OAuth Programmers' Guide]]
   * [[VirtOAuthExamples][Examples of ODS Application Authentication using OAuth]]
   * [[VirtuosoOdsUbiquityTutorialsOAuth][OAuth Ubiquity Tutorial]]
   * [[http://virtuoso.openlinksw.com/wiki/main/Main/VirtOAuthSPARQL][SPARQL OAuth Tutorial]]