Upload
others
View
29
Download
0
Embed Size (px)
Citation preview
IBM® Kenexa® BrassRing® on Cloud
LinkedIn Integration
Application (App) creation with LInkedIn Last Updated: May, 2016
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
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
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.
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
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
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
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.
Fill in the form with App details:
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.
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
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
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
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
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.