Integra ServiceNow con Google SecOps

Versione integrazione: 59.0

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:

• Generazione automatica di ticket per gli incidenti: crea automaticamente incidenti ServiceNow a partire 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 l'emissione manuale di ticket e arricchendo gli incidenti con informazioni pertinenti dell'avviso originale.

• Rimedio al phishing: automatizza i passaggi ripetitivi dell'indagine sul phishing, come la raccolta delle intestazioni delle email, l'analisi degli allegati e la ricerca di email simili, il che accelera i tempi di risposta.

• Orchestrazione della correzione delle vulnerabilità: orchestra i workflow di correzione delle vulnerabilità creando automaticamente richieste di modifica di ServiceNow per l'applicazione di patch o azioni di 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 flussi di lavoro ServiceNow.

• Contesto dell'intelligence sulle minacce: arricchisci gli avvisi di sicurezza con dati di intelligence sulle minacce provenienti direttamente dalla piattaforma ServiceNow, fornendo agli analisti un contesto più ampio per dare la 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 con autorizzazioni per creare e aggiornare record.

• Ruoli ServiceNow: i ruoli di sistema richiesti (sn_incident_write, itil) e una configurazione di accesso utente personalizzata (secops_user) per consentire l'accesso a tabelle specifiche.

• Connettività di rete: una configurazione di rete che consente il traffico dagli indirizzi IP di Google SecOps alla tua istanza ServiceNow.

• Credenziali OAuth (facoltativo): l'ID client e il client secret se prevedi di utilizzare l'autenticazione OAuth 2.0.

Configurare l'accesso utente in ServiceNow

Per consentire all'integrazione di sincronizzare i commenti ed eseguire azioni, devi completare 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: crea un nuovo ruolo (ad esempio secops_user) per gestire autorizzazioni di integrazione specifiche.

2. Crea una nuova regola ACL: l'integrazione richiede l'accesso alla tabella sys_journal_field, che per impostazione predefinita è limitato agli amministratori. Crea un nuovo ACL per l'operazione read per la tabella sys_journal_field e assegnalo al tuo ruolo personalizzato (secops_user).

3. Assegna ruoli all'utente: assegna i seguenti ruoli all'account utente ServiceNow destinato all'integrazione:

   • Il ruolo personalizzato che hai creato.

   • sn_incident_write: obbligatorio per le azioni Chiudi incidente e Aggiorna incidente.

   • itil: obbligatorio per le azioni Ottieni dettagli record CMDB e Elenca record CMDB.

(Facoltativo) Configurare l'autenticazione OAuth 2.0

Ti consigliamo di utilizzare l'autenticazione OAuth 2.0. Questo processo richiede un'azione sia in ServiceNow (per ottenere le credenziali) sia in Google SecOps (per generare un token).

Crea un endpoint OAuth (ServiceNow)

Nella tua istanza ServiceNow, assicurati che il plug-in OAuth 2.0 sia attivo e crea un endpoint API OAuth per client esterni.

Per istruzioni su come creare un endpoint, vedi Crea un endpoint per consentire ai client di accedere all'istanza.

Una volta creati, registra l'ID client e il client secret.

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 Response > Integrations Setup (Risposta > Configurazione integrazioni).

2. Importante: per questo passaggio devi disattivare Use Oauth Authentication.

   Configura un'istanza di integrazione ServiceNow temporanea utilizzando Nome utente, Password, ID client e Client secret.

3. Simula una richiesta o aprine una esistente.

4. Esegui manualmente l'azione Get Oauth Token (Ottieni token OAuth) di ServiceNow nella richiesta.

5. Copia il valore refresh_token dal risultato JSON dell'azione da utilizzare nel campo Token di aggiornamento durante la configurazione dell'integrazione.

Parametri di integrazione

L'integrazione di ServiceNow richiede i seguenti parametri:

Parametro	Descrizione
Api Root	Obbligatorio. La radice 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 e il recupero dei record correlati agli incidenti. Per impostazione predefinita, l'integrazione utilizza il percorso table/incident.
Verify SSL	Facoltativo. Se selezionata, l'integrazione convalida il certificato SSL quando si connette al server ServiceNow. Abilitato per impostazione predefinita.
Client ID	Facoltativo. L'ID client per l'integrazione di ServiceNow, necessario 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 che le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Client Secret	Facoltativo. Il client secret per l'integrazione di ServiceNow, necessario 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 che 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, 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 che 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. Disabilitato per impostazione predefinita.

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

Se necessario, potrai 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 Supportare più istanze.

Azioni

Per ulteriori informazioni sulle azioni, vedi Rispondere alle azioni in attesa dalla tua scrivania e Eseguire un'azione manuale.

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 sistema (sys_id) del record a 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 dell'azione

L'azione Aggiungi allegato fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 si utilizza 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 è riuscita.
Error executing action "Add Attachment". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La seguente tabella elenca il valore dell'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 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 dell'azione

L'azione Aggiungi commento fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 seguente tabella 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 dell'azione

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

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 dell'output del risultato dello script quando utilizzi l'azione Aggiungi commento e attendi risposta:

Nome del risultato dello script	Valore
new_comment

Aggiungi commento alla registrazione

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 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 sistema (sys_id) a cui aggiungere il commento o la nota di lavoro.
Text	Obbligatorio. Il contenuto del commento o della nota di lavoro.
Wait For Reply	Facoltativo. Se selezionata, l'azione viene eseguita in modo asincrono e la sua esecuzione viene sospesa finché non viene aggiunto un nuovo commento o una nuova nota di lavoro al record. L'azione tiene traccia dei commenti se ne aggiungi uno e delle note di lavoro se ne aggiungi una. Nota:se attivata, questa azione viene eseguita in modalità asincrona. Modifica il valore di timeout dello script nell'IDE Google SecOps in base al tempo di attesa previsto per una risposta. Disabilitato per impostazione predefinita.

Output dell'azione

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

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 si utilizza 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 è riuscita.
Error executing action "Add Comment To Record". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore dell'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 principale per aggiungere un incidente principale 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 dell'azione

L'azione Aggiungi incidente genitore fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 si utilizza 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 è riuscita.
Error executing action "Add Parent Incident". Reason: ERROR_REASON	L'azione non è riuscita. 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 Configurare 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 dell'azione

L'azione Chiudi incidente fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 seguente tabella elenca il valore dell'output del risultato dello script quando utilizzi l'azione Chiudi incidente:

Nome del risultato dello script	Valore
is_success	true o false

Crea incidente avviso

Utilizza l'azione Crea incidente 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 avviso richiede i seguenti parametri:

Parametro	Descrizione
Impact	Obbligatorio. Il livello di impatto dell'incidente. I valori possibili sono: 1 per Alto 2 per la media 3 per Bassa Il valore predefinito è 1.
Urgency	Obbligatorio. Il livello di urgenza dell'incidente. I valori possibili sono i seguenti 1 per Alto 2 per la media 3 per Bassa Il valore predefinito è 1.
Category	Facoltativo. La categoria dell'incidente.
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 dell'azione

L'azione Crea incidente avviso fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 si utilizza 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 seguente tabella elenca il valore dell'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. I valori possibili sono: 1 per Alto 2 per la media 3 per Bassa Il valore predefinito è 1.
Urgency	Obbligatorio. Il livello di urgenza dell'incidente. I valori possibili sono i seguenti 1 per Alto 2 per la media 3 per Bassa Il valore predefinito è 1.
Category	Facoltativo. La categoria dell'incidente.
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. Un elenco separato da virgole di nomi di campi e dei relativi valori da includere nel nuovo record dell'incidente ServiceNow, nel formato field_1:value_1,field_2:value_2 (ad esempio, company:ACME,location:London). Puoi utilizzare questo parametro per impostare i valori per i campi non elencati esplicitamente come input dell'azione (ad esempio `location` o `priority`).

Output dell'azione

L'azione Crea incidente fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 si utilizza 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 seguente tabella 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 tabelle ServiceNow diverse.

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 dell'elemento CMDB).

Output dell'azione

L'azione Crea record fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 si utilizza 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 seguente tabella elenca il valore dell'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 file e 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 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. Disabilitato per impostazione predefinita.

Output dell'azione

L'azione Scarica allegati fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 si utilizza 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 Ping 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 è riuscita.
Error executing action "Download Attachments". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando si utilizza l'azione Scarica allegati:

Nome del risultato dello script	Valore
is_success	true o false

Recuperare i dettagli dell'incidente secondario

Utilizza l'azione Recupera dettagli 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 Recupera dettagli incidente figlio 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 restituiti dall'azione dall'incidente principale. Il valore predefinito è 50.

Output dell'azione

L'azione Ottieni dettagli incidente minore fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 incidente secondario fornisce la seguente tabella:

Nome tabella: Child Incident Details

Colonne della tabella:

• ID sistema (mappato come sys_id)
• Numero (mappato come number)
• Descrizione breve (mappata come short_description)
• Data di creazione (mappato come sys_created_on)

Risultato JSON

Il seguente esempio mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Ottieni dettagli incidente secondario:

{
    "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 Ottieni dettagli incidente bambino 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 è riuscita.
Error executing action "Get Child Incident Details". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando si utilizza l'azione Ottieni dettagli incidente secondario:

Nome del risultato dello script	Valore
is_success	true o false

Visualizza i dettagli del record CMDB

Utilizza l'azione Ottieni 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, vedi Configurare l'accesso utente in ServiceNow.

Input azione

L'azione Recupera dettagli 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 ulteriori informazioni sui nomi delle classi, vedi Visualizzare e modificare la definizione e i metadati della classe.
Sys ID	Obbligatorio. Un elenco separato da virgole degli ID 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 dell'azione

L'azione Recupera dettagli record CMDB fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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

Il seguente esempio mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Ottieni dettagli record CMDB:

{
    "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 Recupera dettagli record CMDB 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 è riuscita.
Error executing action "Get CMDB Record Details". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

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

Nome del risultato dello script	Valore
is_success	true o false

Recupero incidente

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

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Ottieni incidente richiede i seguenti parametri:

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

Output dell'azione

L'azione Recupera incidente fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 si utilizza l'azione Get Incident:

{
    "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 dell'output del risultato dello script quando utilizzi l'azione Recupera incidente:

Nome del risultato dello script	Valore
incident_number	INCIDENT_NUMBER

Recupero 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 di impostare i seguenti parametri di integrazione:

• Username
• Password
• Client ID
• Client Secret

Input azione

Nessuno.

Output dell'azione

L'azione Recupera token OAuth fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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

Il seguente esempio mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Ottieni token OAuth:

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

Messaggi di output

L'azione Ottieni token OAuth 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 è riuscita.
Error executing action "Get Oauth Token". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

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

Nome del risultato dello script	Valore
is_success	true o false

Recupero dettagli record

Utilizza l'azione Ottieni dettagli record per recuperare informazioni su record di tabelle specifici in ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Ottieni dettagli record 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 sistema (sys_id) del record ServiceNow specifico per cui 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 dell'azione

L'azione Ottieni dettagli record fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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

Il seguente esempio mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Ottieni dettagli record:

{
    "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 Recupera dettagli record 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 è riuscita.
Error executing action "Get Record Details". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

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

Nome del risultato dello script	Valore
is_success	true o false

Ottieni dettagli utente

Utilizza l'azione Ottieni dettagli utente per recuperare informazioni sull'utente utilizzando il parametro sys_id in ServiceNow.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Ottieni dettagli utente richiede i seguenti parametri:

Parametro	Descrizione
User Sys IDs	Facoltativo. Un elenco separato da virgole degli ID 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 dell'azione

L'azione Recupera dettagli utente fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 utente fornisce la seguente tabella:

Nome tabella: Dettagli utente

Colonne della tabella:

• ID sistema (mappato come sys_id)
• Nome (mappato come name)
• Nome utente (mappato come user_name)
• Email (mappato come email)

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Ottieni 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 Recupera dettagli utente 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 è riuscita.
Error executing action "Get User Details". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

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

Nome del risultato dello script	Valore
is_success	true o false

Elenca 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 Configurare l'accesso utente in ServiceNow.

Generazione del filtro query

Il parametro Query Filter accetta stringhe di query codificate ServiceNow standard (sysparm_query). Puoi generare queste stringhe direttamente nell'interfaccia 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 ulteriori informazioni sui nomi delle classi ServiceNow, vedi Visualizzare e modificare la definizione e i metadati delle classi.
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 ulteriori informazioni, vedi 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 dell'azione

L'azione Elenca record CMDB fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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:

• Nome (mappato come name)
• ID sistema (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 è riuscita.
Error executing action "List CMDB Records". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

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

Nome del risultato dello script	Valore
is_success	true o false

Elenco commenti record

Utilizza l'azione Elenca commenti 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 commenti 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 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 dell'azione

L'azione Elenca commenti record fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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

Il seguente esempio mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Elenca commenti 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 commenti 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 è riuscita.
Error executing action "List Record Comments". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

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

Nome del risultato dello script	Valore
is_success	true o false

Elenca record correlati all'utente

Utilizza l'azione Elenca 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 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 a partire dalla data attuale per cercare 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 dell'azione

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

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 si utilizza l'azione Elenca 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 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 è riuscita.
Error executing action "List Records Related To User". Reason: ERROR_REASON	L'azione non è riuscita. 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 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 dell'azione

L'azione Ping fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 seguente tabella elenca il valore dell'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 Configurare 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. I valori possibili sono: 1 per Alto 2 per la media 3 per Bassa Il valore predefinito è 1.
Urgency	Facoltativo. Un livello di urgenza per l'incidente. I valori possibili sono i seguenti 1 per Alto 2 per la media 3 per Bassa Il valore predefinito è 1.
Category	Facoltativo. Una categoria per l'incidente.
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. Un nome o un ID stato per l'incidente (ad esempio New o In Progress).
Custom Fields	Facoltativo. Un elenco separato da virgole dei nomi dei campi e dei relativi valori da aggiornare, nel formato field_1:value_1,field_2:value_2 (ad esempio company:ACME,location:London). Puoi utilizzare questo parametro per modificare i campi non definiti esplicitamente come input dell'azione (ad esempio location o priority).

Output dell'azione

L'azione Aggiorna incidente fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 si utilizza 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 seguente tabella elenca il valore dell'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 Aggiorna 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 sistema (sys_id) del record specifico da aggiornare.

Output dell'azione

L'azione Aggiorna record fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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

Il seguente esempio mostra l'output del risultato JSON ricevuto quando si utilizza 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 dell'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 sospendere 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. Devi modificare il valore di timeout dello script nell'IDE Google SecOps se il tempo di attesa previsto per un commento supera il timeout predefinito.

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 sistema (sys_id) del record da monitorare per i commenti.
Type	Obbligatorio. Il tipo di commenti o note per cui 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 smette di attendere 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 la pubblicazione del primo nuovo commento o nota di lavoro dopo l'avvio dell'azione. Until Specific Text: l'azione attende la pubblicazione di un commento o di una nota di lavoro contenente il testo specificato in Text. Nota:se selezionata, 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 nota di lavoro. Questo parametro viene utilizzato solo quando Until Specific Text è selezionato per il valore di Wait Mode.

Output dell'azione

L'azione Attendi commenti fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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

Il seguente esempio mostra l'output del risultato JSON ricevuto quando si utilizza 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 è riuscita.
Error executing action "Wait For Comments". Reason: ERROR_REASON	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore dell'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 aggiornamento campo per sospendere l'esecuzione del playbook finché un campo specifico in un record di dati ServiceNow non viene aggiornato a 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 sistema (sys_id) del record da monitorare per l'aggiornamento del campo.
Field - Column Name	Obbligatorio. Il nome della colonna (campo) che l'azione monitora per rilevare le modifiche.
Field - Values	Obbligatorio. Un elenco di valori separati da virgola che, se trovati nel campo monitorato, causano l'interruzione dell'attesa e l'avanzamento dell'azione (ad esempio In Progress,Resolved).

Output dell'azione

L'azione Attendi aggiornamento campo fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 dell'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é uno stato (stato) specifico dell'incidente ServiceNow 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 dell'incidente che, se raggiunti, causano l'interruzione dell'attesa dell'azione e la sua esecuzione (ad esempio In Progress,Resolved).

Output dell'azione

L'azione Attendi aggiornamento stato fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 dell'output del risultato dello script quando utilizzi l'azione Attendi aggiornamento stato:

Nome del risultato dello script	Valore
new_status	STATUS

Connettori

Per saperne di più su come configurare i connettori in Google SecOps, consulta Importare i dati (connettori).

Connettore ServiceNow

Utilizza il connettore ServiceNow per recuperare gli incidenti da ServiceNow.

Nota :questo connettore supporta proxy, elenchi dinamici e blocklist.

Utilizzare l'elenco delle query dinamiche

In ServiceNow Connector, l'elenco dinamico modifica sysparm_query che il connettore utilizza 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 è attivato, il connettore inverte la logica della query, facendo in modo 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 la procedura di mappatura per il connettore, il valore predefinito viene risolto in un valore di riserva a cui viene fatto riferimento dal codice. Per impostazione predefinita, qualsiasi input non valido per questo parametro viene risolto in un valore di riserva. Il valore predefinito è Product Name.
Event Field Name	Obbligatorio. Il nome del campo che determina il nome (sottotipo) dell'evento. 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 radice 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 quando si connette al server ServiceNow. Abilitato per impostazione predefinita.
Days Backwards	Facoltativo. Il numero di giorni a partire dall'ora attuale per recuperare i record. Questo parametro viene utilizzato per l'esecuzione iniziale del connettore o come valore di riserva se il timestamp di un connettore precedente è scaduto. Il valore predefinito è 5.
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) in cui il connettore deve inserire dati in Google SecOps, ad esempio env1,env2.
Use whitelist as a blacklist	Facoltativo. Se selezionato, il connettore utilizza l'elenco dinamico come blocklist. Disabilitato 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 e il recupero dei record correlati agli incidenti. Per impostazione predefinita, l'integrazione utilizza il percorso table/incident.
Client ID	Facoltativo. L'ID client per l'integrazione di ServiceNow, necessario 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 che le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Client Secret	Facoltativo. Il client secret per l'integrazione di ServiceNow, necessario 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 che 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, 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 che le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Assignment Group	Facoltativo. Il nome del gruppo di assegnazione di cui il connettore deve importare i record.
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. Disabilitato 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 per l'autenticazione.
Get User Information	Facoltativo. Se selezionato, il connettore recupera anche le informazioni sugli utenti correlati all'incidente. Disabilitato per impostazione predefinita.

Job

Per saperne di più sui job, vedi Configurare un nuovo job e Pianificazione avanzata.

ServiceNow - Sincronizza incidenti chiusi

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

Questo job elabora gli incidenti ServiceNow inseriti come avvisi e richieste contenenti il tag ServiceNow e un valore di contesto TICKET_ID con il numero di incidente.

Parametri del job

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

Parametro	Descrizione
Api Root	Obbligatorio. La radice 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	Facoltativo. Se selezionata, l'integrazione convalida il certificato SSL quando si connette al server ServiceNow. Abilitato per impostazione predefinita.
Client ID	Facoltativo. L'ID client per l'integrazione di ServiceNow, necessario 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 che le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Client Secret	Facoltativo. Il client secret per l'integrazione di ServiceNow, necessario 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 che 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, 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 che 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. Disabilitato per impostazione predefinita.
Max Hours Backwards	Facoltativo. Il numero di ore a partire dall'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 - Sync Incidents per sincronizzare i campi degli incident di ServiceNow e gli allegati con i casi e gli avvisi correlati in Google SecOps.

Importante: per eseguire questo job, l'utente di integrazione ServiceNow deve disporre del ruolo ITIL (itil).

Per saperne di più, consulta la sezione Ruoli di sistema di base nella documentazione di ServiceNow.

Requisiti del lavoro

Affinché il job funzioni correttamente, assicurati che siano configurati i seguenti elementi nel caso 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 di numeri di incident ServiceNow separati da virgole (ad esempio, INC0000050,INC0000051). Nota: puoi impostare il valore di contesto TICKET_ID utilizzando l'azione Imposta valore di contesto ambito dall'integrazione di Siemplify Utilities.

Parametri del job

Il job ServiceNow - Sync Incidents richiede i seguenti parametri:

Parametro	Descrizione
Api Root	Obbligatorio. La radice 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.
Sync Level	Obbligatorio. Il livello a cui il job sincronizza i dati. I valori possibili sono: Case Alert Il valore predefinito è Case.
Max Hours Backwards	Obbligatorio. Il numero massimo di ore a partire dall'ora attuale per cercare i casi da sincronizzare. Il valore predefinito è 24.
Verify SSL	Facoltativo. Se selezionata, l'integrazione convalida il certificato SSL quando si connette al server ServiceNow. Abilitato per impostazione predefinita.

Sincronizza i commenti dei record della tabella

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

Parametri del job

Il job Sincronizza commenti record tabella richiede i seguenti parametri:

Parametro	Descrizione
Api Root	Obbligatorio. La radice 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	Facoltativo. Se selezionata, l'integrazione convalida il certificato SSL quando si connette al server ServiceNow. Abilitato per impostazione predefinita.
Client ID	Facoltativo. L'ID client per l'integrazione di ServiceNow, necessario 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 che le credenziali client, l'integrazione utilizza il token di aggiornamento per l'autenticazione.
Client Secret	Facoltativo. Il client secret per l'integrazione di ServiceNow, necessario 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 che 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, 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 che 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. Disabilitato per impostazione predefinita.
Table Name	Obbligatorio. Il nome della tabella ServiceNow in cui cercare i record da cui sincronizzare i commenti (ad esempio incident).

Sincronizzare i commenti dei record della tabella per tag

Utilizza il job Sync Table Record Comments By Tag per sincronizzare i commenti tra i record della tabella ServiceNow e i casi Google SecOps.

Requisiti del lavoro

Affinché il job funzioni correttamente, la richiesta di Google SecOps deve possedere 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 radice 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.
Table Name	Obbligatorio. Il nome della tabella del database da cercare, ad esempio incident.
Verify SSL	Facoltativo. Se selezionata, l'integrazione convalida il certificato SSL quando si connette al server ServiceNow. Abilitato per impostazione predefinita.

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