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 genéricos de 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á tenha uma conta existente no LinkedIn.

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/pt-br/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 Aplicativos
  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 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: Marcar

  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 Provedores de Segurança
  3. No painel Autenticação da Fonte de Dados, clique no botão + Autenticação da Fonte de Dados

  4. Forneça o seguinte:

    • Nome: LinkedIn (REST)
    • Tipo: HTTP
    • Prioridade: Um número inteiro único entre 10 e 100. Observe que esse valor deve ser único.
    • Exemplo: 60
    • 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.

    • 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 Servidores de Dados
  3. No painel Servidores de Dados, clique no botão + Servidor

  4. Forneça o seguinte:

    • Nome: LinkedIn
    • Tipo: REST API
    • URL: https://api.linkedin.com/v1/
    • Tipo de Conteúdo da Solicitação: JSON
    • Tipo de Conteúdo da Resposta: JSON
    • Provedor de Segurança: LinkedIn (HTTP)

  5. Clique no botão Salvar

  6. Clique no ícone Fechar (X) para dispensar o popup do Servidor
  7. Clique no ícone Tabelas para configurar as informações dos Endpoints
  8. No painel Endpoints, clique no botão + Endpoint

  9. Forneça o seguinte:

    • Nome: Pessoas
    • Endpoint: people/~

  10. Clique no botão Descobrir.

    • Você será solicitado a fazer login com o LinkedIn.

  11. Clique no botão Entrar com o 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 Pessoas e clique no botão Descobrir

  13. No painel Tabelas de Saída, localize a tabela Pessoas e clique no ícone Conteúdo.

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