Pré-requisitos de autenticação para o conector ZoomInfo (Beta) no Jitterbit Studio

Introdução

Estes são os pré-requisitos para autenticar com o conector ZoomInfo (Beta) usando OAuth 2.0 de 3 etapas (3LO) (Fluxo de Código de Autorização).

OAuth 2.0 de 3 etapas (3LO)

Siga estas etapas para configurar um aplicativo OAuth 2.0 de 3 etapas (3LO) no Portal do Desenvolvedor ZoomInfo:

1. Faça login no Portal do Desenvolvedor ZoomInfo.

2. Clique em Criar App.

3. Insira um nome para o aplicativo e faça o upload de um logo.

4. Adicione uma das seguintes URLs (dependendo da região da sua organização) à lista de URIs de Redirecionamento de Login:

   Região	URL
   APAC	https://apps.apac-southeast.jitterbit.com/design-studio/api/v1/oauth/authcode
   EMEA	https://apps.emea-west.jitterbit.com/design-studio/api/v1/oauth/authcode
   NA	https://apps.na-east.jitterbit.com/design-studio/api/v1/oauth/authcode

5. Selecione os escopos OAuth 2.0 que o aplicativo requer. Os escopos relevantes são:

   Escopo	Descrição
   api:data:company	Pesquisar e enriquecer dados de empresas e hierarquia corporativa
   api:data:contact	Pesquisar e enriquecer dados de contatos e organogramas
   api:data:intent	Dados de sinal de intenção
   api:data:news	Artigos de notícias
   api:data:scoops	Dados de scoops

6. Clique em Criar para registrar o aplicativo.

7. Após a criação, clique no link do aplicativo para recuperar o ID do Cliente e o Segredo do Cliente para uso posterior.

Gere um Verificador de Código PKCE e um Desafio de Código

Gere um par de Verificador de Código PKCE (Proof Key for Code Exchange) e Desafio de Código. O ZoomInfo requer PKCE usando o método SHA-256 (S256) para autenticação:

1. Gere um Verificador de Código. É uma string criptograficamente aleatória, codificada em base64url, entre 43 e 128 caracteres (sem preenchimento, sem caracteres + ou /). Por exemplo, usando um terminal:

   WindowsmacOS e Linux

   $bytes = New-Object byte[] 32; [Security.Cryptography.RNGCryptoServiceProvider]::Create().GetBytes($bytes); [Convert]::ToBase64String($bytes).TrimEnd('=').Replace('+','-').Replace('/','_')
   

   openssl rand -base64 32 | tr -d '=' | tr '+/' '-_'
   

2. Derive o Desafio de Código do Verificador de Código computando seu hash SHA-256 e, em seguida, codificando o resultado em base64url (sem preenchimento):

   WindowsmacOS e Linux

   $sha256 = [Security.Cryptography.SHA256]::Create(); $hash = $sha256.ComputeHash([Text.Encoding]::ASCII.GetBytes("<your_code_verifier>")); [Convert]::ToBase64String($hash).TrimEnd('=').Replace('+','-').Replace('/','_')
   

   echo -n "<your_code_verifier>" | openssl dgst -binary -sha256 | openssl base64 | tr -d '=' | tr '+/' '-_'
   

Mantenha ambos os valores para a configuração do aplicativo.

Configure um registro de aplicativo no Console de Gerenciamento

Siga estas etapas para configurar os valores necessários para um aplicativo privado no Console de Gerenciamento registro de aplicativo:

1. Reúna os seguintes valores do portal de desenvolvedores do ZoomInfo e do par PKCE criado acima:

   • ID do Cliente
   • Segredo do Cliente
   • Verificador de Código PKCE
   • Desafio de Código PKCE

2. Na configuração do registro do aplicativo, insira os escopos OAuth 2.0 do ZoomInfo necessários para sua integração.

3. Defina o Client ID do aplicativo como o client ID da aplicação do Portal de Desenvolvedores do ZoomInfo.

4. Defina o Client Secret do aplicativo como o client secret da aplicação do Portal de Desenvolvedores do ZoomInfo.

5. Defina a Authentication URL do aplicativo como https://api.zoominfo.com/gtm/oauth/v1/authorize.

6. Defina a Access token URL e a Refresh token URL do aplicativo como https://api.zoominfo.com/gtm/oauth/v1/token.

7. Vá para Advanced options. Na aba Authentication request, crie esses pares chave-valor em Parameters:

   Chave	Valor	Enviar em
   response_type	code	Request URL
   code_challenge	Seu PKCE Code Challenge gerado	Request URL

8. Na aba Token request, crie esses pares chave-valor em Parameters:

   Chave	Valor	Enviar em
   code_verifier	Seu PKCE Code Verifier gerado	Request Body

Uma vez que a aplicação privada esteja registrada na página de App Registrations, ela estará disponível para ser selecionada no menu OAuth application na conexão ZoomInfo (Beta) ao usar a opção de autenticação Authorization Code Flow.