Raccogli i dati del CMDB di ServiceNow
Questo documento spiega come raccogliere i dati del CMDB di ServiceNow configurando un feed di Google Security Operations utilizzando l'API di terze parti.
Prima di iniziare
Assicurati di soddisfare i seguenti prerequisiti:
- Un'istanza Google SecOps
- Accesso privilegiato all'istanza ServiceNow con accesso alla Console di amministrazione
- Account utente ServiceNow con ruolo
cmdb_read(requisito minimo per l'accesso in lettura) - API REST abilitata nell'istanza ServiceNow (abilitata per impostazione predefinita)
Configura la lista consentita IP
Prima di creare il feed, devi inserire nella lista consentita gli intervalli IP di Google SecOps nelle impostazioni del firewall o della rete di ServiceNow.
Ottieni gli intervalli IP di Google SecOps
- Recupera gli intervalli IP dal file JSON degli intervalli di indirizzi IP di Google.
Aggiungi intervalli IP a ServiceNow
- Accedi alla tua istanza ServiceNow come amministratore.
- Vai a All (Tutti) > System Security (Sicurezza del sistema) > IP Address Access Control (Controllo degli accessi indirizzo IP).
- Fai clic su New (Nuovo).
- Fornisci i seguenti dettagli di configurazione:
- Tipo: seleziona Consenti.
- Indirizzo IP: inserisci un intervallo IP di Google SecOps nella notazione CIDR (ad esempio,
192.0.2.0/24). - Nome: inserisci un nome descrittivo (ad esempio
GGoogle SecOps IP Range 1). - Attiva: seleziona la casella di controllo per attivare la regola.
- Fai clic su Invia.
- Ripeti i passaggi da 3 a 5 per ogni intervallo IP di Google SecOps aggiuntivo.
Configura l'accesso all'API ServiceNow
Per consentire a Google SecOps di estrarre i dati CMDB, devi creare un utente ServiceNow con le autorizzazioni appropriate.
Crea un utente di integrazione dedicato (consigliato)
- Accedi alla Console di amministrazione ServiceNow.
- Vai a All (Tutti) > User Administration (Amministrazione utenti) > Users (Utenti).
- Fai clic su New (Nuovo).
- Fornisci i seguenti dettagli di configurazione:
- ID utente: inserisci un nome utente descrittivo (ad esempio
google_secops_integration). - Nome: inserisci
Google. - Cognome: inserisci
SecOps Integration. - Email: inserisci un indirizzo email valido per le notifiche.
- Password: fai clic su Imposta password e crea una password efficace.
- Attiva: seleziona la casella di controllo.
- Web service access only (Solo accesso al servizio web): seleziona la casella di controllo (opzione consigliata per l'accesso solo API).
- ID utente: inserisci un nome utente descrittivo (ad esempio
- Fai clic su Invia.
Assegna le autorizzazioni richieste
- Dopo aver creato l'utente, apri il record utente.
- Vai alla sezione Ruoli.
- Fai clic su Modifica.
- Nell'elenco Raccolta, cerca e aggiungi il seguente ruolo:
- cmdb_read: fornisce l'accesso in lettura alle tabelle CMDB.
- Fai clic su Salva.
Registra le credenziali API
Dopo aver creato l'utente, registra le seguenti credenziali:
- Nome utente: l'ID utente che hai creato (ad esempio,
google_secops_integration) - Password: la password che hai impostato per l'utente
- Nome host API: il nome di dominio completo (FQDN) dell'istanza ServiceNow (ad esempio,
myinstance.servicenow.com)- Non includere
https://o percorsi. - Non includere lo slash finale.
- Non includere
- Nome tabella: la tabella CMDB su cui eseguire la query (ad esempio
cmdb_ci,cmdb_ci_server,cmdb_ci_computer)
Informazioni sulle tabelle CMDB di ServiceNow
Il CMDB di ServiceNow è organizzato in una struttura gerarchica di tabelle. Le tabelle più comuni per l'importazione dati degli asset includono:
| Nome tabella | Descrizione | Caso d'uso |
|---|---|---|
cmdb_ci |
Tabella Base Configuration Item (principale di tutte le tabelle CI) | Tutti gli elementi di configurazione |
cmdb_ci_server |
Elementi di configurazione del server | Server fisici e virtuali |
cmdb_ci_computer |
Elementi di configurazione del computer | Workstation, laptop, desktop |
cmdb_ci_linux_server |
Elementi di configurazione del server Linux | Server Linux in particolare |
cmdb_ci_win_server |
Elementi di configurazione di Windows Server | Server Windows in particolare |
cmdb_ci_vm_instance |
Istanze di macchine virtuali | Macchine virtuali |
cmdb_ci_network_adapter |
Adattatori di rete | Schede di interfaccia di rete |
cmdb_ci_ip_address |
Indirizzi IP | Record di indirizzi IP |
cmdb_ci_service |
Servizi alle imprese | Elementi del catalogo dei servizi |
cmdb_ci_appl |
Applicazioni | Elementi di configurazione dell'applicazione |
Verifica l'accesso all'API REST
Prima di creare il feed, verifica che le credenziali dell'API ServiceNow funzionino correttamente.
(Facoltativo) Esegui il test utilizzando Explorer API REST
- Accedi alla tua istanza ServiceNow come utente dell'integrazione.
- Vai a Tutti > Servizi web di sistema > REST > Explorer API REST.
- Seleziona API Table dal menu a discesa dello spazio dei nomi.
- Seleziona Recupera i record da una tabella (GET).
- In Parametri di percorso, inserisci il nome della tabella (ad esempio
cmdb_ci). - Fai clic su Invia.
- Verifica che lo stato della risposta sia 200 OK e che vengano restituiti i record.
(Facoltativo) Esegui un test utilizzando curl
In alternativa, testa l'API utilizzando curl:
curl "https://your-instance.service-now.com/api/now/table/cmdb_ci?sysparm_limit=10" \ --request GET \ --header "Accept: application/json" \ --user 'your-username':'your-password'- Sostituisci:
your-instance.service-now.com: il nome host dell'istanza ServiceNowyour-username: il nome utente dell'utente di integrazioneyour-password: la password dell'utente di integrazione
- Sostituisci:
Una risposta positiva restituirà i dati JSON con gli elementi di configurazione.
Configura i feed
Per configurare un feed:
- Vai a Impostazioni > Gestione dei dati > Feed. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Feed.
- Fai clic su Aggiungi nuovo feed.
- Nella pagina successiva, fai clic su Configura un singolo feed.
- Nel campo Nome feed, inserisci un nome per il feed (ad esempio
ServiceNow CMDB - All CIsoServiceNow CMDB - Servers). - Seleziona API di terze parti come Tipo di origine.
- Seleziona ServiceNow CMDB come Tipo di log.
- Fai clic su Avanti.
Specifica i valori per i seguenti parametri di input:
- Nome utente: inserisci l'ID utente ServiceNow (ad esempio,
google_secops_integration). - Secret: inserisci la password utente di ServiceNow. Importante: questo è un campo sensibile. La password è criptata e non può essere visualizzata dopo il salvataggio.
- Nome host API: inserisci il nome di dominio completo della tua istanza ServiceNow.
- Esempio:
myinstance.servicenow.com - Non includere:
- Protocollo (
https://) - Percorsi (
/api/now/table/) - Barra finale
- Protocollo (
- Esempio:
- Istanze regionali: se l'istanza ServiceNow si trova in una regione specifica, utilizza il formato del nome host corretto:
- Standard:
instance.service-now.com - Unione Europea:
instance.service-now.eu - Altre regioni: verifica con l'amministratore di ServiceNow
- Standard:
- Nome tabella: inserisci la tabella CMDB di ServiceNow su cui eseguire la query.
- Esempi:
cmdb_ci(tutti gli elementi di configurazione)cmdb_ci_server(tutti i server)cmdb_ci_computer(workstation e computer)cmdb_ci_linux_server(solo server Linux)cmdb_ci_win_server(solo server Windows) Nota: il nome della tabella è sensibile alle maiuscole e deve corrispondere esattamente. Puoi eseguire query su una sola tabella per feed. Per importare più tabelle, crea feed separati per ogni tabella.
- Esempi:
- Spazio dei nomi dell'asset: lo spazio dei nomi dell'asset.
- Etichette di importazione: l'etichetta da applicare agli eventi di questo feed.
- Nome utente: inserisci l'ID utente ServiceNow (ad esempio,
Fai clic su Avanti.
Controlla la nuova configurazione del feed di notizie nella schermata Finalizza, quindi fai clic su Invia.
Dopo la configurazione, il feed inizia a recuperare i record CMDB dall'istanza ServiceNow. La sincronizzazione iniziale potrebbe richiedere diversi minuti, a seconda del numero di record nella tabella.
Importazione di più tabelle CMDB
Per importare i dati da più tabelle CMDB, crea feed separati per ogni tabella:
- Crea il primo feed seguendo i passaggi descritti sopra (ad esempio, per
cmdb_ci_server). - Fai clic su Aggiungi nuovo feed di notizie per creare altri feed di notizie.
- Utilizza le stesse credenziali ServiceNow, ma specifica nomi di tabelle diversi.
Configurazione di esempio:
| Nome feed | Nome tabella | Finalità |
|---|---|---|
| ServiceNow CMDB - Server | cmdb_ci_server |
Tutti i CI del server |
| CMDB ServiceNow - Computer | cmdb_ci_computer |
CI della workstation |
| ServiceNow CMDB - Adattatori di rete | cmdb_ci_network_adapter |
CI dell'interfaccia di rete |
| CMDB ServiceNow - Applicazioni | cmdb_ci_appl |
CI dell'applicazione |
Autorizzazioni API richieste
L'utente dell'integrazione deve disporre delle seguenti autorizzazioni ServiceNow:
| Autorizzazione/Ruolo | Livello di accesso | Finalità |
|---|---|---|
| cmdb_read | Leggi | Recupera i dati degli elementi di configurazione del CMDB |
Ruoli aggiuntivi (facoltativo):
- itil: obbligatorio se hai bisogno dell'accesso in scrittura per creare o aggiornare gli elementi di configurazione (non obbligatorio per l'importazione di Google SecOps)
- rest_api_explorer: utile per testare l'accesso all'API durante la configurazione
Tabella di mappatura UDM
| Campo ServiceNow | Mappatura UDM | Logica |
|---|---|---|
name |
entity.asset.hostname |
Nome host principale dell'asset |
ip_address |
entity.asset.ip |
Indirizzo IP principale dell'asset |
mac_address |
entity.asset.mac |
Indirizzo MAC dell'asset |
serial_number |
entity.asset.hardware.serial_number |
Numero di serie dell'hardware |
asset_tag |
entity.asset.asset_id |
Etichetta o identificatore asset |
sys_class_name |
entity.asset.asset_type |
Classe CI (server, computer e così via) |
os |
entity.asset.platform_software.platform |
Sistema operativo |
sys_created_on |
entity.asset.first_seen_time |
Timestamp di creazione dell'asset |
sys_updated_on |
entity.asset.last_seen_time |
Timestamp ultimo aggiornamento |
location |
entity.asset.location.name |
Posizione fisica |
company |
entity.asset.attribute.labels.value |
Azienda/organizzazione proprietaria |
event.idm.entity.entity.metadata.entity_type |
USER |
Mappato dal log delle modifiche |
calendar_integration", "u_ldap_source", "u_show_popup", "source", "building", "web_service_access_only", "notification", "enable_multifactor_authn", "sso_source", "sys_domain.display_value", "sys_domain.link", "u_itil_license_type", and "u_assets_validated |
entity.entity.asset.attribute.labels |
Mappato dal log delle modifiche |
last_login_time |
entity.relation.entity.user.last_login_time |
Mappato dal log delle modifiche |
x_bmgr_support_ent_bomgar_username", "vip", "zip", "time_format", "active", "gender", "failed_attempts", "federated_id", "internal_integration_user", "u_business_line", "department.link", "introduction", "preferred_language", "manager.link", "photo", "avatar", "time_zone", "schedule", and "correlation_id |
entity.relation.entity.user.attribute.labels |
Mappato dal log delle modifiche |
street |
entity.relation.entity.user.personal_address.name |
Mappato dal log delle modifiche |
department.display_value |
entity.relation.entity.user.department |
Mappato dal log delle modifiche |
u_office |
entity.relation.entity.user.company_name |
Mappato dal log delle modifiche |
title |
entity.relation.entity.user.title |
Mappato dal log delle modifiche |
first_name |
entity.relation.entity.user.first_name |
Mappato dal log delle modifiche |
last_name |
entity.relation.entity.user.last_name |
Mappato dal log delle modifiche |
middle_name |
entity.relation.entity.user.middle_name |
Mappato dal log delle modifiche |
manager.display_value |
entity.relation.entity.user.managers.user_display_name |
Mappato dal log delle modifiche |
sys_domain_path", "transaction_log", "cost_center", "sys_mod_count", and "sys_tags |
entity.entity.labels |
Mappato dal log delle modifiche |
employee_number", "phone", "home_phone", and "mobile_phone |
entity.relation.entity.user.phone_numbers |
Mappato dal log delle modifiche |
city |
entity.relation.entity.user.personal_address.city |
Mappato dal log delle modifiche |
state |
entity.relation.entity.user.personal_address.state |
Mappato dal log delle modifiche |
country |
entity.location.country_or_region |
Mappato dal log delle modifiche |
u_site_code |
entity.location.city |
Mappato dal log delle modifiche |
u_region |
entity_labels |
Mappato dal log delle modifiche |
location.display_value |
entity.labels |
Mappato dal log delle modifiche |
location.link |
entity.labels |
Mappato dal log delle modifiche |
email |
_relation.entity.user.email_addresses |
Mappato dal log delle modifiche |
sys_id |
entity.asset.product_object_id |
Mappato dal log delle modifiche |
u_sima_bs_activation_date", "attestation_status", "u_oracle_asm_lun_size", "u_app_resource_jndi_name", "is_encrypted", "monitor", "operational_status", "u_updated_ci", "u_cluster_node", "firewall_status", "skip_sync", "u_excluded", "u_data_classification", "u_sla_report", "u_restriction", "u_rack_slot", "u_account_aztech_oe.link", "u_account_aztech_oedisplay_value", "u_organisational_entity.link", "u_organisational_entity.display_value", "assignment_group.link", "assignment_group.display_value", "cost_center.link", "cost_center.display_value", "u_service_instance", "u_local_oe_cost_center", "managed_by", "u_mode_of_operation", "install_status", and "u_provider_tag |
entity.labels |
Mappato dal log delle modifiche |
u_build_user |
entity.user.email_addresses |
Mappato dal log delle modifiche |
metadata.entity_type |
ASSET |
Mappato dal log delle modifiche |
Log delle modifiche
Visualizza il log delle modifiche per questo parser
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.