Configura un'istanza ServiceNow per CDC

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Puoi utilizzare Datastream per replicare i dati da un'istanza ServiceNow a una destinazione supportata, ad esempio BigQuery o Cloud Storage. Prima di creare un profilo di connessione, devi configurare un utente di integrazione dedicato, configurare l'autenticazione di base o OAuth 2.0 e inserire nella lista consentita gli indirizzi IP di Datastream, se necessario.

Prima di iniziare

Prima di iniziare a configurare ServiceNow per l'utilizzo con Datastream, assicurati di disporre di:

• Un'istanza ServiceNow attiva, ad esempio company.service-now.com.
• Privilegi amministrativi sull'istanza ServiceNow per creare utenti, assegnare ruoli e gestire il registro delle applicazioni OAuth.
• Conoscenza della versione dell'istanza ServiceNow.

Configura un utente di integrazione

In ServiceNow, puoi creare un nuovo utente o modificare le impostazioni di un account esistente per consentire l'accesso a Datastream. Per motivi di sicurezza e controllo, ti consigliamo vivamente di creare un utente di integrazione dedicato.

1. In ServiceNow, vai a User Administration (Amministrazione utenti) > Users (Utenti).
2. Per creare un nuovo utente, fai clic su Nuovo. Per modificare un utente esistente, cerca l'ID utente nell'elenco degli utenti e fai clic per aprire il record.

3. Configura i dettagli utente:

   • Inserisci un nome univoco nel campo ID utente, ad esempio datastream_integration. Imposti l'identificatore dell'utente solo per i nuovi utenti.
   • Se selezioni l'autenticazione OAuth per il connettore, ti consigliamo di inserire i valori nei campi Nome e Cognome per identificare meglio il record utente.

   • Configurazione dell'identità: in base alla versione della piattaforma ServiceNow:

     • Xanadu e versioni successive: seleziona Macchina nel menu a discesa Tipo di identità. In questo modo, viene attivata automaticamente l'opzione Web service access only (Solo accesso al servizio web).
     • Pre-Xanadu: seleziona la casella di controllo Web service access only (Solo accesso al servizio web).

4. Salva il record:

   • Per i nuovi utenti, fai clic su Invia.
   • Per gli utenti esistenti, fai clic su Aggiorna.

5. Se hai creato un nuovo utente, riapri il record. Individua l'utente nell'elenco e fai clic sul suo ID utente per accedere alle opzioni del record.

6. Imposta password:

   1. Fai clic su Imposta password nell'intestazione del modulo.
   2. Inserisci una password efficace e fai clic su Salva password.
   3. Se utilizzi l'autenticazione di base per il connettore, prendi nota della password perché è obbligatoria per la configurazione del profilo di connessione.

7. Assegna le autorizzazioni. Devi concedere all'utente di integrazione l'accesso in lettura a tutte le tabelle che vuoi replicare. Inoltre, il connettore richiede autorizzazioni in lettura esplicite per le tabelle dei metadati di sistema sys_db_object, sys_table_rotation e sys_dictionary.

A causa della natura granulare dei ruoli di ServiceNow e del sistema di elenchi di controllo dell'accesso (ACL), la configurazione specifica richiesta per concedere queste autorizzazioni è specifica per il cliente.

• Ti consigliamo vivamente di assegnare il ruolo snc_read_only al tuo utente, perché garantisce che la sessione utente sia rigorosamente limitata all'accesso di sola lettura nell'intera piattaforma.
• Il ruolo admin concede l'accesso completo a tutte le tabelle dell'istanza. Se le tue policy di sicurezza lo consentono, l'assegnazione del ruolo admin è il metodo più semplice per garantire l'accesso completo al connettore.

(Facoltativo) Configura le credenziali client OAuth 2.0

OAuth 2.0 è il metodo di autenticazione più sicuro e consigliato per l'utilizzo del connettore ServiceNow con Datastream. Utilizza un ID client e un client secret anziché una password permanente.

1. Attiva il plug-in OAuth 2.0 per la tua istanza. Per saperne di più, consulta la documentazione di ServiceNow.
2. Assicurati che la proprietà di sistema com.snc.platform.security.oauth.is.active sia impostata su true. Per saperne di più, consulta la documentazione di ServiceNow.
3. Assicurati che la proprietà di sistema glide.oauth.inbound.client.credential.grant_type.enabled sia impostata su true. Per saperne di più, consulta la documentazione di ServiceNow.

4. Configura la configurazione OAuth in entrata. A seconda dei requisiti di sicurezza dell'istanza, puoi selezionare uno dei seguenti ambiti di configurazione OAuth:

   • Ambito ampio: quando utilizzi OAuth con ambito ampio, il portatore del token eredita i ruoli utente e gli elenchi di controllo dell'accesso (ACL) associati.
   • Ambito di autenticazione dell'API REST granulare: questo tipo di configurazione OAuth limita l'accesso a metodi e API REST specifici consentiti dall'ambito, oltre ai ruoli utente e agli ACL associati.

5. Crea il record di integrazione OAuth. Per saperne di più, consulta la documentazione di ServiceNow:

   • Per la versione della piattaforma Zurich e successive
   • Per le versioni della piattaforma precedenti a Zurich

6. Dopo aver creato il record di integrazione OAuth, la configurazione dipende dalla versione della piattaforma e dall'ambito OAuth:

   • Configurazione ad ampio raggio:

     • Zurich e versioni successive: nella sezione Ambito di autenticazione del record di integrazione, assicurati che non siano presenti voci nei campi Ambito di autenticazione o Limita l'autorizzazione alle seguenti API e che la casella di controllo Consenti l'accesso solo alle API nell'ambito selezionato non sia selezionata.
     • Pre-Zurich: nel menu a discesa Limitazione dell'ambito, seleziona Ambito ampio e lascia vuoto l'elenco Ambiti di autenticazione.

   • Configurazione granulare con ambito di autenticazione dell'API REST: facoltativamente, utilizza gli ambiti di autenticazione per limitare ulteriormente il portatore del token a metodi e API REST specifici consentiti dall'ambito. Il connettore Datastream richiede solo l'accesso GET all'API Table. A seconda della versione della piattaforma, segui questi passaggi:

     • Zurich e versioni successive: nella sezione Ambito di autenticazione del record di integrazione, seleziona un ambito di autorizzazione e limita l'accesso all'API Table.

       Nota: se crei l'ambito di autorizzazione durante la modifica del record di integrazione, l'ambito ha accesso a tutti i metodi API dell'API Table per impostazione predefinita. Per limitare ulteriormente l'accesso solo al metodo GET, devi modificare manualmente il record appena creato andando a Servizi web di sistema > Ambiti di autenticazione API > Ambito di autenticazione API REST.

     • Pre-Zurich:

       1. Limita l'accesso all'API Table per l'ambito di autorizzazione selezionato. Per saperne di più, consulta la documentazione di ServiceNow.
       2. Aggiungi l'ambito nella sezione Ambiti di autenticazione.
       3. Seleziona Ambito sicuro nella casella Limitazione dell'ambito.

(Facoltativo) Configura controllo dell'accesso agli indirizzi IP

Se l'istanza ServiceNow utilizza il controllo degli accessi agli indirizzi IP, devi inserire esplicitamente nella lista consentita gli indirizzi IP di Datastream.

I passaggi seguenti sono necessari solo se hai una regola di controllo dell'accesso agli indirizzi IP DENY che copre gli indirizzi IP di Datastream. Per impostazione predefinita, non esistono limitazioni IP per l'accesso all'istanza.

1. In ServiceNow, vai a System Security (Sicurezza del sistema) > IP Address Access Control (Controllo degli accessi indirizzi IP).
2. Fai clic su New (Nuovo).
3. Nel modulo di creazione del record, applica le seguenti impostazioni:
   1. Nel menu a discesa Tipo, seleziona Consenti.
   2. Nel menu a discesa Direzione, seleziona In entrata.
   3. Nei campi Inizio intervallo e Fine intervallo, inserisci l'indirizzo IP o l'intervallo di indirizzi specifico dall'elenco di indirizzi IP di Datastream.
   4. Assicurati che la casella di controllo Attiva sia selezionata.
4. Fai clic su Invia.
5. Ripeti i passaggi precedenti per ogni indirizzo IP nell'elenco degli indirizzi Datastream.

Passaggi successivi

• Scopri di più sull'origine ServiceNow.