Ir para o conteúdo

Configurando o LinkedIn

O Vinyl não oferece suporte nativo ao LinkedIn, seja como provedor de autenticação ou de dados. No entanto, como a API do LinkedIn é fundamentalmente uma API REST, protegida usando o fluxo do código de autorização OAuth, é possível usar os provedores genéricos de segurança OAuth e HTTP do Vinyl para recuperar dados do LinkedIn.

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

  1. Registre o Vinyl como um aplicativo do LinkedIn.
  2. Crie um provedor de segurança LinkedIn OAuth.
  3. Crie um provedor de segurança HTTP do LinkedIn
  4. Crie uma fonte de dados no LinkedIn.

Presume-se que sua organização já tenha uma conta no LinkedIn.

As instruções abaixo se referirão às seguintes propriedades:

Exemplo Notas
URL do aplicativo de Vinyl https://example.com/Vinyl/ A URL na qual o Vinyl está hospedado. Inclui a barra final.
Nome do provedor de segurança LinkedIn Cada provedor de segurança do Vinyl recebe um nome lógico. Este nome é usado no URL de redirecionamento.
URL de redirecionamento https://example.com/Vinyl/signin-LinkedIn O Vinyl provisiona automaticamente uma URL de redirecionamento para provedores de segurança OAuth. Observe que o nome do provedor de segurança OAuth aparece no URL de redirecionamento.

Registre o Vinyl Como um Aplicativo do LinkedIn

O processo de criação de aplicativos do LinkedIn está documentado na página a seguir:

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

Comece fazendo login no portal do desenvolvedor do LinkedIn.

https://developer.linkedin.com/

  1. Selecione o link do menu Meus aplicativos
  2. Clique no botão Criar Aplicativo

  3. Forneça as informações solicitadas. Por exemplo:

    • Nome da Empresa: Jitterbit
    • Nome: Vinyl
    • Descrição: Plataforma de desenvolvimento sem código.
    • Logotipo do aplicativo
    • Uso de aplicativos: 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, observe o ID do cliente e Segredo do cliente
  6. Na seção OAuth 2.0, insira o {Redirect URL} para Authorized Redirect URLs e clique no botão Adicionar
  7. Clique no botão Atualizar

Crie um Provedor de Segurança OAuth do LinkedIn

Para criar um provedor de segurança OAuth, comece entrando no Vinyl como administrador.

  1. Navegue até o IDE
  2. Clique no botão Provedores de segurança
  3. No painel 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 exclusivo entre 10 e 100. Observe que esse valor deve ser exclusivo.
      • Exemplo: 50
    • Ativado: Verifique

  5. Clique no botão Salvar

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

    • Ponto final de autorização: https://www.linkedin.com/oauth/v2/authorization
    • TokenEndpoint: https://www.linkedin.com/oauth/v2/accessToken
    • ClientId: o {Client ID} fornecido pelo LinkedIn
    • ClientSecret: O {Client Secret} fornecido pelo LinkedIn

Crie um Provedor de Segurança HTTP do LinkedIn

Para criar um provedor de segurança HTTP, comece entrando no Vinyl como administrador.

  1. Navegue até o IDE
  2. Clique no botão Provedores de segurança
  3. No painel Autenticação de fonte de dados, clique no botão + Autenticação de fonte de dados

  4. Forneça o seguinte:

    • Nome: LinkedIn (REST)
    • Tipo: HTTP
    • Prioridade: Um número inteiro exclusivo entre 10 e 100. Observe que esse valor deve ser exclusivo.
    • Exemplo: 60
    • Ativado: Verifique

  5. Clique no botão Salvar

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

    • Tipo de autenticação: Código de autorização
    • OAuthProvider: {Nome do provedor OAuth} Exemplo: LinkedIn

Crie uma Fonte de Dados do LinkedIn

Para criar uma fonte de dados do LinkedIn, comece entrando no Vinyl 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: API REST
    • URL: https://api.linkedin.com/v1/
    • Tipo de conteúdo da solicitação: JSON
    • Tipo de conteúdo de resposta: JSON
    • Provedor de segurança: LinkedIn (HTTP)

  5. Clique no botão Salvar

  6. Clique no ícone Fechar (X) para fechar o pop-up 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: pessoas/~

  10. Clique no botão Descobrir.

    • Você será solicitado a fazer login no LinkedIn.

  11. Clique no botão Entrar no LinkedIn.

    • Após fazer login no 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 Tabelas de Saída, localize a tabela Pessoas e clique no ícone Conteúdo.

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