LinkedIn

Skip to end of metadata
Go to start of metadata

This page is a step-by-step guide for the process of opening and setting up an external application in LinkedIn as part of the Gigya Setup process.

Note: LinkedIn has limits on their API use. To learn about the limits, please refer to the Throttle Limits page in LinkedIn developer's site.

Note: On May 12, 2015, LinkedIn removed several REST API endpoints currently in use prior to that date. If your app is currently using any of the newly deprecated permissions, you must update it immediately. For more details, or to determine how this may effect your app, please see their Developer Program Transition Guide

Note: If your site is defined under one of Gigya's non-US data centers, replace domain references to (http:// or https://) "socialize.gigya.com" (or "socialize.us1.gigya.com") with "socialize.<DC>.gigya.com". Where <DC> is the region of your Data center (e.g., "socialize.eu1.gigya.com" for European Data center).
Contact your IM to find out the region of your Data center.

Domain references are defined in Gigya's dashboard, externally in social network app definition pages, and when using Gigya's SDKs to set the domain (in particular the APIDomain field in class GSRequest). 

When using any 3rd Party Apps with Gigya, it is important to ensure that you Enable retrieving user contacts from the Permissions page of the Console prior to making your app live. This enables basic username and email retrieval for your users from providers that don't consider this an elevated permission.

 

Phase 1 - Opening the Application in LinkedIn

Optional: If you are planning on configuring a domain alias (CNAME), please insert your alias subdomain (CNAME value) instead of 'socialize.gigya.com' and your domain instead of Gigya's domain. i.e., http://[YOUR-ALIAS-SUB-DOMAIN].yoursite.com/GS/GSLogin.aspx?snid=9042&c=1 in the Authorized Redirect URLs field of the Authentication page.
Note: Please do not use https.

  1. Log into LinkedIn and go to the developers page: https://www.linkedin.com/secure/developer
  2. Click "Create Application".
  3. In the "Create a New Application" dialog, fill in the following details:
    • Company Name
    • Name (of the application)
    • Description
    • Application Logo URL
    • Application Use
    • Website URL
    • Business Email
    • Business Phone
    • Agree to the "LinkedIn API Terms of Use."

  4. After clicking Submit you will be presented with your Authentication Keys, a "Client ID" and a "Client Secret", which correspond to the App ID and App Secret you will need to input into Gigya's website, as described in the next section. Note you can always return to this page by selecting the "Authentication" tab inside your LinkedIn application dashboard.
  5. Under "Default Application Permissions":

6.  Once you have Updated the "Authentication" page, click on the "Settings" tab and under "Application Settings":

  • Choose whether this is a Live version of the app or a Development version under Application Status.
  • Choose to use either Browser Locale Setting or choose an available language from the "Legal Agreement Language" drop-down.


 

Phase 2 - Configuring LinkedIn's Application Keys in Gigya's Website

  1. Go to the Dashboard section of Gigya's website.
    Note: If you are not signed in to Gigya, please go to http://console.gigya.com and sign in.
  2. Press the "Site Settings" button that corresponds to the domain you wish to configure. You will be redirected to the "Site Settings" page.

  3. Select "Providers Configuration" in the Site Settings page.
  4. On the "Providers Configurations" page, select the LinkedIn settings.
  5. Paste the "API Key" and "Secret Key" from Phase 1 in the corresponding places:


  6. Click "OK" and then click the "Save Settings" button (located at the lower right-hand corner of the page).
  7. Ensure that you have checked Enable retrieving email address from the Permissions tab of the Gigya Console under LinkedIn Basic Permissions.

 

That's it, LinkedIn configuration is complete! Please note that it can take up to 10 minutes to synchronize your new settings with LinkedIn.