Raccogli i dati del CMDB di ServiceNow

Supportata in:

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

Aggiungi intervalli IP a ServiceNow

  1. Accedi alla tua istanza ServiceNow come amministratore.
  2. Vai a All (Tutti) > System Security (Sicurezza del sistema) > IP Address Access Control (Controllo degli accessi indirizzo IP).
  3. Fai clic su New (Nuovo).
  4. 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.
  5. Fai clic su Invia.
  6. 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.

  1. Accedi alla Console di amministrazione ServiceNow.
  2. Vai a All (Tutti) > User Administration (Amministrazione utenti) > Users (Utenti).
  3. Fai clic su New (Nuovo).
  4. 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).
  5. Fai clic su Invia.

Assegna le autorizzazioni richieste

  1. Dopo aver creato l'utente, apri il record utente.
  2. Vai alla sezione Ruoli.
  3. Fai clic su Modifica.
  4. Nell'elenco Raccolta, cerca e aggiungi il seguente ruolo:
    • cmdb_read: fornisce l'accesso in lettura alle tabelle CMDB.
  5. 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.
  • 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

  1. Accedi alla tua istanza ServiceNow come utente dell'integrazione.
  2. Vai a Tutti > Servizi web di sistema > REST > Explorer API REST.
  3. Seleziona API Table dal menu a discesa dello spazio dei nomi.
  4. Seleziona Recupera i record da una tabella (GET).
  5. In Parametri di percorso, inserisci il nome della tabella (ad esempio cmdb_ci).
  6. Fai clic su Invia.
  7. 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 ServiceNow
      • your-username: il nome utente dell'utente di integrazione
      • your-password: la password dell'utente di integrazione

Una risposta positiva restituirà i dati JSON con gli elementi di configurazione.

Configura i feed

Per configurare un feed:

  1. Vai a Impostazioni > Gestione dei dati > Feed. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Feed.
  2. Fai clic su Aggiungi nuovo feed.
  3. Nella pagina successiva, fai clic su Configura un singolo feed.
  4. Nel campo Nome feed, inserisci un nome per il feed (ad esempio ServiceNow CMDB - All CIs o ServiceNow CMDB - Servers).
  5. Seleziona API di terze parti come Tipo di origine.
  6. Seleziona ServiceNow CMDB come Tipo di log.
  7. Fai clic su Avanti.
  8. 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
    • 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
    • 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.
    • Spazio dei nomi dell'asset: lo spazio dei nomi dell'asset.
    • Etichette di importazione: l'etichetta da applicare agli eventi di questo feed.
  9. Fai clic su Avanti.

  10. 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:

  1. Crea il primo feed seguendo i passaggi descritti sopra (ad esempio, per cmdb_ci_server).
  2. Fai clic su Aggiungi nuovo feed di notizie per creare altri feed di notizie.
  3. 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.