Integra ServiceNow con Google SecOps

Questo documento spiega come integrare ServiceNow con Google Security Operations (Google SecOps).

Casi d'uso

L'integrazione di ServiceNow utilizza le funzionalità di Google SecOps per supportare i seguenti casi d'uso:

• Creazione automatica di ticket per gli incidenti: crea automaticamente incidenti ServiceNow dagli avvisi di sicurezza provenienti dal tuo SIEM o da altri strumenti di sicurezza.

• Arricchimento e risposta agli incidenti: semplifica i flussi di lavoro di risposta agli incidenti riducendo il ticketing manuale e arricchendo gli incidenti con informazioni pertinenti provenienti dall'avviso di origine.

• Risoluzione del phishing: automatizza i passaggi ripetitivi delle indagini sul phishing, come la raccolta delle intestazioni delle email, l'analisi degli allegati e la ricerca di email simili, accelerando i tempi di risposta.

• Orchestrazione della correzione delle vulnerabilità: orchestra i workflow di correzione delle vulnerabilità creando automaticamente richieste di modifica di ServiceNow per azioni di applicazione di patch o mitigazione in base ai risultati dell'analisi delle vulnerabilità.

• Automazione del ciclo di vita degli utenti: automatizza le attività di provisioning e deprovisioning degli utenti in vari sistemi (controllo dell'accesso, piattaforme email, applicazioni) in base ai trigger dei workflow di ServiceNow.

• Contesto di threat intelligence: arricchisci gli avvisi di sicurezza con dati di threat intelligence provenienti direttamente dalla piattaforma ServiceNow, fornendo agli analisti un contesto più ampio per dare priorità alle azioni di risposta.

Prima di iniziare

Prima di configurare l'integrazione nella piattaforma Google SecOps, assicurati di aver completato i seguenti prerequisiti:

• Account utente ServiceNow: un account utente dedicato con autorizzazioni sufficienti per eseguire query, creare e aggiornare i record di destinazione.
• Ruoli ServiceNow: assicurati che l'account disponga dei ruoli di sistema richiesti (sn_incident_write e itil) e di una configurazione di accesso utente personalizzata per consentire l'accesso in lettura ai commenti del journal.
• Connettività di rete: una configurazione di rete che consente al traffico proveniente dagli indirizzi IP di Google SecOps o dall'infrastruttura dell'agente remoto di raggiungere l'endpoint dell'istanza ServiceNow.
• Dettagli di autenticazione: determina la policy di autenticazione della tua organizzazione. Puoi eseguire l'autenticazione utilizzando l'autenticazione di base standard o l'autenticazione OAuth 2.0.

Configura l'accesso utente in ServiceNow

Per consentire all'integrazione di sincronizzare i commenti, aggiornare i campi ed eseguire le azioni senza problemi, devi eseguire le seguenti attività amministrative nella piattaforma ServiceNow.

Per istruzioni specifiche su come navigare nell'interfaccia di ServiceNow, consulta la documentazione ufficiale del prodotto ServiceNow.

1. Crea un ruolo personalizzato: vai a Ruoli > Nuovo e crea un nuovo ruolo dedicato alla gestione dell'accesso ai commenti dell'API.
2. Crea una nuova regola per l'elenco di controllo dell'accesso (ACL): l'integrazione richiede l'accesso in lettura alla tabella sys_journal_field per monitorare i commenti e le note di lavoro. Vai a Controlli degli accessi > Nuovo. Per creare questa regola, devi accedere con un account con autorizzazioni elevate.

3. Configura i parametri ACL:

   • Imposta Tipo su record.
   • Imposta Operazione su read.
   • Nei campi Nome, seleziona Scrittura contabile sys_journal_field dal primo menu a discesa e -- Nessuno -- dal secondo menu a discesa.
   Importante: il secondo menu a discesa deve essere impostato esplicitamente su -- None --. Se selezioni * (carattere jolly), l'API non riuscirà a recuperare i commenti.
   • Vai all'elenco Richiede il ruolo in fondo al modulo e aggiungi il ruolo di commento personalizzato appena creato. Fai clic su Invia.

4. Assegna i ruoli all'account di integrazione: vai a Utenti, apri il tuo account di integrazione dedicato e concedi i seguenti ruoli:

   • Il ruolo personalizzato che hai creato per leggere i commenti.
   • sn_incident_write: obbligatorio per l'interazione di base, ad esempio le azioni Recupera incidente e Aggiorna incidente.
   • itil: obbligatorio per le azioni CMDB e le funzioni di ricerca correlate alla gestione della configurazione degli asset.
   Nota: questi ruoli forniscono le autorizzazioni di base necessarie per interagire con incidenti standard ed entità di configurazione. L'accesso ad altre tabelle ServiceNow potrebbe richiedere una configurazione aggiuntiva dei ruoli in base ai vincoli ACL univoci del tuo ambiente.

Opzioni di configurazione dell'autenticazione

L'integrazione di ServiceNow supporta tre diversi metodi di autenticazione. Scegli una delle seguenti opzioni di configurazione in linea con i requisiti di sicurezza della tua organizzazione.

Opzione 1: flusso delle credenziali client OAuth 2.0 (consigliato)

Questo metodo utilizza un'autorizzazione delle credenziali client OAuth 2.0 insieme all'impersonificazione dell'utente per limitare in modo sicuro l'accesso ai dati senza esporre una password utente statica alla piattaforma.

Fase 1: crea un endpoint OAuth in ServiceNow

1. Cerca Registri delle applicazioni nel menu di navigazione di ServiceNow e fai clic su Nuovo.
2. Seleziona New Inbound Integration Experience (Nuova esperienza di integrazione in entrata).
3. Dall'elenco dei tipi di connessione, seleziona OAuth - Client credentials grant (OAuth - Concessione delle credenziali client).
4. Nel campo Nome, fornisci un nome descrittivo per la configurazione dell'endpoint.
5. Fornisci il nome o l'identificatore del provider OAuth richiesto per stabilire il contesto del profilo di identità.
6. Nel campo Utente applicazione OAuth, seleziona l'account utente ServiceNow dedicato che verrà impersonato e utilizzato per tutte le attività API automatizzate.
7. Fai clic su Invia o Salva.
8. Riapri il record del registro appena creato per copiare e proteggere l'ID client e il client secret generati.

Nota: se apri questo oggetto credenziale direttamente dalla visualizzazione classica "Application Registry", il campo Default Grant type viene compilato automaticamente con Resource Owner Password Credentials. Mantieni questa impostazione predefinita così com'è.

Fase 2: configura in Google SecOps

1. In Google SecOps, vai a Risposta > Configurazione delle integrazioni e apri la finestra di configurazione di ServiceNow.
2. Inserisci la tua Radice API (sostituendo il dominio segnaposto predefinito con l'URL dell'istanza ServiceNow effettiva).
3. Fornisci l'ID client e il client secret generati durante la Fase 1.
4. Assicurati che i campi Nome utente, Password e Token di aggiornamento siano lasciati completamente vuoti.
5. Attiva l'impostazione della casella di controllo Use Oauth Authentication (Utilizza l'autenticazione OAuth).
6. Fai clic su Test per convalidare i parametri utilizzando un test di ping della connettività. Se l'operazione va a buon fine, fai clic su Salva.

Opzione 2: autenticazione di base

Questo metodo utilizza la convalida diretta delle credenziali. È semplice da configurare, ma potrebbe essere limitato se la tua azienda applica l'autenticazione a più fattori (MFA) o blocca le intestazioni di autenticazione di base.

1. In ServiceNow, verifica che l'utente di integrazione abbia un nome utente e una password locali.
2. Quando configuri l'integrazione in Google SecOps, fornisci la Radice API (sostituendo il dominio segnaposto predefinito con l'URL dell'istanza ServiceNow effettiva), il Nome utente e la Password.
3. Lascia vuoti i campi relativi a OAuth e assicurati che Use Oauth Authentication sia disattivato (casella di controllo deselezionata).
4. Fai clic su Test per convalidare i parametri di connessione. Se l'operazione va a buon fine, fai clic su Salva.

Opzione 3: flusso del token di aggiornamento

Utilizza questo metodo se la tua organizzazione richiede controlli di sicurezza OAuth che utilizzano una catena di token di aggiornamento per recuperare in modo programmatico i token di accesso in background.

1. Completa la Fase 1 nell'istanza ServiceNow per generare un ID client e un client secret.
2. Completa i passaggi descritti nella sezione Genera un token di aggiornamento per recuperare una stringa di token di autorizzazione valida.
3. In Google SecOps, apri la finestra di configurazione dell'istanza di integrazione di ServiceNow.
4. Compila completamente i parametri utilizzando le credenziali configurate:
   • Radice API (sostituendo il dominio segnaposto predefinito con l'URL dell'istanza ServiceNow effettivo).
   • Nome utente
   • Password
   • ID client
   • Client secret
5. Seleziona la casella di controllo Use Oauth Authentication (Utilizza autenticazione OAuth).
6. Incolla la stringa del token recuperata dal flusso di lavoro della sezione Genera un token di aggiornamento nel campo Token di aggiornamento.
7. Fai clic su Test per convalidare i parametri di connessione. Se l'operazione va a buon fine, fai clic su Salva.

Genera un token di aggiornamento (Google SecOps)

Per generare il token di aggiornamento, devi configurare temporaneamente l'integrazione per eseguire un'azione helper.

1. In Google SecOps, vai a Risposta > Configurazione delle integrazioni.
2. Assicurati che la casella di controllo Utilizza l'autenticazione OAuth rimanga deselezionata per questo passaggio di configurazione iniziale.
3. Configura un'istanza di integrazione ServiceNow temporanea utilizzando Api Root, Username, Password, Client ID e Client Secret, quindi fai clic su Save.
4. Simula un caso o aprine uno esistente.
5. Esegui l'azione Get Oauth Token (Ottieni token OAuth) di ServiceNow manualmente sulla richiesta.
6. Copia il valore refresh_token dal risultato JSON dell'azione da utilizzare nel campo Token di aggiornamento durante la configurazione dell'istanza di integrazione finale.

Parametri di integrazione

L'integrazione di ServiceNow richiede i seguenti parametri:

Parametro	Descrizione
Api Root	Obbligatorio. La root API dell'istanza ServiceNow. Il valore predefinito è https://INSTANCE.service-now.com/api/now/v1/.
Username	Obbligatorio. Il nome utente dell'account ServiceNow.
Password	Obbligatorio. La password dell'account ServiceNow.
Incident Table	Facoltativo. Il nome o il percorso della tabella API da utilizzare per le azioni relative agli incidenti e il recupero dei record. Per impostazione predefinita, l'integrazione utilizza il percorso table/incident.
Verify SSL	Facoltativo. Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server ServiceNow. Abilitato per impostazione predefinita.
Client ID	Facoltativo. L'ID client per l'integrazione di ServiceNow, richiesto per l'autenticazione OAuth 2.0 utilizzando le credenziali client. Puoi eseguire l'autenticazione utilizzando il token di aggiornamento o le credenziali client. Se sono configurati sia il token di aggiornamento sia le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Client Secret	Facoltativo. Il client secret per l'integrazione di ServiceNow, richiesto per l'autenticazione OAuth 2.0 utilizzando le credenziali client. Puoi eseguire l'autenticazione utilizzando il token di aggiornamento o le credenziali client. Se sono configurati sia il token di aggiornamento sia le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Refresh Token	Facoltativo. Il token di aggiornamento per l'integrazione di ServiceNow, richiesto per l'autenticazione OAuth 2.0 utilizzando un token di aggiornamento. Questo token di aggiornamento configurato scade ogni 90 giorni. Puoi eseguire l'autenticazione utilizzando il token di aggiornamento o le credenziali client. Se sono configurati sia il token di aggiornamento sia le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Use Oauth Authentication	Facoltativo. Se selezionata, l'integrazione utilizza OAuth 2.0 per l'autenticazione. L'autenticazione OAuth 2.0 richiede l'impostazione delle credenziali client (Client ID e Client Secret) o di Refresh Token. Disattivato per impostazione predefinita.

Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configura le integrazioni.

Se necessario, puoi apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supporto di più istanze.

Azioni

Per saperne di più sulle azioni, consulta Rispondi alle azioni in attesa dalla scrivania di lavoro ed Esegui un'azione manuale nel tuo caso.

Aggiungi allegato

Utilizza l'azione Aggiungi allegato per aggiungere allegati a un record di tabella in ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Aggiungi allegato richiede i seguenti parametri:

Parametro	Descrizione
Table Name	Obbligatorio. Il nome della tabella contenente il record in cui viene aggiunto l'allegato.
Record Sys ID	Obbligatorio. L'ID di sistema (sys_id) del record in cui viene aggiunto l'allegato.
File Path	Obbligatorio. Un elenco separato da virgole di percorsi assoluti per i file da allegare.
Mode	Facoltativo. Il comportamento dell'azione quando esiste già un file con lo stesso nome nel record. I valori possibili sono: Add New Attachment: l'azione aggiunge il file come nuovo allegato separato. Sono consentiti file con lo stesso nome. Overwrite Existing Attachment: l'azione sostituisce l'allegato esistente con lo stesso nome. Il valore predefinito è Add New Attachment.

Output azione

L'azione Aggiungi allegato fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Aggiungi allegato:

{
    "result": {
        "size_bytes": "742",
        "file_name": "placeholder_document.txt",
        "sys_mod_count": "0",
        "average_image_color": "",
        "image_width": "",
        "sys_updated_on": "2025-01-01 10:00:00",
        "sys_tags": "",
        "table_name": "incident",
        "sys_id": "TEST_SYS_ID_ATTACH_123456789",
        "image_height": "",
        "sys_updated_by": "admin",
        "download_link": "https://placeholder.service-now.com/api/now/attachment/TEST_SYS_ID_ATTACH_123456789/file",
        "content_type": "multipart/form-data",
        "sys_created_on": "2025-01-01 10:00:00",
        "size_compressed": "438",
        "compressed": "true",
        "state": "pending",
        "table_sys_id": "TEST_SYS_ID_RECORD_ABCDEFG",
        "chunk_size_bytes": "700000",
        "hash": "test_hash_0000000000000000000000000000000000000000000000000000000000000000",
        "sys_created_by": "admin"
    }
}

Messaggi di output

L'azione Aggiungi allegato può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully added the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS Action wasn't able to add the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS No attachments were added to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS	L'azione è andata a buon fine.
Error executing action "Add Attachment". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Aggiungi allegato:

Nome del risultato dello script	Valore
is_success	true o false

Aggiungi commento

Utilizza l'azione Aggiungi commento per aggiungere un commento a un incidente di ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Aggiungi commento richiede i seguenti parametri:

Parametro	Descrizione
Incident Number	Obbligatorio. Il numero dell'incidente a cui aggiungere il commento, nel formato INCINCIDENT_NUMBER.
Comment	Obbligatorio. Il commento da aggiungere all'incidente.

Output azione

L'azione Aggiungi commento fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Non disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato dello script

La tabella seguente elenca i valori per l'output del risultato dello script quando utilizzi l'azione Aggiungi commento:

Nome del risultato dello script	Valore
is_success	true o false

Aggiungi commento e attendi risposta

Utilizza l'azione Aggiungi commento e attendi risposta per aggiungere un commento a un incidente ServiceNow, quindi metti in pausa l'esecuzione del playbook finché non viene aggiunto un nuovo commento o una nuova risposta all'incidente. L'output dell'azione è il contenuto del nuovo commento.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Aggiungi commento e attendi risposta richiede i seguenti parametri:

Parametro	Descrizione
Incident Number	Obbligatorio. Il numero dell'incidente a cui aggiungere il commento, nel formato INCINCIDENT_NUMBER.
Comment	Obbligatorio. Il commento da aggiungere all'incidente.

Output azione

L'azione Aggiungi commento e attendi risposta fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Non disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Aggiungi commento e attendi risposta:

Nome del risultato dello script	Valore
new_comment

Aggiungi commento al record

Utilizza l'azione Aggiungi commento al record per aggiungere un commento o una nota di lavoro a un record di tabella specifico in ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Nota: se attivi il parametro Wait For Reply, l'azione viene eseguita in modalità asincrona. Quando utilizzi la modalità asincrona, regola il valore di timeout dello script nell'IDE di Google SecOps in base al tempo di attesa previsto per una risposta.

Input azione

L'azione Aggiungi commento al record richiede i seguenti parametri:

Parametro	Descrizione
Table Name	Obbligatorio. Il nome della tabella a cui aggiungere il commento o la nota.
Type	Obbligatorio. Il tipo di commento o nota da aggiungere. I valori possibili sono: Comment Work Note Il valore predefinito è Comment.
Record Sys ID	Obbligatorio. L'ID di sistema (sys_id) a cui aggiungere il commento o la nota di lavoro.
Text	Obbligatorio. I contenuti del commento o della nota di lavoro.
Wait For Reply	Facoltativo. Se selezionata, l'azione viene eseguita in modo asincrono e mette in pausa l'esecuzione finché non viene aggiunto un nuovo commento o una nuova nota di lavoro al record. L'azione monitora i commenti se aggiungi un commento e le note di lavoro se aggiungi una nota di lavoro. Nota: se abilitata, questa azione viene eseguita in modalità asincrona. Regola il valore di timeout dello script nell'IDE di Google SecOps in base al tempo di attesa previsto per una risposta. Disattivato per impostazione predefinita.

Output azione

L'azione Aggiungi commento al record fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Aggiungi commento al record:

{
    "sys_id": "4355183607523010ff23f6fd7c1ed0a8",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "Test comment content.",
    "sys_created_by": "admin",
    "element": "comments"
}

Messaggi di output

L'azione Aggiungi commento al record può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully added COMMENT_OR_NOTE " CONTENT" to TABLE_NAME with Sys_ID SYS_ID in ServiceNow.	L'azione è andata a buon fine.
Error executing action "Add Comment To Record". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Aggiungi commento al record:

Nome del risultato dello script	Valore
is_success	true o false

Aggiungi incidente padre

Utilizza l'azione Aggiungi incidente padre per aggiungere un incidente padre per gli incidenti in ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Aggiungi incidente principale richiede i seguenti parametri:

Parametro	Descrizione
Parent Incident Number	Obbligatorio. Il numero dell'incidente padre, nel formato INCINCIDENT_NUMBER (ad esempio, INC0000051). L'azione aggiunge tutti gli incidenti in Child Incident Numbers come secondari per l'incidente principale.
Child Incident Numbers	Obbligatorio. Un elenco separato da virgole di numeri di incidenti da impostare come incidenti secondari per l'incidente principale specificato, nel formato INCINCIDENT_NUMBER (ad esempio, INC0000051).

Output azione

L'azione Aggiungi incidente principale fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Aggiungi incidente principale:

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "2a100a1c2fc42010c518532a2799b621",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}

Messaggi di output

L'azione Aggiungi incidente principale può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully set PARENT_INCIDENT_NUMBER as the "Parent Incident" for the following incidents in ServiceNow: CHILD_INCIDENT_NUMBERS.	L'azione è andata a buon fine.
Error executing action "Add Parent Incident". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Chiudi incidente

Utilizza l'azione Chiudi incidente per chiudere un incidente ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Importante: per eseguire questa azione, devi assegnare il ruolo sn_incident_write all'utente in ServiceNow. Per maggiori dettagli, vai a Configura l'accesso utente in ServiceNow.

Input azione

L'azione Chiudi incidente richiede i seguenti parametri:

Parametro	Descrizione
Incident Number	Obbligatorio. Il numero dell'incidente da chiudere, nel formato INCINCIDENT_NUMBER.
Close Reason	Obbligatorio. Il motivo della chiusura dell'incidente.
Resolution Code	Obbligatorio. Il codice di risoluzione dell'incidente. I valori possibili sono: Duplicate Known error No resolution provided Resolved by caller Resolved by change Resolved by problem Resolved by request Solution provided Workaround provided User error Il valore predefinito è Solution provided.
Close Notes	Obbligatorio. Le note di chiusura dell'incidente.

Output azione

L'azione Chiudi incidente fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Non disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Chiudi incidente:

Nome del risultato dello script	Valore
is_success	true o false

Crea incidente di avviso

Utilizza l'azione Crea incidente di avviso per creare un nuovo incidente in ServiceNow in base ai dettagli dell'avviso che avvia l'esecuzione del playbook.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Crea incidente di avviso richiede i seguenti parametri:

Parametro	Descrizione
Impact	Obbligatorio. Il livello di impatto dell'incidente. Importante: devi utilizzare il valore ServiceNow, ad esempio 1, anziché l'etichetta, ad esempio 1 - High. I valori possibili sono: 1 per Alto 2 per Medium 3 per Basso Il valore predefinito è 1.
Urgency	Obbligatorio. Il livello di urgenza dell'incidente. Importante: devi utilizzare il valore di ServiceNow (ad esempio 1) anziché l'etichetta (ad esempio 1 - High). I valori possibili sono i seguenti: 1 per Alto 2 per Medium 3 per Basso Il valore predefinito è 1.
Category	Facoltativo. La categoria dell'incidente. Importante: devi utilizzare il valore di ServiceNow, ad esempio database, anziché l'etichetta, ad esempio Database.
Assignment Group ID	Facoltativo. Il nome completo del gruppo a cui assegnare l'incidente.
Assigned User ID	Facoltativo. Il nome completo dell'utente a cui assegnare l'incidente.
Description	Facoltativo. La descrizione dell'incidente.

Output azione

L'azione Crea incidente di avviso fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Crea incidente di avviso:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010005",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by":
    "admin", "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "1",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 05:13:25",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 05:13:25",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 07:13:25",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 05:13:25",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Crea incidente di avviso:

Nome del risultato dello script	Valore
is_success	true o false

Crea incidente

Utilizza l'azione Crea incidente per creare un nuovo incidente in ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Crea incidente richiede i seguenti parametri:

Parametro	Descrizione
Short Description	Obbligatorio. La breve descrizione dell'incidente.
Impact	Obbligatorio. Il livello di impatto dell'incidente. Importante: devi utilizzare il valore ServiceNow, ad esempio 1, anziché l'etichetta, ad esempio 1 - High. I valori possibili sono: 1 per Alto 2 per Medium 3 per Basso Il valore predefinito è 1.
Urgency	Obbligatorio. Il livello di urgenza dell'incidente. Importante: devi utilizzare il valore di ServiceNow (ad esempio 1) anziché l'etichetta (ad esempio 1 - High). I valori possibili sono i seguenti: 1 per Alto 2 per Medium 3 per Basso Il valore predefinito è 1.
Category	Facoltativo. La categoria dell'incidente. Importante: devi utilizzare il valore di ServiceNow, ad esempio database, anziché l'etichetta, ad esempio Database.
Assignment Group ID	Facoltativo. Il nome completo del gruppo a cui assegnare l'incidente.
Assigned User ID	Facoltativo. Il nome completo dell'utente a cui assegnare l'incidente.
Description	Facoltativo. La descrizione dell'incidente.
Custom Fields	Facoltativo. Una stringa in formato JSON contenente i nomi dei campi e i relativi valori da aggiornare (ad esempio, {"location":"London", "category":"database"}). Puoi utilizzare questo parametro per modificare i campi non definiti esplicitamente come input dell'azione.

Output azione

L'azione Crea incidente fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Crea incidente:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010005",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by":
    "admin", "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "1",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 05:13:25",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 05:13:25",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 07:13:25",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 05:13:25",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}

Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Crea incidente:

Nome del risultato dello script	Valore
incident_number	INCIDENT_NUMBER

Create Record

Utilizza l'azione Crea record per creare nuovi record in diverse tabelle ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Crea record richiede i seguenti parametri:

Parametro	Descrizione
Table Name	Facoltativo. Il nome della tabella ServiceNow in cui viene creato il nuovo record (ad esempio, incident).
Object Json Data	Facoltativo. L'oggetto JSON contenente le coppie campo-valore necessarie per definire il nuovo record (ad esempio i campi dell'incidente o gli attributi degli elementi CMDB).

Output azione

L'azione Crea record fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Crea record:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010021",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "3",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "5",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 08:24:34",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": " ",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 08:24:34",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": " ",
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": " ",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 08:24:34",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "3",
    "reopen_count": "0"
}

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Crea record:

Nome del risultato dello script	Valore
object_sys_id	OBJECT_SYS_ID

Scarica allegati

Utilizza l'azione Scarica allegati per scaricare i file e i documenti allegati a un record ServiceNow specifico in una cartella locale nel tuo ambiente Google SecOps.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Scarica allegati richiede i seguenti parametri:

Parametro	Descrizione
Table Name	Obbligatorio. Il nome della tabella ServiceNow che contiene il record da cui scaricare gli allegati (ad esempio incident).
Record Sys ID	Obbligatorio. L'ID di sistema (sys_id) del record da cui vengono scaricati gli allegati.
Download Folder Path	Obbligatorio. Il percorso assoluto della cartella nell'ambiente Google SecOps in cui vengono salvati gli allegati scaricati.
Overewrite	Facoltativo. Se selezionata, l'azione sovrascrive i file con lo stesso nome. Disattivato per impostazione predefinita.

Output azione

L'azione Scarica allegati fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Scarica allegati:

{
    "result": [
        {"absolute_file_path" : ["PATH"]
            "size_bytes": "187",
            "file_name": "example.txt",
            "sys_mod_count": "1",
            "average_image_color": "",
            "image_width": "",
            "sys_updated_on": "2020-10-19 09:58:39",
            "sys_tags": "",
            "table_name": "problem",
            "sys_id": "SYS_ID",
            "image_height": "",
            "sys_updated_by": "system",
            "download_link": "https://example.service-now.com/api/now/attachment/ID/file",
            "content_type": "text/plain",
            "sys_created_on": "2020-10-19 09:58:38",
            "size_compressed": "172",
            "compressed": "true",
            "state": "available",
            "table_sys_id": "57771d002f002010c518532a2799b6cc",
            "chunk_size_bytes": "700000",
            "hash": "a4fbb8ab71268903845b59724835274ddc66e095de553c5e0c1da8fecd04ee45",
            "sys_created_by": "admin"
        }
    ]
}

Messaggi di output

L'azione Scarica allegati può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully downloaded the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME Action wasn't able to download the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME Action wasn't able to download attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME	L'azione è andata a buon fine.
Error executing action "Download Attachments". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Scarica allegati:

Nome del risultato dello script	Valore
is_success	true o false

Ottieni i dettagli dell'incidente secondario

Utilizza l'azione Recupera i dettagli dell'incidente secondario per recuperare informazioni sugli incidenti secondari in base all'incidente principale in ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Get Child Incident Details richiede i seguenti parametri:

Parametro	Descrizione
Parent Incident Number	Obbligatorio. Il numero dell'incidente principale da cui recuperare i dettagli dell'incidente secondario, nel formato INCINCIDENT_NUMBER.
Max Child Incident To Return	Facoltativo. Il numero massimo di incidenti secondari che l'azione restituisce dall'incidente principale. Il valore predefinito è 50.

Output azione

L'azione Get Child Incident Details fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Tabella della bacheca casi

L'azione Ottieni dettagli dell'incidente secondario fornisce la seguente tabella:

Nome della tabella: Dettagli dell'incidente secondario

Colonne della tabella:

• Sys ID (mappato come sys_id)
• Numero (mappato come number)
• Descrizione breve (mappata come short_description)
• Created At (mappato come sys_created_on)

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Get Child Incident Details:

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  ATF Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "2a100a1c2fc42010c518532a2799b621",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}

Messaggi di output

L'azione Get Child Incident Details può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully retrieved information about child incidents related to the PARENT_INCIDENT_NUMBER incident in ServiceNow. Action wasn't able to retrieve information about the child incidents in ServiceNow. Reason: incident PARENT_INCIDENT_NUMBER was not found. No child incidents were found.	L'azione è andata a buon fine.
Error executing action "Get Child Incident Details". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Recupera dettagli incidente secondario:

Nome del risultato dello script	Valore
is_success	true o false

Ottieni i dettagli del record CMDB

Utilizza l'azione Recupera dettagli record CMDB per ottenere record CMDB dettagliati dalla stessa classe in ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Importante: questa azione richiede l'assegnazione del ruolo itil all'utente in ServiceNow. Per maggiori dettagli, consulta Configura l'accesso degli utenti in ServiceNow.

Input azione

L'azione Get CMDB Record Details richiede i seguenti parametri:

Parametro	Descrizione
Class Name	Obbligatorio. Il nome della classe CMDB da cui recuperare i record, ad esempio cmdb_ci_appl. Per ulteriori informazioni sui nomi delle classi, consulta Visualizza e modifica la definizione e i metadati della classe.
Sys ID	Obbligatorio. Un elenco separato da virgole degli ID di sistema (sys_id) dei record CMDB per i quali recuperare i dettagli.
Max Records To Return	Facoltativo. Il numero massimo di relazioni tra record da restituire per ogni tipo di relazione (ad esempio relates to o depends on). Il valore predefinito è 50.

Output azione

L'azione Get CMDB Record Details fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Get CMDB Record Details:

{
    "result": {
        "outbound_relations": [
            {
                "sys_id": "56f3a7ad7f701200bee45f19befa910f",
                "type": {
                    "display_value": "Members::Member of",
                    "link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
                    "value": "ID"
                },
                "target": {
                    "display_value": "Example",
                    "link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
                    "value": "ID"
                }
            }
        ],
        "attributes": {
            "attested_date": "",
            "skip_sync": "false",
            "operational_status": "1",
            "caption": "",
            "cluster_type": "",
            "sys_updated_on": "2016-01-06 19:04:07",
            "attestation_score": "",
            "discovery_source": "",
            "first_discovered": "",
            "sys_updated_by": "example.user",
            "cluster_status": "",
            "due_in": "",
            "sys_created_on": "2016-01-06 16:47:15",
            "sys_domain": {
                "display_value": "global",
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "install_date": "",
            "invoice_number": "",
            "gl_account": "",
            "sys_created_by": "example.user",
            "warranty_expiration": "",
            "cluster_version": "",
            "asset_tag": "",
            "fqdn": "",
            "change_control": "",
            "owned_by": "",
            "checked_out": "",
            "sys_domain_path": "/",
            "delivery_date": "",
            "maintenance_schedule": "",
            "install_status": "1",
            "cost_center": "",
            "attested_by": "",
            "supported_by": "",
            "dns_domain": "",
            "name": "SAP-LB-Win-Cluster",
            "assigned": "",
            "purchase_date": "",
            "subcategory": "Cluster",
            "short_description": "",
            "assignment_group": "",
            "managed_by": "",
            "managed_by_group": "",
            "last_discovered": "",
            "can_print": "false",
            "sys_class_name": "cmdb_ci_win_cluster",
            "manufacturer": "",
            "sys_id": "SYS_ID",
            "cluster_id": "",
            "po_number": "",
            "checked_in": "",
            "sys_class_path": "/!!/!5/!$",
            "vendor": "",
            "mac_address": "",
            "company": "",
            "model_number": "",
            "justification": "",
            "department": "",
            "assigned_to": "",
            "start_date": "",
            "cost": "",
            "comments": "",
            "sys_mod_count": "1",
            "serial_number": "",
            "monitor": "false",
            "model_id": "",
            "ip_address": "",
            "duplicate_of": "",
            "sys_tags": "",
            "cost_cc": "USD",
            "support_group": "",
            "order_date": "",
            "schedule": "",
            "environment": "",
            "due": "",
            "attested": "false",
            "unverified": "false",
            "correlation_id": "",
            "attributes": "",
            "location": "",
            "asset": "",
            "category": "Resource",
            "fault_count": "0",
            "lease_id": ""
        },
        "inbound_relations": [
            {
                "sys_id": "3b3d95297f701200bee45f19befa910c",
                "type": {
                    "display_value": "Depends on::Used by",
                    "link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
                    "value": "ID"
                },
                "target": {
                    "display_value": "IP-Router-3",
                    "link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
                    "value": "ID"
                }
            }
        ]
    }
}

Messaggi di output

L'azione Get CMDB Record Details può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully returned details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST. Action wasn't able to return details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST Action wasn't able to return details for CMDB records in the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found. Action wasn't able to return details for CMDB record with Sys ID SYS_ID in the Class CLASS_NAME in Service Now. Reason: Record with Sys ID SYS_ID was not found in Class CLASS_NAME. Information about the provided Sys IDs was not found.	L'azione è andata a buon fine.
Error executing action "Get CMDB Record Details". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Get CMDB Record Details:

Nome del risultato dello script	Valore
is_success	true o false

Recupero incidente

Utilizza l'azione Recupera incidente per recuperare informazioni su un incidente ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Get Incident richiede i seguenti parametri:

Parametro	Descrizione
Incident Number	Obbligatorio. L'identificatore univoco dell'incidente ServiceNow da recuperare, nel formato INCINCIDENT_NUMBER.

Output azione

L'azione Get Incident fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Recupera incidente:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": "2012",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010041",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "10",
    "notify": "1",
    "resolved_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": "2020-07-10 12:53:06",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "priority": "1",
    "state": "7",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 12:18:04",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "sdf",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": "0",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": "Closed by Caller",
    "business_duration": "1970-01-01 00:00:00",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 13:13:57",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": "1970-01-01 00:35:02",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "false",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 14:33:28",
    "severity": "3",
    "incident_state": "7",
    "resolved_at": "2020-07-10 12:53:06",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 12:18:04",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": "Closed/Resolved by Caller",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Recupera incidente:

Nome del risultato dello script	Valore
incident_number	INCIDENT_NUMBER

Ottieni token OAuth

Utilizza l'azione Ottieni token OAuth per ottenere un token di aggiornamento OAuth per ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Nota:

Questa azione richiede l'impostazione dei seguenti parametri di integrazione:

• Username
• Password
• Client ID
• Client Secret

Input azione

Nessuno.

Output azione

L'azione Ottieni token OAuth fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Get Oauth Token:

{
    "access_token": "Na4Kb1oWpFcYNUnyAjsYldiTMxYF1Cz79Q",
    "refresh_token": "0ryCENbbvfggZbNG9rFFd8_C8X0UgAQSMQkPJNStGwEEt0qNt-F1lw",
    "scope": "useraccount",
    "token_type": "Bearer",
    "expires_in": 1799
}

Messaggi di output

L'azione Get Oauth Token può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully generated Oauth tokens for ServiceNow. Now navigate to the configuration tab and put "refresh_token" value in the "Refresh Token" parameter. Note: "Username" and "Password" parameters can be emptied.	L'azione è andata a buon fine.
Error executing action "Get Oauth Token". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Ottieni token OAuth:

Nome del risultato dello script	Valore
is_success	true o false

Get Record Details

Utilizza l'azione Recupera dettagli record per recuperare informazioni su record di tabella specifici in ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Get Record Details richiede i seguenti parametri:

Parametro	Descrizione
Table Name	Obbligatorio. Il nome della tabella ServiceNow che contiene il record da cui recuperare le informazioni (ad esempio incident).
Record Sys ID	Obbligatorio. L'ID di sistema (sys_id) del record ServiceNow specifico per il quale recuperare i dettagli.
Fields	Facoltativo. Un elenco separato da virgole di campi (colonne) specifici da restituire dal record recuperato (ad esempio sys_id,number,short_description). Se non viene fornito alcun valore, l'azione restituisce i campi predefiniti per il record.

Output azione

L'azione Get Record Details fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Get Record Details:

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  ATF Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "SYS_ID",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}

Messaggi di output

L'azione Get Record Details può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully retrieved information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow. Action wasn't able to retrieve information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow. Reason: ERROR_REASON.	L'azione è andata a buon fine.
Error executing action "Get Record Details". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Recupera dettagli record:

Nome del risultato dello script	Valore
is_success	true o false

Get User Details

Utilizza l'azione Get User Details per recuperare le informazioni sull'utente utilizzando il parametro sys_id in ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Get User Details richiede i seguenti parametri:

Parametro	Descrizione
User Sys IDs	Facoltativo. Un elenco separato da virgole degli ID di sistema corrispondenti agli utenti per i quali recuperare i dettagli (ad esempio sys_id_1,sys_id_2).
Emails	Facoltativo. Un elenco separato da virgole di indirizzi email corrispondenti agli utenti per i quali recuperare i dettagli (ad esempio [e-mail],[e-mail]).

Output azione

L'azione Recupera dettagli utente fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Tabella della bacheca casi

L'azione Get User Details (Recupera dettagli utente) fornisce la seguente tabella:

Nome tabella: Dettagli utente

Colonne della tabella:

• Sys ID (mappato come sys_id)
• Name (mappato come name)
• Nome utente (mappato come user_name)
• Email (mappata come email)

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Recupera dettagli utente:

{
    "result": [
        {
            "calendar_integration": "1",
            "country": "",
            "last_position_update": "",
            "user_password": "example",
            "last_login_time": "",
            "source": "",
            "sys_updated_on": "2020-08-29 02:42:42",
            "building": "",
            "web_service_access_only": "false",
            "notification": "2",
            "enable_multifactor_authn": "false",
            "sys_updated_by": "user@example",
            "sys_created_on": "2012-02-18 03:04:52",
            "agent_status": "",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "",
            "vip": "false",
            "sys_created_by": "admin",
            "longitude": "",
            "zip": "",
            "home_phone": "",
            "time_format": "",
            "last_login": "",
            "default_perspective": "",
            "geolocation_tracked": "false",
            "active": "true",
            "sys_domain_path": "/",
            "cost_center": {
                "link": "https://example.service-now.com/api/now/table/cmn_cost_center/ID",
                "value": "ID"
            },
            "phone": "",
            "name": "Example User",
            "employee_number": "",
            "password_needs_reset": "false",
            "gender": "Male",
            "city": "",
            "failed_attempts": "",
            "user_name": "example.user",
            "latitude": "",
            "roles": "",
            "title": "",
            "sys_class_name": "sys_user",
            "sys_id": "SYS_ID",
            "internal_integration_user": "false",
            "ldap_server": "",
            "mobile_phone": "",
            "street": "",
            "company": {
                "link": "https://example.service-now.com/api/now/table/core_company/ID",
                "value": "ID"
            },
            "department": {
                "link": "https://dev98773.service-now.com/api/now/table/cmn_department/ID",
                "value": "ID"
            },
            "first_name": "Example",
            "email": "[e-mail]",
            "introduction": "",
            "preferred_language": "",
            "manager": "",
            "business_criticality": "3",
            "locked_out": "false",
            "sys_mod_count": "4",
            "last_name": "User",
            "photo": "",
            "avatar": "063e38383730310042106710ce41f13b",
            "middle_name": "",
            "sys_tags": "",
            "time_zone": "",
            "schedule": "",
            "on_schedule": "",
            "date_format": "",
            "location": {
                "link": "https://example.service-now.com/api/now/table/cmn_location/ID",
                "value": "ID"
            }
        }
    ]
}

Messaggi di output

L'azione Get User Details può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully retrieved information about users from ServiceNow with the following Sys IDs: SYS_ID_LIST. Action wasn't able to retrieve information about the users in ServiceNow with the following Sys IDs: SYS_ID_LIST. Information about the users with specified Sys IDs was not found in ServiceNow.	L'azione è andata a buon fine.
Error executing action "Get User Details". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Recupera dettagli utente:

Nome del risultato dello script	Valore
is_success	true o false

Elenca i record CMDB

Utilizza l'azione Elenca record CMDB per elencare i record CMDB della stessa classe in ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Importante: questa azione richiede l'assegnazione del ruolo itil all'utente in ServiceNow. Per maggiori dettagli, vai a Configura l'accesso utente in ServiceNow.

Generazione del filtro della query

Il parametro Query Filter accetta stringhe di query codificate ServiceNow standard (sysparm_query). Puoi generare queste stringhe direttamente nell'interfaccia di ServiceNow (ad esempio, creando un filtro in una visualizzazione elenco e selezionando Copia query) o creandole manualmente.

Per istruzioni su come generare e utilizzare queste stringhe, consulta Stringhe di query codificate nella documentazione di ServiceNow.

Input azione

L'azione Elenca record CMDB richiede i seguenti parametri:

Parametro	Descrizione
Class Name	Obbligatorio. Il nome della classe CMDB da cui recuperare i record, ad esempio cmdb_ci_appl. Per saperne di più sui nomi delle classi ServiceNow, consulta Visualizza e modifica la definizione e i metadati della classe.
Query Filter	Facoltativo. La stringa di query codificata utilizzata per filtrare i record restituiti (ad esempio sys_idLIKE1^sys_idSTARTSWITH0). Puoi generare stringhe di query valide utilizzando l'opzione Copia query nelle visualizzazioni elenco di ServiceNow. Per saperne di più, consulta Stringhe di query codificate.
Max Records To Return	Facoltativo. Il numero massimo di record da recuperare in base ai filtri applicati. Il valore predefinito è 50.

Output azione

L'azione Elenca record CMDB fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Tabella della bacheca casi

L'azione Elenca record CMDB fornisce la seguente tabella:

Nome tabella: Record CLASS_NAME

Colonne della tabella:

• Name (mappato come name)
• Sys ID (mappato come sys_id)

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca record CMDB:

{
    "result": [
        {
            "sys_id": "SYS_ID",
            "name": "Example server"
        }
    ]
}

Messaggi di output

L'azione Elenca record CMDB può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully listed CMDB records for the Class CLASS_NAME in ServiceNow. Action wasn't able to list CMDB records for the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found in Service Now.".format(Class name)	L'azione è andata a buon fine.
Error executing action "List CMDB Records". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca record CMDB:

Nome del risultato dello script	Valore
is_success	true o false

Elenca i commenti dei record

Utilizza l'azione Elenca i commenti del record per elencare i commenti relativi a un record di tabella specifico in ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Elenca i commenti del record richiede i seguenti parametri:

Parametro	Descrizione
Table Name	Obbligatorio. Il nome della tabella ServiceNow che contiene il record per cui elencare i commenti (ad esempio incident).
Record Sys ID	Obbligatorio. L'ID di sistema (sys_id) del record per cui elencare i commenti.
Type	Obbligatorio. Il tipo di commenti o note da recuperare. I valori possibili sono: Comment Work Note Il valore predefinito è Comment.
Max Results To Return	Facoltativo. Il numero massimo di commenti o note di lavoro da restituire. Il valore predefinito è 50.

Output azione

L'azione Elenca i commenti del record fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca i commenti del record:

{
    "sys_id": "SYS_ID",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "test",
    "sys_created_by": "admin",
    "element": "comments"
}

Messaggi di output

L'azione Elenca i commenti del record può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow. No CONTENT_TYPE were found for TABLE_NAME with Sys ID SYS_ID in ServiceNow.	L'azione è andata a buon fine.
Error executing action "List Record Comments". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca i commenti del record:

Nome del risultato dello script	Valore
is_success	true o false

Elenca i record correlati all'utente

Utilizza l'azione Elenca i record correlati all'utente per elencare i record di una tabella correlati a un utente in ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Elenca i record correlati all'utente richiede i seguenti parametri:

Parametro	Descrizione
Table Name	Obbligatorio. Il nome della tabella ServiceNow in cui cercare i record correlati (ad esempio incident).
Usernames	Obbligatorio. Un elenco separato da virgole di nomi utente per i quali recuperare i record correlati.
Max Days Backwards	Obbligatorio. Il numero di giorni precedenti alla data corrente per la ricerca dei record correlati. Il valore predefinito è 1.
Max Records To Return	Facoltativo. Il numero massimo di record da restituire per ogni utente. Il valore predefinito è 50.

Output azione

L'azione Elenca i record correlati all'utente fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca i record correlati all'utente:

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-19 14:18:40",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010008",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-19 14:18:40",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-19 14:18:20",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "TEST",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": "",
            "sys_id": "SYS_ID",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": {
                "link": "https://example.service-now.com/api/now/table/core_company/ID",
                "value": "ID"
            },
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
         "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}

Messaggi di output

L'azione Elenca i record correlati all'utente può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully retrieved related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST. Action wasn't able to retrieve related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST. No related table records were retrieved for the provided users.	L'azione è andata a buon fine.
Error executing action "List Records Related To User". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca i record correlati all'utente:

Nome del risultato dello script	Valore
is_success	true o false

Dindin

Utilizza l'azione Ping per testare la connettività a ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

Nessuno.

Output azione

L'azione Ping fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Non disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Ping:

Nome del risultato dello script	Valore
is_success	true o false

Aggiorna incidente

Utilizza l'azione Aggiorna incidente per aggiornare le informazioni sull'incidente.

Questa azione non viene eseguita sulle entità Google SecOps.

Importante: per eseguire questa azione, devi assegnare il ruolo sn_incident_write all'utente in ServiceNow. Per maggiori dettagli, vai a Configura l'accesso utente in ServiceNow.

Input azione

L'azione Aggiorna incidente richiede i seguenti parametri:

Parametro	Descrizione
Incident Number	Obbligatorio. L'identificatore univoco dell'incidente ServiceNow da aggiornare, nel formato INCINCIDENT_NUMBER.
Short Description	Facoltativo. Una breve descrizione dell'incidente.
Impact	Facoltativo. Un livello di impatto per l'incidente. Importante: devi utilizzare il valore ServiceNow, ad esempio 1, anziché l'etichetta, ad esempio 1 - High. I valori possibili sono: 1 per Alto 2 per Medium 3 per Basso Il valore predefinito è 1.
Urgency	Facoltativo. Un livello di urgenza per l'incidente. Importante: devi utilizzare il valore di ServiceNow (ad esempio 1) anziché l'etichetta (ad esempio 1 - High). I valori possibili sono i seguenti: 1 per Alto 2 per Medium 3 per Basso Il valore predefinito è 1.
Category	Facoltativo. Una categoria per l'incidente. Importante: devi utilizzare il valore di ServiceNow, ad esempio database, anziché l'etichetta, ad esempio Database.
Assignment Group ID	Facoltativo. Il nome completo di un gruppo a cui assegnare l'incidente.
Assigned User ID	Facoltativo. Il nome completo di un utente a cui assegnare l'incidente.
Description	Facoltativo. La descrizione dell'incidente.
Incident State	Facoltativo. Il valore ServiceNow sottostante per lo stato dell'incidente (ad esempio, 1 o in_progress) anziché l'etichetta (ad esempio, New o In Progress).
Custom Fields	Facoltativo. Una stringa in formato JSON contenente i nomi dei campi e i relativi valori da aggiornare (ad esempio, {"location":"London", "category":"database"}). Puoi utilizzare questo parametro per modificare i campi non definiti esplicitamente come input dell'azione.

Output azione

L'azione Aggiorna incidente fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Non disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Aggiorna incidente:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": "2012",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010041",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "10",
    "notify": "1",
    "resolved_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": "2020-07-10 12:53:06",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "priority": "1",
    "state": "7",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 12:18:04",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "sdf",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": "0",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": "Closed by Caller",
    "business_duration": "1970-01-01 00:00:00",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 13:13:57",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": "1970-01-01 00:35:02",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "false",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 14:33:28",
    "severity": "3",
    "incident_state": "7",
    "resolved_at": "2020-07-10 12:53:06",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 12:18:04",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": "Closed/Resolved by Caller",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Aggiorna incidente:

Nome del risultato dello script	Valore
incident_number	INCIDENT_NUMBER

Aggiorna record

Utilizza l'azione Aggiorna record per modificare i record esistenti appartenenti a varie tabelle in ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Update Record richiede i seguenti parametri:

Parametro	Descrizione
Table Name	Facoltativo. Il nome della tabella ServiceNow che contiene il record da aggiornare (ad esempio incident).
Object Json Data	Obbligatorio. Un oggetto JSON contenente le coppie campo-valore da applicare al record (ad esempio {"short_description": "Updated description"}).
Record Sys ID	Obbligatorio. L'ID di sistema (sys_id) del record specifico da aggiornare.

Output azione

L'azione Aggiorna record fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Aggiorna record:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010021",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "3",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "5",
    "state": "1",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 08:24:34",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": " ",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 08:24:34",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": " ",
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": " ",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 08:24:34",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "3",
    "reopen_count": "0"
}

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Aggiorna record:

Nome del risultato dello script	Valore
record_sys_id	RECORD_SYS_ID

Attendi i commenti

Utilizza l'azione Attendi commenti per mettere in pausa l'esecuzione del playbook finché non viene aggiunto un commento o una nota di lavoro a un record di tabella specifico in ServiceNow.

Nota: questa azione viene eseguita in modo asincrono. Se il tempo di attesa previsto per un commento supera il timeout predefinito, devi modificare il valore di timeout dello script nell'IDE di Google SecOps.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Attendi commenti richiede i seguenti parametri:

Parametro	Descrizione
Table Name	Obbligatorio. Il nome della tabella ServiceNow che contiene il record da cui attendere i commenti (ad esempio incident).
Record Sys ID	Obbligatorio. L'ID di sistema (sys_id) del record da monitorare per i commenti.
Type	Obbligatorio. Il tipo di commenti o note che l'azione deve attendere. I valori possibili sono: Comment Work Note Il valore predefinito è Comment.
Wait Mode	Obbligatorio. La condizione che determina quando l'azione interrompe l'attesa e procede. I valori possibili sono: Until Timeout: l'azione attende l'intero periodo di timeout e poi restituisce tutti i commenti accumulati. Until First Message: l'azione attende fino alla pubblicazione del primo nuovo commento o della prima nota di lavoro dopo l'avvio dell'azione. Until Specific Text: l'azione attende finché non viene pubblicato un commento o una nota di lavoro contenente il testo specificato in Text. Nota: se selezionato, devi impostare anche Text. Il valore predefinito è Until Timeout.
Text	Facoltativo. La stringa di testo specifica che l'azione attende all'interno di un nuovo commento o di una nota di lavoro. Questo parametro viene utilizzato solo quando Until Specific Text è selezionato per il valore di Wait Mode.

Output azione

L'azione Attendi commenti fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Attendi commenti:

{
    "sys_id": "SYS_ID",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "test",
    "sys_created_by": "admin",
    "element": "comments"
}

Messaggi di output

L'azione Attendi commenti può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow. No new CONTENT_TYPE were added during the timeframe of action execution to TABLE_NAME with Sys ID SYS_ID in ServiceNow.	L'azione è andata a buon fine.
Error executing action "Wait For Comments". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Attendi commenti:

Nome del risultato dello script	Valore
is_success	true o false

Attendi l'aggiornamento del campo

Utilizza l'azione Attendi l'aggiornamento del campo per mettere in pausa l'esecuzione del playbook finché un campo specifico di un record di dati di ServiceNow non viene aggiornato con uno dei valori previsti.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Attendi aggiornamento campo richiede i seguenti parametri:

Parametro	Descrizione
Table Name	Obbligatorio. Il nome della tabella ServiceNow che contiene il record da monitorare (ad esempio incident).
Record Sys ID	Obbligatorio. L'ID di sistema (sys_id) del record da monitorare per l'aggiornamento del campo.
Field - Column Name	Obbligatorio. Il nome della colonna (campo) di cui l'azione monitora le modifiche.
Field - Values	Obbligatorio. Un elenco separato da virgole di valori che, se trovati nel campo monitorato, fanno sì che l'azione interrompa l'attesa e proceda (ad esempio In Progress,Resolved).

Output azione

L'azione Attendi aggiornamento campo fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Non disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Attendi aggiornamento campo:

Nome del risultato dello script	Valore
updated_field	UPDATED_FIELD

Attendi l'aggiornamento dello stato

Utilizza l'azione Attendi aggiornamento stato per mettere in pausa l'esecuzione del playbook finché lo stato di un incidente ServiceNow specifico non viene aggiornato a uno dei valori previsti.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Attendi aggiornamento stato richiede i seguenti parametri:

Parametro	Descrizione
Incident Number	Obbligatorio. L'identificatore univoco dell'incidente ServiceNow da monitorare, nel formato INCINCIDENT_NUMBER.
Statuses	Obbligatorio. Un elenco separato da virgole di stati degli incidenti che, se raggiunti, fanno sì che l'azione interrompa l'attesa e proceda (ad esempio In Progress,Resolved).

Output azione

L'azione Attendi aggiornamento stato fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Non disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Attendi aggiornamento stato:

Nome del risultato dello script	Valore
new_status	STATUS

Connettori

Per scoprire di più sulla configurazione dei connettori in Google SecOps, consulta Importa i dati (connettori).

Nota: per evitare la perdita di dati, i connettori utilizzano l'appiattimento degli eventi. Se un avviso non elaborato contiene un elenco di entità (ad esempio più indirizzi email, nomi host o indirizzi IP), i connettori le appiattiscono automaticamente in eventi separati e univoci.

Ad esempio, un singolo avviso non elaborato contenente tre indirizzi email diversi viene importato come tre eventi separati, ciascuno contenente un indirizzo email distinto.

Questo processo garantisce che ogni entità venga indicizzata correttamente come asset univoco, rendendola completamente ricercabile e utilizzabile nei playbook.

Connettore ServiceNow

Utilizza il connettore ServiceNow per recuperare gli incidenti da ServiceNow.

Nota: questo connettore supporta proxy, elenchi dinamici ed elenchi bloccati.

Utilizzo dell'elenco di query dinamiche

In ServiceNow Connector, l'elenco dinamico modifica il sysparm_query utilizzato dal connettore per eseguire query su ServiceNow. In questo modo è possibile filtrare i record in base a qualsiasi campo supportato per il tipo di record.

Per definire un filtro, configura ogni elemento dell'elenco dinamico in modo che contenga una coppia campo-valore nel seguente formato: FIELD_NAME=VALUE.

Ad esempio: category=security.

Quando Use whitelist as a blacklist è abilitato, il connettore inverte la logica della query, facendo sì che l'elenco dinamico funzioni come una lista bloccata anziché come un filtro.

Input del connettore

Il connettore ServiceNow richiede i seguenti parametri:

Parametro	Descrizione
Product Field Name	Obbligatorio. Il nome del campo in cui è memorizzato il nome del prodotto. Il nome del prodotto influisce principalmente sulla mappatura. Per semplificare e migliorare il processo di mappatura per il connettore, il valore predefinito viene risolto in un valore di riserva a cui viene fatto riferimento dal codice. Qualsiasi input non valido per questo parametro viene risolto in un valore di riserva per impostazione predefinita. Il valore predefinito è Product Name.
Event Field Name	Obbligatorio. Il nome del campo che determina il nome dell'evento (sottotipo). Il valore predefinito è sys_class_name.
Rule Generator	Facoltativo. Il nome del campo il cui valore definisce la query o il set di regole specifico da applicare durante il recupero dei record.
Api Root	Obbligatorio. La root API dell'istanza ServiceNow. Il valore predefinito è https://INSTANCE.service-now.com/api/now/v1/.
Username	Obbligatorio. Il nome utente dell'account ServiceNow.
Password	Obbligatorio. La password dell'account ServiceNow.
Verify SSL	Facoltativo. Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server ServiceNow. Abilitato per impostazione predefinita.
Use sys_domain Environment	Facoltativo. Se selezionato, il connettore utilizza il campo ServiceNow sys_domain come ambiente per la richiesta importata. Se questo campo non è presente o non è disponibile, il connettore utilizza per impostazione predefinita il valore specificato nel parametro Environment.
Days Backwards	Facoltativo. Il numero di giorni precedenti all'ora corrente per cui recuperare i record. Questo parametro viene utilizzato per l'esecuzione iniziale del connettore o come valore di riserva se un timestamp del connettore precedente è scaduto. Il valore predefinito è 5.
Disable Overflow	Facoltativo. Se selezionata, il connettore ignora il meccanismo di overflow di Google SecOps.
Max Incidents Per Cycle	Facoltativo. Il numero massimo di incidenti da recuperare durante ogni iterazione del connettore. Il valore predefinito è 10.
Environments Whitelist	Facoltativo. Un elenco separato da virgole di ambienti (domini) che il connettore deve importare in Google SecOps, ad esempio env1,env2.
Use whitelist as a blacklist	Facoltativo. Se selezionata, il connettore utilizza l'elenco dinamico come lista bloccata. Disattivato per impostazione predefinita.
PythonProcessTimeout	Obbligatorio. Il limite di timeout, in secondi, per il processo Python che esegue lo script corrente. Il valore predefinito è 60.
Incident Table	Facoltativo. Il nome o il percorso della tabella API da utilizzare per le azioni relative agli incidenti e il recupero dei record. Per impostazione predefinita, l'integrazione utilizza il percorso table/incident.
Client ID	Facoltativo. L'ID client per l'integrazione di ServiceNow, richiesto per l'autenticazione OAuth 2.0 utilizzando le credenziali client. Puoi eseguire l'autenticazione utilizzando il token di aggiornamento o le credenziali client. Se sono configurati sia il token di aggiornamento sia le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Client Secret	Facoltativo. Il client secret per l'integrazione di ServiceNow, richiesto per l'autenticazione OAuth 2.0 utilizzando le credenziali client. Puoi eseguire l'autenticazione utilizzando il token di aggiornamento o le credenziali client. Se sono configurati sia il token di aggiornamento sia le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Refresh Token	Facoltativo. Il token di aggiornamento per l'integrazione di ServiceNow, richiesto per l'autenticazione OAuth 2.0 utilizzando un token di aggiornamento. Questo token di aggiornamento configurato scade ogni 90 giorni. Puoi eseguire l'autenticazione utilizzando il token di aggiornamento o le credenziali client. Se sono configurati sia il token di aggiornamento sia le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Assignment Group	Facoltativo. Il nome del gruppo di assegnazione i cui record devono essere importati dal connettore.
Use Oauth Authentication	Facoltativo. Se selezionata, l'integrazione utilizza OAuth 2.0 per l'autenticazione. L'autenticazione OAuth 2.0 richiede l'impostazione delle credenziali client (Client ID e Client Secret) o di Refresh Token. Disattivato per impostazione predefinita.
Server Time Zone	Facoltativo. Il fuso orario configurato sul server ServiceNow (ad esempio UTC o Asia/Jerusalem). Il valore predefinito è UTC.
Table Name	Facoltativo. Il nome della tabella da cui recuperare i record, ad esempio incident.
Event Name	Facoltativo. Il nome dell'evento Google SecOps creato quando viene importato un record (ad esempio ServiceNowEvent).
Proxy Server Address	Facoltativo. L'indirizzo del server proxy da utilizzare.
Proxy Username	Facoltativo. Il nome utente del proxy con cui eseguire l'autenticazione.
Proxy Password	Facoltativo. La password del proxy con cui eseguire l'autenticazione.
Get User Information	Facoltativo. Se selezionata, il connettore recupera anche le informazioni sugli utenti correlati all'incidente. Disattivato per impostazione predefinita.

Job

Per saperne di più sui job, consulta Configura un nuovo job e Pianificazione avanzata.

ServiceNow - Sincronizza gli incidenti chiusi

Utilizza il job ServiceNow - Sincronizza gli incidenti chiusi per sincronizzare gli incidenti ServiceNow chiusi con gli avvisi e i casi Google SecOps corrispondenti.

Questo job elabora gli incidenti ServiceNow importati come avvisi e casi contenenti il tag ServiceNow e un valore di contesto TICKET_ID con il numero dell'incidente.

Parametri del job

Il job ServiceNow - Sync Closed Incidents richiede i seguenti parametri:

Parametro	Descrizione
API Root	Obbligatorio La root API dell'istanza ServiceNow. Il valore predefinito è https://INSTANCE.service-now.com/api/now/v1/.
Username	Obbligatorio Il nome utente dell'istanza ServiceNow.
Password	Obbligatorio La password dell'istanza ServiceNow.
Verify SSL	Optional Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server ServiceNow. Abilitato per impostazione predefinita.
Client ID	Optional L'ID client per l'integrazione di ServiceNow, richiesto per l'autenticazione OAuth 2.0 utilizzando le credenziali client. Puoi eseguire l'autenticazione utilizzando il token di aggiornamento o le credenziali client. Se sono configurati sia il token di aggiornamento sia le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Client Secret	Optional Il client secret per l'integrazione di ServiceNow, richiesto per l'autenticazione OAuth 2.0 utilizzando le credenziali client. Puoi eseguire l'autenticazione utilizzando il token di aggiornamento o le credenziali client. Se sono configurati sia il token di aggiornamento sia le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Refresh Token	Optional Il token di aggiornamento per l'integrazione di ServiceNow, necessario per l'autenticazione OAuth 2.0 utilizzando un token di aggiornamento. Questo token di aggiornamento configurato scade ogni 90 giorni. Puoi eseguire l'autenticazione utilizzando il token di aggiornamento o le credenziali client. Se sono configurati sia il token di aggiornamento sia le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Use OAuth Authentication	Optional Se selezionata, l'integrazione utilizza OAuth 2.0 per l'autenticazione. L'autenticazione OAuth 2.0 richiede l'impostazione delle credenziali client (Client ID e Client Secret) o di Refresh Token. Disattivato per impostazione predefinita.
Max Hours Backwards	Optional Il numero di ore precedenti all'ora corrente per cercare e sincronizzare gli incidenti chiusi. Il valore predefinito è 24.
Table Name	Obbligatorio Il nome della tabella del database in cui cercare gli incidenti chiusi (ad esempio, incident).

ServiceNow - Sincronizza incidenti

Utilizza il job ServiceNow - Sincronizza incidenti per sincronizzare i campi e gli allegati degli incidenti di ServiceNow con i casi e gli avvisi correlati in Google SecOps.

Per eseguire questo job, l'utente dell'integrazione di ServiceNow deve avere il ruolo ITIL (itil). Per saperne di più, consulta Ruoli di sistema di base nella documentazione di ServiceNow.

Requisiti per il lavoro

Affinché il job funzioni correttamente, assicurati che i seguenti elementi siano configurati nella richiesta o nell'avviso di Google SecOps (a seconda del parametro Sync Level):

• Tag: la richiesta deve avere il tag ServiceNow Incident Sync.
• Valore di contesto: il caso o l'avviso deve avere una chiave di contesto TICKET_ID contenente un elenco separato da virgole di numeri di incidenti ServiceNow (ad esempio, INC0000050,INC0000051). Imposta il valore di contesto TICKET_ID utilizzando l'azione Set Scope Context Value dell'integrazione Siemplify Utilities.

Parametri del job

Il job ServiceNow - Sync Incidents richiede i seguenti parametri:

Parametro	Descrizione
API Root	Obbligatorio La root API dell'istanza ServiceNow. Il valore predefinito è https://INSTANCE.service-now.com/api/now/v1/.
Username	Optional Il nome utente dell'istanza ServiceNow. Questo parametro è obbligatorio quando l'autenticazione viene eseguita utilizzando l'autenticazione di base con password.
Password	Optional La password dell'istanza ServiceNow. Questo parametro è obbligatorio quando l'autenticazione viene eseguita utilizzando l'autenticazione di base con password.
Sync Level	Obbligatorio Il livello al quale il job sincronizza i dati. Valori possibili: Case, Alert. Il valore predefinito è Case.
Max Hours Backwards	Obbligatorio Il numero massimo di ore precedenti all'ora corrente per la ricerca delle richieste da sincronizzare. Il valore predefinito è 24.
Verify SSL	Optional Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server ServiceNow. Abilitato per impostazione predefinita.
Use OAuth Authentication	Optional Se selezionata, il job utilizza l'autenticazione OAuth anziché l'autenticazione di base. Se selezionati, i parametri Client ID, Client Secret e Refresh Token sono obbligatori. Disattivato per impostazione predefinita.
Client ID	Optional L'ID client dell'applicazione ServiceNow. Obbligatorio se è selezionato Use OAuth Authentication.
Client Secret	Optional Il client secret dell'applicazione ServiceNow. Obbligatorio se è selezionato Use OAuth Authentication.
Refresh Token	Optional Il token di aggiornamento per l'applicazione ServiceNow. Obbligatorio se è selezionato Use OAuth Authentication.

Sincronizza i commenti dei record della tabella

Utilizza il job Sincronizza i commenti dei record della tabella per sincronizzare i commenti tra i record della tabella ServiceNow e i casi Google SecOps.

Parametri del job

Il job Sync Table Record Comments richiede i seguenti parametri:

Parametro	Descrizione
API Root	Obbligatorio La root API dell'istanza ServiceNow. Il valore predefinito è https://INSTANCE.service-now.com/api/now/v1/.
Username	Obbligatorio Il nome utente dell'istanza ServiceNow.
Password	Obbligatorio La password dell'istanza ServiceNow.
Verify SSL	Optional Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server ServiceNow. Abilitato per impostazione predefinita.
Client ID	Optional L'ID client per l'integrazione di ServiceNow, richiesto per l'autenticazione OAuth 2.0 utilizzando le credenziali client. Puoi eseguire l'autenticazione utilizzando il token di aggiornamento o le credenziali client. Se sono configurati sia il token di aggiornamento sia le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Client Secret	Optional Il client secret per l'integrazione di ServiceNow, richiesto per l'autenticazione OAuth 2.0 utilizzando le credenziali client. Puoi eseguire l'autenticazione utilizzando il token di aggiornamento o le credenziali client. Se sono configurati sia il token di aggiornamento sia le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Refresh Token	Optional Il token di aggiornamento per l'integrazione di ServiceNow, necessario per l'autenticazione OAuth 2.0 utilizzando un token di aggiornamento. Questo token di aggiornamento configurato scade ogni 90 giorni. Puoi eseguire l'autenticazione utilizzando il token di aggiornamento o le credenziali client. Se sono configurati sia il token di aggiornamento sia le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Use OAuth Authentication	Optional Se selezionata, l'integrazione utilizza OAuth 2.0 per l'autenticazione. L'autenticazione OAuth 2.0 richiede l'impostazione delle credenziali client (Client ID e Client Secret) o di Refresh Token. Disattivato per impostazione predefinita.
Table Name	Obbligatorio Il nome della tabella ServiceNow in cui cercare i record da cui sincronizzare i commenti (ad esempio, incident).

Sincronizza i commenti dei record della tabella per tag

Utilizza il job Sincronizza i commenti dei record della tabella per tag per sincronizzare i commenti tra i record della tabella ServiceNow e le richieste Google SecOps.

Requisiti per il lavoro

Affinché il job funzioni correttamente, la richiesta Google SecOps deve avere i seguenti due tag:

• ServiceNow TABLE_NAME (dove <var class="readonly">TABLE_NAME</var> è il nome della tabella ServiceNow, ad esempio incident).
• ServiceNow TicketId: TICKET_ID (dove <var class="readonly">TICKET_ID</var> è l'ID o il numero di sistema del record corrispondente).

Parametri del job

Il job Sync Table Record Comments By Tag richiede i seguenti parametri:

Parametro	Descrizione
API Root	Obbligatorio La root API dell'istanza ServiceNow. Il valore predefinito è https://INSTANCE.service-now.com/api/now/v1/.
Username	Obbligatorio Il nome utente dell'istanza ServiceNow.
Password	Mandatory La password dell'istanza ServiceNow.
Table Name	Obbligatorio Il nome della tabella del database in cui eseguire la ricerca, ad esempio incident.
Verify SSL	Optional Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server ServiceNow. Abilitato per impostazione predefinita.

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.