Ir para o conteúdo

Configuring LinkedIn

Vinyl 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 Vinyl'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:

  1. Register Vinyl as a LinkedIn app.
  2. Create a LinkedIn OAuth security provider.
  3. Create a LinkedIn HTTP security provider
  4. 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
Vinyl App URL https://example.com/Vinyl/ The URL from which Vinyl is hosted. Includes the trailing slash.
Security Provider Name LinkedIn Each Vinyl security provider is given a logical name. This name is used in the Redirect URL.
Redirect URL https://example.com/Vinyl/signin-LinkedIn Vinyl automatically provisions a redirect URL for OAuth security providers. Note that the OAuth Security Provider Name appears in the Redirect URL.

Register Vinyl 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/

  1. Select the My Apps menu link
  2. Click the Create Application button

  3. Provide the requested information. For example:

    • Company Name: Jitterbit
    • Name: Vinyl
    • Description: No-code development platform.
    • Application Logo
    • Application Use: Corporate IT Internal Use
    • Website URL: http://www.zudy.com/
    • Business Phone

  4. Click the Submit button.

  5. In the Authentication Keys section, note the Client IDand Client Secret
  6. In the OAuth 2.0 section, enter the the {Redirect URL} for the Authorized Redirect URLs and click the Add button
  7. Click the Update button

Create a LinkedIn OAuth Security Provider

To create an OAuth security provider, start by signing into Vinyl as an administrator.

  1. Navigate to the IDE
  2. Click the Security Providers button
  3. In the User Authentication panel, click the + User Authentication button

  4. 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

  5. Click the Save button

  6. 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 Vinyl as an administrator.

  1. Navigate to the IDE
  2. Click the Security Providers button
  3. In the Data Source Authentication panel, click the + Data Source Authentication button

  4. 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

  5. Click the Save button

  6. 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 Vinyl as an administrator.

  1. Navigate to the IDE
  2. Click the Data Servers button
  3. In the Data Servers panel, click the + Server button

  4. 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)

  5. Click the Save button

  6. Click the Close icon (X) to dismiss the Server popup
  7. Click the Tables icon to configure the Endpoints information
  8. In the Endpoints panel, click the + Endpoint button

  9. Provide the following:

    • Name: People
    • Endpoint: people/~

  10. Click the Discover button.

    • You will be prompted to sign in with LinkedIn.

  11. 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.

  12. In the Endpoints panel, locate the People endpoint and click the Discover button

  13. 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.