Requisitos de autenticación para el conector ZoomInfo (Beta) en Jitterbit Studio

Introducción

Estos son los requisitos para autenticarte con el conector ZoomInfo (Beta) utilizando OAuth 2.0 de 3 patas (3LO) (Flujo de Código de Autorización).

OAuth 2.0 de 3 patas (3LO)

Sigue estos pasos para configurar una aplicación de OAuth 2.0 de 3 patas (3LO) en el Portal de Desarrolladores de ZoomInfo:

1. Inicia sesión en el Portal de Desarrolladores de ZoomInfo.

2. Haz clic en Crear App.

3. Ingresa un nombre para la aplicación y sube un logo.

4. Agrega una de las siguientes URL (dependiendo de la región de tu organización) a la lista de URIs de Redirección de Inicio de Sesión:

   Región	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. Selecciona los alcances de OAuth 2.0 que la aplicación requiere. Los alcances relevantes son:

   Alcance	Descripción
   api:data:company	Buscar y enriquecer datos de empresas y jerarquía corporativa
   api:data:contact	Buscar y enriquecer datos de contactos y organigramas
   api:data:intent	Datos de señales de intención
   api:data:news	Artículos de noticias
   api:data:scoops	Datos de scoops

6. Haz clic en Crear para registrar la aplicación.

7. Después de la creación, haz clic en el enlace de la aplicación para recuperar el ID de Cliente y el Secreto de Cliente para su uso posterior.

Generar un Verificador de Código PKCE y un Desafío de Código

Genera un par de Verificador de Código PKCE (Proof Key for Code Exchange) y Desafío de Código. ZoomInfo requiere PKCE utilizando el método SHA-256 (S256) para la autenticación:

1. Genera un Verificador de Código. Es una cadena aleatoria criptográficamente, codificada en base64url, que tiene entre 43 y 128 caracteres (sin relleno, sin caracteres + o /). Por ejemplo, usando una terminal:

   WindowsmacOS y 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. Deriva el Desafío de Código del Verificador de Código calculando su hash SHA-256, luego codificando el resultado en base64url (sin relleno):

   WindowsmacOS y 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 '+/' '-_'
   

Retén ambos valores para la configuración de la aplicación.

Configurar un registro de aplicación en la Consola de Administración

Sigue estos pasos para configurar los valores requeridos para una aplicación privada de la Consola de Administración registro de aplicación:

1. Reúne los siguientes valores de la aplicación del Portal de Desarrolladores de ZoomInfo y el par PKCE creado anteriormente:

   • ID de Cliente
   • Secreto de Cliente
   • Verificador de Código PKCE
   • Desafío de Código PKCE

2. En la configuración del registro de la aplicación, ingresa los alcances de OAuth 2.0 de ZoomInfo requeridos para tu integración.

3. Establece el ID de cliente de la aplicación al ID de cliente de la aplicación del Portal de Desarrolladores de ZoomInfo.

4. Establece el Secreto de cliente de la aplicación al secreto de cliente de la aplicación del Portal de Desarrolladores de ZoomInfo.

5. Establece la URL de autenticación de la aplicación a https://api.zoominfo.com/gtm/oauth/v1/authorize.

6. Establece la URL del token de acceso y la URL del token de actualización de la aplicación a https://api.zoominfo.com/gtm/oauth/v1/token.

7. Ve a Opciones avanzadas. En la pestaña de solicitud de autenticación, crea estos pares clave-valor bajo Parámetros:

   Clave	Valor	Enviar en
   response_type	code	URL de solicitud
   code_challenge	Tu Desafío de código PKCE generado	URL de solicitud

8. En la pestaña de solicitud de token, crea estos pares clave-valor bajo Parámetros:

   Clave	Valor	Enviar en
   code_verifier	Tu Verificador de código PKCE generado	Cuerpo de solicitud

Una vez que la aplicación privada esté registrada en la página de Registros de aplicaciones, estará disponible para ser seleccionada en el menú de Aplicación OAuth en la conexión de ZoomInfo (Beta) al usar la opción de autenticación de Flujo de código de autorización.