Ir para o conteúdo

Configurando o LinkedIn no Jitterbit App Builder

O App Builder não suporta nativamente o LinkedIn, nem como um provedor de autenticação ou de dados. No entanto, como a API do LinkedIn é fundamentalmente uma API REST, protegida pelo fluxo de Código de Autorização OAuth, é possível usar os provedores de segurança genéricos OAuth e HTTP do App Builder para recuperar dados do LinkedIn.

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

  1. Registrar o App Builder como um aplicativo 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.

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

As instruções abaixo se referem às seguintes propriedades:

Exemplo Notas
URL do App Builder https://example.com/Vinyl/ A URL a partir da qual o App Builder é hospedado. Inclui a barra final.
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 aplicativo do LinkedIn

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

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

Comece fazendo login no portal de desenvolvedores 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.
    • Logotipo da Aplicação
    • Uso da Aplicação: Uso Interno de TI Corporativa
    • URL do Site: http://www.zudy.com/
    • Telefone Comercial

  4. Clique no botão Enviar.

  5. Na seção Chaves de Autenticação, anote o 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 fazendo login no App Builder como administrador.

  1. Navegue até o IDE
  2. Clique no botão Provedores de Segurança
  3. No painel de Autenticação de Usuário, clique no botão + Autenticação de Usuário

  4. Forneça o seguinte:

    • Nome: {Nome do Provedor OAuth}
      • Exemplo: LinkedIn
    • Tipo: OAuth
    • Prioridade: Um número inteiro único entre 10 e 100. Observe que esse valor deve ser único.
      • Exemplo: 50
    • Habilitado: 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: O {ID do Cliente} fornecido 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. No painel Data Source Authentication, clique no botão + Data Source Authentication

  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: Marcar

  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: {Nome do Provedor OAuth} 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 do Servidor
  7. Clique no ícone Tables para configurar as informações dos 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ê será solicitado a 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 de 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.

  14. Supondo que tudo tenha sido configurado corretamente, você deve ver as informações da sua conta do LinkedIn.