Authentifizierungsanforderungen für den ZoomInfo (Beta) Connector in Jitterbit Studio

Einführung

Dies sind die Voraussetzungen für die Authentifizierung mit dem ZoomInfo (Beta) Connector unter Verwendung von 3-legged OAuth 2.0 (3LO) (Authorization Code Flow).

3-legged OAuth 2.0 (3LO)

Befolgen Sie diese Schritte, um eine 3-legged OAuth 2.0 (3LO) Anwendung im ZoomInfo Developer Portal zu konfigurieren:

1. Melden Sie sich im ZoomInfo Developer Portal an.

2. Klicken Sie auf App erstellen.

3. Geben Sie einen App-Namen ein und laden Sie ein Logo hoch.

4. Fügen Sie eine der folgenden URLs (je nach Region Ihrer Organisation) zur Liste der Sign-in Redirect URIs hinzu:

   Region	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. Wählen Sie die OAuth 2.0-Bereiche aus, die die Anwendung benötigt. Die relevanten Bereiche sind:

   Bereich	Beschreibung
   api:data:company	Unternehmensdaten und Unternehmenshierarchie suchen und anreichern
   api:data:contact	Kontaktdaten und Organigramme suchen und anreichern
   api:data:intent	Intent-Signal-Daten
   api:data:news	Nachrichtenartikel
   api:data:scoops	Scoop-Daten

6. Klicken Sie auf Erstellen, um die Anwendung zu registrieren.

7. Nach der Erstellung klicken Sie auf den Anwendungslink, um die Client-ID und das Client-Geheimnis für die spätere Verwendung abzurufen.

Generieren Sie einen PKCE-Codeverifier und eine Code-Herausforderung

Generieren Sie ein PKCE (Proof Key for Code Exchange) Codeverifier- und Code-Herausforderungspaar. ZoomInfo erfordert PKCE unter Verwendung der SHA-256 (S256) Methode zur Authentifizierung:

1. Generieren Sie einen Codeverifier. Es handelt sich um eine kryptografisch zufällige, base64url-kodierte Zeichenfolge mit einer Länge von 43 bis 128 Zeichen (kein Padding, keine + oder / Zeichen). Zum Beispiel, indem Sie ein Terminal verwenden:

   WindowsmacOS und 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. Leiten Sie die Code-Herausforderung aus dem Codeverifier ab, indem Sie dessen SHA-256-Hash berechnen und das Ergebnis dann base64url-kodieren (kein Padding):

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

Behalten Sie beide Werte für die Anwendungs-Konfiguration.

Konfigurieren Sie eine Anwendungsregistrierung in der Management-Konsole

Befolgen Sie diese Schritte, um die erforderlichen Werte für eine private Anwendung in der Management-Konsole Anwendungsregistrierung zu konfigurieren:

1. Sammeln Sie die folgenden Werte aus der ZoomInfo Developer Portal-Anwendung und dem oben erstellten PKCE-Paar:

   • Client-ID
   • Client-Geheimnis
   • PKCE-Codeverifier
   • PKCE-Code-Herausforderung

2. Geben Sie in der Konfiguration der App-Registrierung die für Ihre Integration erforderlichen ZoomInfo OAuth 2.0 Scopes ein.

3. Setzen Sie die Client-ID der App auf die Client-ID aus der ZoomInfo Developer Portal-Anwendung.

4. Setzen Sie das Client-Geheimnis der App auf das Client-Geheimnis aus der ZoomInfo Developer Portal-Anwendung.

5. Setzen Sie die Authentifizierungs-URL der App auf https://api.zoominfo.com/gtm/oauth/v1/authorize.

6. Setzen Sie die Access-Token-URL und die Refresh-Token-URL der App auf https://api.zoominfo.com/gtm/oauth/v1/token.

7. Gehen Sie zu Erweiterte Optionen. Erstellen Sie im Tab für Authentifizierungsanfragen diese Schlüssel-Wert-Paare unter Parameter:

   Schlüssel	Wert	Senden in
   response_type	code	Anforderungs-URL
   code_challenge	Ihre generierte PKCE Code Challenge	Anforderungs-URL

8. Erstellen Sie im Tab für Token-Anfragen diese Schlüssel-Wert-Paare unter Parameter:

   Schlüssel	Wert	Senden in
   code_verifier	Ihren generierten PKCE Code Verifier	Anforderungstext

Sobald die private Anwendung auf der Seite App-Registrierungen registriert ist, kann sie im Menü OAuth-Anwendung in der ZoomInfo (Beta) Verbindung ausgewählt werden, wenn die Authentifizierungsoption Authorization Code Flow verwendet wird.