[toc]
This procedure enables you to use your LinkedIn credentials to sign into your site.
LinkedIn OAuth requires having a LinkedIn account. Obtaining one is outside of the scope of this article.
You must have SSL set up to use LinkedIn authentication for Telligent Community Server.
Register a new application on LInkedIn
- Sign into LinkedIn.
- Navigate to https://www.linkedin.com/secure/developer?newapp= to set up a new LinkedIn application. If you can't reach that URL, try https://www.linkedin.com/secure/developer and then navigate to Add new application.
- Fill in the following details to create the application:
- In Company (required), enter your company name or select it from the drop-down list.
- In Application name (required), enter a name such as "LinkedIn Oauth."
- Enter a description (required).
- In Website URL (required), enter the site URL.
- In Application use (required) select the appropriate type.
- In Application Developers (optional), enter your contact information.
- Check Include yourself as a developer for this application if you wish to be listed.
- In Live Status (required), select a development stage from the drop-down list.
- In Developer Contact Email (required), enter the contact email for the application.
- In Phone, enter the contact phone number.
- In Agreement language (required, not shown in the screen capture), select the appropriate choice (such as Browser locale setting).
- Select the Agree Terms of Service check box.
- Click Add application. Once registered, LinkedIn will provide you with security details. Copy and save the API key and secret key values to another location.
- Click Done.
Add a secure port in IIS
You must have SSL set up to use LinkedIn authentication for Community Server.
- Open IIS.
- Click Bindings (Sites > [site name] > Actions pane > Edit Site pane > Bindings). The Site bindings window appears.
- Click Add. The Add site binding window appears.
- Select https from the Type drop-down.
- If you are using the IP address where IIS is located, you can leave the IP address field blank; it will default to the current address. If you need to specify a different IP, type that into the IP address field.
- Specify 443 in the Port field.
- Click OK.
Configure the LinkedIn login
- Log into Community Server as an administrator.
- Optional: If you want to give users the opportunity to add their LinkedIn ID to their profile, you can add the field-fillers in the widget at this point. Note that if you select the Required check box, they will be required to furnish this information. To add the field-fillers for LinkedIn in the profile:
- Collect user information upon registration by adding profile fields:
- Navigate to the site home page (or profile page).
- Mouse over Management.
- Click Manage Site theme.
- Click Manage pages.
- Navigate to the user profile page.
- Search for User Registration.
- Click Edit layout.
- Click the Widgets tab.
- On the User - Login and Create widget, click Configure.
- Check the Mode drop-down list and select Create if this is not already selected.
- If desired, enable ReCaptcha using the Enable Captcha check box.
- Move the fields you want to request from the left column to the right column - for example, Facebook - using the > key.
- If you want to require this/these fields for sign-in, select the Required check box(es) on each field.
- Click Save in the panel.
- Click Save and publish.
- Add a Terms of Service requirement:
- Mouse over Management.
- Click Administration.
- Navigate to Setup > Site options > General site settings.
- In the Terms of Service field, enter a URL for your Terms of Service agreement. (Recommendation: To create a TOS specifically for this community, create a content page [Manage site theme > Manage pages > Add custom page]. Copy the TOS page URL to the General Site Settings Terms of Service field.)
- Collect user information upon registration by adding profile fields:
- Click Save.
Configure the Community Server LinkedIn OAuth plugin
- Mouse over Management.
- Click Administration.
- Navigate to Authentication > External authentication.
- Click LinkedIn OAuth Client.
- Click the Enabled check box.
- In the LinkedIn OAuth Client dialog box, paste the following settings into the appropriate text fields:
- API Key: The API key copied from LinkedIn.
- Secret key: The secret key copied from LinkedIn.
- Authorize Base URL (should already be set): https://www.linkedin.com/uas/oauth/authenticate
- Access Token URL (should already be set): https://api.linkedin.com/uas/oauth/accessToken
- Request Token URL (should already be set): https://api.linkedin.com/uas/oauth/requestToken
- Click Save in the configuration panel.
- Log out. If you click Sign in again, LinkedIn will be a sign-in option.
Sign into Community Server with LinkedIn credentials
- In the sign-in screen, click LinkedIn.
- Click Connect with LinkedIn.
Enter your LinkedIn email in the window. - Click Continue. The Community Server welcome screen appears.