16
IBM ® Kenexa ® BrassRing ® on Cloud LinkedIn Integration Application (App) creation with LInkedIn Last Updated: May, 2016

LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

  • Upload
    others

  • View
    29

  • Download
    0

Embed Size (px)

Citation preview

Page 1: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

IBM® Kenexa® BrassRing® on Cloud

LinkedIn Integration

Application (App) creation with LInkedIn Last Updated: May, 2016

Page 2: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

IBM® Kenexa® BrassRing® on Cloud

BR API Library

Edition Notice

Note: Before using this information and the product it supports, read the information in Notices.

This edition applies to IBM® Kenexa® BrassRing® on Cloud API Reference Guide and to all subsequent releases and

modifications until otherwise indication in new editions.

Licensed Materials - Property of IBM

© Copyright IBM® Corporation, 2015.

US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract

with IBM Corp.

Notices This information was developed for products and services offered in the U.S.A and other countries. Consult your

local IBM representative for information on the products and services currently available in your area. Any

reference to an IBM product, program, or service is not intended to state or imply that only that IBM product,

program, or service may be used. Any functionally equivalent product, program, or service that does not infringe

any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and

verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The

furnishing of this document does not grant you any license to these patents. You can send license inquiries, in

writing, to:

IBM Director of Licensing

IBM Corporation North Castle Drive

Armonk, NY 10504-1785

U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department

in your country or send inquiries, in writing, to:

Intellectual Property Licensing

Legal and Intellectual Property Law

IBM Japan Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa

242-8502 Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are

inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION “AS IS” WITHOUT WARRANTY

OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF

NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this

statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the

information herein; these changes will be incorporated in new editions of the publication. IBM may make

Page 3: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

IBM® Kenexa® BrassRing® on Cloud

BR API Library

improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time

without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any

manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials

for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the

information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of

information between independently created programs and other programs (including this one) and (ii) the mutual

use of the information which has been exchanged, should contact:

IBM Corporation 5 Technology Park Drive Westford Technology Park Westford, MA 01886

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment

of a fee.

The licensed program described in this information and all licensed material available for it are provided by IBM

under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent

agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results

obtained in other operating environments may vary significantly. Some measurements may have been made on

development-level systems and there is no guarantee that these measurements will be the same on generally

available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual

results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published

announcements or other publicly available sources. IBM has not tested those products and cannot confirm the

accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the

capabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and

represent goals and objectives only. All IBM prices shown are IBM's suggested retail prices, are current and are

subject to change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject to change before the products

described become available.

This information contains examples of data and reports used in daily business operations. To illustrate them as

completely as possible, the examples include the names of individuals, companies, brands, and products. All of

these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is

entirely coincidental.

Trademarks

These terms are trademarks of International Business Machines Corporation in the United States, other countries,

or both:

• IBM

• AIX

• Sametime

• WebSphere

Page 4: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

IBM® Kenexa® BrassRing® on Cloud BR API Library

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its

affiliates.

Microsoft and Windows are registered trademarks of Microsoft Corporation in the United States, other countries,

or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.

Page 5: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

IBM® Kenexa® BrassRing® on Cloud BR API Library

Contents

Edition Notice ......................................................................................................................................................... 2

Notices ................................................................................................................................................................... 2

Contents ...................................................................................................................................................................... 5

Introduction ................................................................................................................................................................ 5

Purpose .................................................................................................................................................................. 6

Audience ................................................................................................................................................................ 6

Create LinkedIn App ..................................................................................................................................................... 7

Application details required to create a LinkedIn App................................................................................................. 7

App creation steps .................................................................................................................................................. 7

1. My Apps in LinkedIn ............................................................................................................................................................................ 7

2. Sign-up with LinkedIn .......................................................................................................................................................................... 8

3. Application Creation ........................................................................................................................................................................... 8

4. My Applications ................................................................................................................................................................................ 13

5. Edit and Usage reports ...................................................................................................................................................................... 13

Activating (Whitelisting) LinkedIn APPs ..............................................................................................................

16

Send an e-mail to LinkedIn support ....................................................................................................................

16

Workbench Configuration ......................................................................................................................................

16

IBM® Kenexa® BrassRing® on Cloud

BR API Library

Introduction

IBM® Kenexa® BrassRing® on Cloud is partnered with LinkedIn and allows clients to create Apps with LinkedIn

to configure the below supported featured.

• Posting to LinkedIn

• Profile import from LinkedIn

• Login with LinkedIn

Page 6: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

Purpose The purpose of this document is to provide guidance and information on creating LinkedIn Apps and Activating

(whitelisting) these Apps with LinkedIn to get further access to features such as Apply with LI.

This document talks about the two steps of creating and activating (whitelisting) LinkedIn APPs

• Process of creating LinkedIn Apps

• Process to get further access to these Apps by sending an e-mail to linkedIn

Please see the separate document “BrassRing LI Cross System Awareness” housed on URC for specific steps

to setup the API that will be needed for that functionality.

Audience The intended audience for this document is:

BrassRing Customers, Configuration Engineers and CSCs

Page 7: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

Create LinkedIn App

To create an App in Linked In, you must have the details listed in the below table beforehand. The first step

is the sing-up with LinkedIn (or sign-in if you have an account already). They the App can be created by

updating the app details in the screens shown below.

Application details required to create a LinkedIn App

S. No. Field Name Required Description

1 Company Name Yes Your Company Name

2 Name Yes Name of the Application. Example: IBM

Kenexa BrassRing on Cloud EU Staging

3 Description Yes Your App Description

4 Application Logo URL Yes Your Company/Product Logo URL

5 Website URL Yes Your Career page URL

6 Business E-mail Yes e-mail address of the App owner

7 Business Phone Yes Phone number of the App owner

8 OAuth 2.0 Authorized Redirect URLs: No Update the appropriate URL from the URL

table given at the end of this document

9 OAuth 1.0a Default "Accept" Redirect URL: No

10 OAuth 1.0a Default "Cancel" Redirect URL: No

App creation steps

1. My Apps in LinkedIn

o Go to https://developer.linkedin.com o Click

on “Create app” to create an APP

Page 8: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

2. Sign-up with LinkedIn

Sign in with your LinkedIn account or create a new account to sign-up. You can navigate to this page directly through

https://www.linkedin.com/secure/developer

3. Application Creation Click “Create App” to add the application for which an API key needs to be created.

Page 9: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

Fill in the form with App details:

Page 10: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

Update Redirect URLs: Create Application – Fill form - Update Redirect URLs

Click on the pencil icon and click on “Add redirect URL”

Now, click on update.

Page 11: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

Redirect URLs:

• Please note that all three URLs in the Redirect URLs column of the previous table need to be entered, as shown in the table. Ensure there are no spaces after the commas in the URLs.

• After successful creation of the application, below confirmation message is displayed along with the API and secret keys.

Redirect URL List

Domain Type Redirect URLs

US

Production

Akamai https://xjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx,

https://xjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx,

https://xjobs.brassring.com/TGWEbHost/SocialMediaIntegration.aspx

Non-SSL http://jobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx,

http://jobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx,

http://jobs.brassring.com/TGWEbHost/SocialMediaIntegration.aspx

SSL https://sjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx,

https://sjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx,

https://sjobs.brassring.com/TGWEbHost/SocialMediaIntegration.aspx

Vanity Client set vanity URL/TGWebHost/SocialMediaIntegration.aspx,

Client set vanity URL/tgwebhost/SocialMediaIntegration.aspx,

Client set vanity URL/TGWEbHost/SocialMediaIntegration.aspx

US Staging Akamai https://xjobs-staging.brassring.com/TGWebHost/SocialMediaIntegration.aspx,

https://xjobs-staging.brassring.com/tgwebhost/SocialMediaIntegration.aspx,

https://xjobs-staging.brassring.com/TGWEbHost/SocialMediaIntegration.aspx

Non-SSL http://stagingjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx,

http://stagingjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx,

http://stagingjobs.brassring.com/TGWEbHost/SocialMediaIntegration.aspx

SSL https://sstagingjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx,

https://sstagingjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx,

https://sstagingjobs.brassring.com/TGWEbHost/SocialMediaIntegration.aspx

Page 12: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

Vanity Client set vanity URL/TGWebHost/SocialMediaIntegration.aspx,

Client set vanity URL/tgwebhost/SocialMediaIntegration.aspx,

Client set vanity URL/TGWEbHost/SocialMediaIntegration.aspx

EU

Production

Akamai https://krb-xjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx,

https://krb-xjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx,

https://krb-xjobs.brassring.com/TGWEbHost/SocialMediaIntegration.aspx

Non-SSL http://krb-jobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx, http://krb-

jobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx, http://krb-

jobs.brassring.com/TGWEbHost/SocialMediaIntegration.aspx

SSL https://krb-sjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx,

https://krb-sjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx,

https://krb-sjobs.brassring.com/TGWEbHost/SocialMediaIntegration.aspx

Vanity Client set vanity URL/TGWebHost/SocialMediaIntegration.aspx,

Client set vanity URL/tgwebhost/SocialMediaIntegration.aspx,

Client set vanity URL/TGWEbHost/SocialMediaIntegration.aspx

EU Staging Akamai https://stagingkrb-xjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx,

https://stagingkrb-xjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx,

https://stagingkrb-xjobs.brassring.com/TGWEbHost/SocialMediaIntegration.aspx

Non-SSL http://stagingkrb-jobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx,

http://stagingkrb-jobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx,

http://stagingkrb-jobs.brassring.com/TGWEbHost/SocialMediaIntegration.aspx

SSL https://stagingkrb-sjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx,

https://stagingkrb-sjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx,

https://stagingkrb-sjobs.brassring.com/TGWEbHost/SocialMediaIntegration.aspx

Vanity Client set vanity URL/TGWebHost/SocialMediaIntegration.aspx,

Client set vanity URL/tgwebhost/SocialMediaIntegration.aspx,

Client set vanity URL/TGWEbHost/SocialMediaIntegration.aspx

Page 13: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

App creation Successful

4. My Applications The App that is created is now listed under My Apps tab. You may click on the app to view settings and edit.

On the LinkedIn Developer profile, the newly created application appears in the list of applications as

follows:

5. Edit and Usage reports

You can edit settings and view usage reports under Auth / Usage & limits section

Page 14: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer
Page 15: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

Activating (Whitelisting) LinkedIn APPs

To activate or whitelist LinkedIn Apps that are created, the client must submit a request to LinkedIn to seek

further access to this. This is a very IMPORTANT step and we recommend every client that created

LinkedIn App to get their keys whitelisted irrespective of the use case.

Send an e-mail to LinkedIn support

You need to send an e-mail to LinkedIn for getting this access.

E-mail to: [email protected]

Details to be provided to LinkedIn:

o Customer Account Name o

Customer Contact Full Name o

Customer Contact Email o

LinkedIn API key(s)

The API keys that are created here must be used to configure in BrassRing Workbench.

Workbench Configuration API Key and Secret Keys, thus generated must be saved in Workbench within the LinkedIn’s Administer

configuration page as follows:-

If you are using more than one workflow of LinkedIn integration, it is HIGHLY RECOMMENDED that

you create 3 separate APIs. The first API key will be used for BrassRing workflows (posting to

company or individual accounts from within BrassRing), the second API key will be used for Talent

Page 16: LinkedIn Integration - IBMmedia.kenexa.com/Training/TSBR/APIDocs/HowtocreateLinkedInAPI2018.pdfLinkedIn Integration Application (App) creation with LInkedIn ... On the LinkedIn Developer

Gateway workflows for logged in users and the third is used for Talent Gateway users who have not

logged in. You may choose to use one API key and Secret Key pair for all three combinations, but it

is a best practice to create three different pairs.