Configuring LinkedIn in Jitterbit App Builder
App Builder does not natively support LinkedIn, either as an authentication or data provider. However, since the LinkedIn API is fundamentally a REST API, secured using the OAuth Authorization Code flow, it's possible use App Builder's generic OAuth and HTTP security providers to retrieve data from LinkedIn.
The basic process is described in Configuring OAuth. The main tasks involved include:
- Register App Builder as a LinkedIn app.
- Create a LinkedIn OAuth security provider.
- Create a LinkedIn HTTP security provider
- Create a LinkedIn data source.
It's assumed that your organization already has an existing LinkedIn account.
The instructions below will refer to the following properties:
Example | Notes | |
---|---|---|
App Builder App URL | https://example.com/App Builder/ | The URL from which App Builder is hosted. Includes the trailing slash. |
Security Provider Name | Each App Builder security provider is given a logical name. This name is used in the Redirect URL. | |
Redirect URL | https://example.com/App Builder/signin-LinkedIn | App Builder automatically provisions a redirect URL for OAuth security providers. Note that the OAuth Security Provider Name appears in the Redirect URL. |
Register App Builder as a LinkedIn app
The process for creating LinkedIn apps is documented on the following page:
https://learn.microsoft.com/en-us/linkedin/shared/authentication/client-credentials-flow
Start by signing into the LinkedIn developer portal.
https://developer.linkedin.com/
- Select the My Apps menu link
- Click the Create Application button
-
Provide the requested information. For example:
- Company Name: Jitterbit
- Name: App Builder
- Description: No-code development platform.
- Application Logo
- Application Use: Corporate IT Internal Use
- Website URL: http://www.zudy.com/
- Business Phone
-
Click the Submit button.
- In the Authentication Keys section, note the Client IDand Client Secret
- In the OAuth 2.0 section, enter the the {Redirect URL} for the Authorized Redirect URLs and click the Add button
- Click the Update button
Create a linkedin OAuth security provider
To create an OAuth security provider, start by signing into App Builder as an administrator.
- Navigate to the IDE
- Click the Security Providers button
- In the User Authentication panel, click the + User Authentication button
-
Provide the following:
- Name: {OAuth Provider Name}
- Example: LinkedIn
- Type: OAuth
- Priority: A unique integer between 10 and 100. Note that this value must be unique.
- Example: 50
- Enabled: Check
- Name: {OAuth Provider Name}
-
Click the Save button
-
Set the following properties. In the Properties panel, click the + Property button → Select the Parameter → Provide the Value → Click the Save icon.
- AuthorizationEndpoint: https://www.linkedin.com/oauth/v2/authorization
- TokenEndpoint: https://www.linkedin.com/oauth/v2/accessToken
- ClientId: The {Client ID} provided by LinkedIn
- ClientSecret: The {Client Secret} provided by LinkedIn
Create a LinkedIn HTTP security provider
To create an HTTP security provider, start by signing into App Builder as an administrator.
- Navigate to the IDE
- Click the Security Providers button
- In the Data Source Authentication panel, click the + Data Source Authentication button
-
Provide the following:
- Name: LinkedIn (REST)
- Type: HTTP
- Priority: A unique integer between 10 and 100. Note that this value must be unique.
- Example: 60
- Enabled: Check
-
Click the Save button
-
Set the following properties. In the Properties panel, click the + Property button → Select the Parameter → Provide the Value → Click the Save icon.
- AuthenticationType: AuthorizationCode
- OAuthProvider: {OAuth Provider Name} Example: LinkedIn
Create a LinkedIn data source
To create a LinkedIn data source, start by signing into App Builder as an administrator.
- Navigate to the IDE
- Click the Data Servers button
- In the Data Servers panel, click the + Server button
-
Provide the following:
- Name: LinkedIn
- Type: REST API
- URL: https://api.linkedin.com/v1/
- Request Content Type: JSON
- Response Content Type: JSON
- Security Provider: LinkedIn (HTTP)
-
Click the Save button
- Click the Close icon (X) to dismiss the Server popup
- Click the Tables icon to configure the Endpoints information
- In the Endpoints panel, click the + Endpoint button
-
Provide the following:
- Name: People
- Endpoint: people/~
-
Click the Discover button.
- You will be prompted to sign in with LinkedIn.
-
Click the Sign in with LinkedIn button.
- After signing in with LinkedIn and approving the authorization, you will be redirected back to the Endpoints page.
-
In the Endpoints panel, locate the People endpoint and click the Discover button
-
In the Output Tables panel, locate the People table and click the Content icon.
- Assuming everything has been configured correctly, you should see your LinkedIn account information.