Ir para o conteúdo

Configurando LinkedIn no Jitterbit App Builder

O App Builder não suporta nativamente o LinkedIn, nem como provedor de autenticação nem como provedor de dados. Porém, como a API do LinkedIn é fundamentalmente uma API REST protegida pelo fluxo OAuth Authorization Code, é possível usar os provedores genéricos de OAuth e HTTP do App Builder para recuperar dados do LinkedIn.

O processo básico está descrito em Configurando OAuth. As principais tarefas envolvidas incluem:

  1. Registrar o App Builder como um app do LinkedIn.
  2. Criar um provedor de segurança OAuth do LinkedIn.
  3. Criar um provedor de segurança HTTP do LinkedIn
  4. Criar uma fonte de dados do LinkedIn.

Assume-se que sua organização já possui uma conta do LinkedIn existente.

As instruções abaixo farão referência às seguintes propriedades:

Exemplo Notas
URL do App Builder https://example.com/Vinyl/ A URL a partir da qual o App Builder está hospedado. Inclui a barra à direita.
Nome do Provedor de Segurança LinkedIn Cada provedor de segurança do App Builder recebe um nome lógico. Esse nome é usado na URL de Redirecionamento.
URL de Redirecionamento https://example.com/Vinyl/signin-LinkedIn O App Builder provisiona automaticamente uma URL de redirecionamento para provedores de segurança OAuth. Observe que o Nome do Provedor de Segurança OAuth aparece na URL de Redirecionamento.

Registrar o App Builder como um app do LinkedIn

O processo para criar apps do LinkedIn está documentado na seguinte página:

https://learn.microsoft.com/en-us/linkedin/shared/authentication/client-credentials-flow

Comece acessando o portal do desenvolvedor do LinkedIn.

https://developer.linkedin.com/

  1. Selecione o link do menu Meus Apps
  2. Clique no botão Criar Aplicação
  3. Forneça as informações solicitadas. Por exemplo:

    • Nome da Empresa: Jitterbit
    • Nome: App Builder
    • Descrição: Plataforma de desenvolvimento sem código.
    • Logo da Aplicação
    • Uso da Aplicação: Uso Interno de TI Corporativo
    • URL do Site: http://www.zudy.com/
    • Telefone Comercial
  4. Clique no botão Enviar.

  5. Na seção Chaves de Autenticação, anote a ID do Cliente e o Segredo do Cliente
  6. Na seção OAuth 2.0, insira a {URL de Redirecionamento} para as URLs de Redirecionamento Autorizadas e clique no botão Adicionar
  7. Clique no botão Atualizar

Criar um provedor de segurança OAuth do LinkedIn

Para criar um provedor de segurança OAuth, comece acessando o App Builder como administrador.

  1. Navegue até o IDE
  2. Clique no botão Provedores de Segurança
  3. Clique no botão + Provedor de Segurança
  4. Forneça o seguinte:

    • Nome: {Nome do Provedor OAuth}
      • Exemplo: LinkedIn
    • Tipo: OAuth
    • Prioridade: Um inteiro único entre 10 e 100. Observe que esse valor deve ser único.
      • Exemplo: 50
    • Ativado: Marque
  5. Clique no botão Salvar

  6. Defina as seguintes propriedades. No painel Propriedades, clique no botão + Propriedade → Selecione o Parâmetro → Forneça o Valor → Clique no ícone Salvar.

    • AuthorizationEndpoint: https://www.linkedin.com/oauth/v2/authorization
    • TokenEndpoint: https://www.linkedin.com/oauth/v2/accessToken
    • ClientId: A {ID do Cliente} fornecida pelo LinkedIn
    • ClientSecret: O {Segredo do Cliente} fornecido pelo LinkedIn

Criar um provedor de segurança HTTP do LinkedIn

Para criar um provedor de segurança HTTP, comece fazendo login no App Builder como administrador.

  1. Navegue até o IDE
  2. Clique no botão Security Providers
  3. Clique no botão + Security Provider
  4. Forneça o seguinte:

    • Name: LinkedIn (REST)
    • Type: HTTP
    • Priority: Um número inteiro único entre 10 e 100. Observe que esse valor deve ser único.
    • Exemplo: 60
    • Enabled: Marcado
  5. Clique no botão Save

  6. Defina as seguintes propriedades. No painel Properties, clique no botão + Property → Selecione o Parameter → Forneça o Value → Clique no ícone Save.

    • AuthenticationType: AuthorizationCode
    • OAuthProvider: {OAuth Provider Name} Exemplo: LinkedIn

Criar uma fonte de dados do LinkedIn

Para criar uma fonte de dados do LinkedIn, comece fazendo login no App Builder como administrador.

  1. Navegue até o IDE
  2. Clique no botão Data Servers
  3. No painel Data Servers, clique no botão + Server
  4. Forneça o seguinte:

    • Name: LinkedIn
    • Type: REST API
    • URL: https://api.linkedin.com/v1/
    • Request Content Type: JSON
    • Response Content Type: JSON
    • Security Provider: LinkedIn (HTTP)
  5. Clique no botão Save

  6. Clique no ícone Close (X) para fechar o popup Server
  7. Clique no ícone Tables para configurar as informações de Endpoints
  8. No painel Endpoints, clique no botão + Endpoint
  9. Forneça o seguinte:

    • Name: People
    • Endpoint: people/~
  10. Clique no botão Discover.

    • Você receberá uma solicitação para fazer login com o LinkedIn.
  11. Clique no botão Sign in with LinkedIn.

    • Após fazer login com o LinkedIn e aprovar a autorização, você será redirecionado de volta para a página Endpoints.
  12. No painel Endpoints, localize o endpoint People e clique no botão Discover

  13. No painel Output Tables, localize a tabela People e clique no ícone Content.

    • Supondo que tudo tenha sido configurado corretamente, você deverá ver as informações de sua conta do LinkedIn.