Questa pagina è stata tradotta dall'API Cloud Translation.

Cofense Triage

Versione integrazione: 10.0

Casi d'uso

Importa i report di Cofense Triage e utilizzali per creare avvisi di Google Security Operations. Successivamente, in Google SecOps, gli avvisi possono essere utilizzati per eseguire orchestrazioni con playbook o analisi manuali.
Arricchimento delle entità correlate e dettagli sul report.
Triage della segnalazione.

Configura l'integrazione di Cofense Triage in Google SecOps

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

Parametri di integrazione

Utilizza i seguenti parametri per configurare l'integrazione:

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
Root API	Stringa	https://tap.phishmecloud.com	N/D	Radice dell'API dell'istanza di Cofense Triage.
ID client	Stringa	N/D	Sì	ID client dell'account Cofense Triage.
Client secret	Password	N/D	Sì	Client secret dell'account Cofense Triage.
Verifica SSL	Casella di controllo	Deselezionata	Sì	Se abilitata, verifica che il certificato SSL per la connessione al server Cofense Triage sia valido.

Azioni

Aggiungere tag al report

Descrizione

Aggiungere tag a un report in Cofense Triage.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID report	Stringa	N/D	Sì	Specifica l'ID del report a cui vuoi aggiungere i tag.
Tag	CSV	N/D	Sì	Specifica un elenco separato da virgole di tag da applicare al report.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
    "data": {
        "id": "13507",
        "type": "reports",
        "links": {
            "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507"
        },
        "attributes": {
            "location": "Inbox",
            "risk_score": 96,
            "from_address": null,
            "subject": "Test Phishing domain",
            "received_at": "2020-10-12T21:30:54.000Z",
            "reported_at": "2020-10-12T21:30:53.000Z",
            "raw_headers": "X-Triage-Noise-Reduction: state=0\r\nX-Triage-Noise-Reduction: score=79\r\nX-Triage-Noise-Reduction: vacb1561f9d032089\";\r\n charset=UTF-8\r\nContent-Transfer-Encoding: 7bit",
            "text_body": "Testing<http://dsrihsddk.net/>\r\n\r\nThis is a poor reputation domain\r\n\r\n",
            "html_body": "<html xmlns:v=\"urn:schemas-microsoft-com:vml\" xml>\r\n</div>\r\n</body>\r\n</html>\r\n",
            "md5": "81fe86fc9c244be978ab8b8392d3c986",
            "sha256": "146b857b2a147eeb9091571327452006438294aeb21069e38c6f25a811aa6c03",
            "match_priority": 1,
            "tags": [
                "dsa",
                "asd"
            ],
            "categorization_tags": [],
            "processed_at": null,
            "created_at": "2020-10-12T21:31:36.495Z",
            "updated_at": "2020-11-17T15:33:27.567Z"
        },
        "relationships": {
            "assignee": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/assignee",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/assignee"
                },
                "data": null
            },
            "category": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/category",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/category"
                },
                "data": null
            },
            "cluster": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/cluster",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/cluster"
                },
                "data": {
                    "type": "clusters",
                    "id": "3915"
                }
            },
            "reporter": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/reporter",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/reporter"
                },
                "data": {
                    "type": "reporters",
                    "id": "5331"
                }
            },
            "attachment_payloads": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/attachment_payloads",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/attachment_payloads"
                }
            },
            "attachments": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/attachments",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/attachments"
                }
            },
            "headers": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/headers",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/headers"
                }
            },
            "hostnames": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/hostnames",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/hostnames"
                }
            },
            "urls": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/urls",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/urls"
                }
            },
            "rules": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/rules",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/rules"
                }
            },
            "threat_indicators": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/threat_indicators",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/threat_indicators"
                }
            }
        },
        "meta": {
            "risk_score_summary": {
                "integrations": 75,
                "vip": 5,
                "reporter": 15,
                "rules": 1
            }
        }
    }
}

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: if successful(is_success = true): print "Successfully added tags to the the report with ID {0} in Cofense Triage.".format(report_id) if unsuccessful aka status code 404(is_success = false): print "Action wasn't able to add tags to the report with ID {0} in Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail) L'azione deve non riuscire e interrompere l'esecuzione di un playbook: if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Add Tags To Report". Motivo: {0}''.format(error.Stacktrace)	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

if successful(is_success = true): print "Successfully added tags to the the report with ID {0} in Cofense Triage.".format(report_id)

if unsuccessful aka status code 404(is_success = false):
print "Action wasn't able to add tags to the report with ID {0} in Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail)

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Add Tags To Report". Motivo: {0}''.format(error.Stacktrace)

Generale

Report Categorizza

Descrizione

Classificare una segnalazione in Cofense Triage.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID report	Stringa	N/D	Sì	Specifica l'ID del report a cui vuoi aggiungere i tag.
Nome categoria	Stringa	N/D	Sì	Specifica il nome della categoria da applicare al report. Le categorie disponibili sono disponibili nell'azione "Elenca categorie".

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
    "data": {
        "id": "13507",
        "type": "reports",
        "links": {
            "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507"
        },
        "attributes": {
            "location": "Inbox",
            "risk_score": 96,
            "from_address": null,
            "subject": "Test Phishing domain",
            "received_at": "2020-10-12T21:30:54.000Z",
            "reported_at": "2020-10-12T21:30:53.000Z",
            "raw_headers": "X-Triage-Noise-Reduction: state=0\r\nX-Triage-Noise-Reduction: score=79\r\nX-Triage-Noise-Reduction: vacb1561f9d032089\";\r\n charset=UTF-8\r\nContent-Transfer-Encoding: 7bit",
            "text_body": "Testing<http://dsrihsddk.net/>\r\n\r\nThis is a poor reputation domain\r\n\r\n",
            "html_body": "<html xmlns:v=\"urn:schemas-microsoft-com:vml\" xml>\r\n</div>\r\n</body>\r\n</html>\r\n",
            "md5": "81fe86fc9c244be978ab8b8392d3c986",
            "sha256": "146b857b2a147eeb9091571327452006438294aeb21069e38c6f25a811aa6c03",
            "match_priority": 1,
            "tags": [
                "dsa",
                "asd"
            ],
            "categorization_tags": [],
            "processed_at": null,
            "created_at": "2020-10-12T21:31:36.495Z",
            "updated_at": "2020-11-17T15:33:27.567Z"
        },
        "relationships": {
            "assignee": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/assignee",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/assignee"
                },
                "data": null
            },
            "category": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/category",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/category"
                },
                "data": null
            },
            "cluster": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/cluster",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/cluster"
                },
                "data": {
                    "type": "clusters",
                    "id": "3915"
                }
            },
            "reporter": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/reporter",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/reporter"
                },
                "data": {
                    "type": "reporters",
                    "id": "5331"
                }
            },
            "attachment_payloads": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/attachment_payloads",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/attachment_payloads"
                }
            },
            "attachments": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/attachments",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/attachments"
                }
            },
            "headers": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/headers",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/headers"
                }
            },
            "hostnames": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/hostnames",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/hostnames"
                }
            },
            "urls": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/urls",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/urls"
                }
            },
            "rules": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/rules",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/rules"
                }
            },
            "threat_indicators": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reports/13507/relationships/threat_indicators",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reports/13507/threat_indicators"
                }
            }
        },
        "meta": {
            "risk_score_summary": {
                "integrations": 75,
                "vip": 5,
                "reporter": 15,
                "rules": 1
            }
        }
    }
}

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: if successful(is_success = true): print "Successfully updated category on the the report with ID {0} to {1} in Cofense Triage.".format(report_id, category_name) if unsuccessful aka status code 404(is_success = false): print "Action wasn't able to update the category on the report with ID {0} to {1} in Cofense Triage. Motivo: \n {2}".format(report_id, category_name, errors/detail) L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: stampa "Errore durante l'esecuzione dell'azione "Categorizza report". Motivo: {0}''.format(error.Stacktrace)	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

if successful(is_success = true): print "Successfully updated category on the the report with ID {0} to {1} in Cofense Triage.".format(report_id, category_name)

if unsuccessful aka status code 404(is_success = false): print "Action wasn't able to update the category on the report with ID {0} to {1} in Cofense Triage. Motivo: \n {2}".format(report_id, category_name, errors/detail)

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: stampa "Errore durante l'esecuzione dell'azione "Categorizza report". Motivo: {0}''.format(error.Stacktrace)

Generale

Email di download del report

Descrizione

Scarica l'email non elaborata relativa al report da Cofense Triage.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID report	Stringa	N/D	Sì	Specifica l'ID del report, che contiene l'email non elaborata da scaricare.
Cartella Download	Stringa	N/D	Sì	Specifica il percorso assoluto della cartella di download. Nota: il nome verrà creato nel seguente modo: {report id}.eml.
Sovrascrivi	Casella di controllo	Selezionata	No	Se attivata, l'azione sovrascriverà il file con lo stesso nome e percorso.
Crea approfondimento	Casella di controllo	Deselezionata	No	Se attivata, l'azione creerà un insight che contiene l'email non elaborata del report.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
    "absolute_file_path": "{filepath}"
}

Insight

Nome	Corpo
Report {ID}. Email non elaborata	{content of the response. \n deve essere sostituito con \ }

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: if successful(is_success = true): print "Successfully downloaded raw email related to the report with ID {0} in Cofense Triage.".format(report_id) if unsuccessful aka status code 400(is_success = false): print "Action wasn't able to download raw email related to the report with ID {0} in Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail) L'azione deve non riuscire e interrompere l'esecuzione di un playbook: if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Download Report Email". Motivo: {0}''.format(error.Stacktrace) Se esiste un file con il nome file e la sovrascrittura è false: "Errore durante l'esecuzione dell'azione "Scarica email report". Motivo: esiste già un file con questo percorso. Rimuovilo o imposta "Overwrite" su true."	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

if successful(is_success = true): print "Successfully downloaded raw email related to the report with ID {0} in Cofense Triage.".format(report_id)

if unsuccessful aka status code 400(is_success = false): print "Action wasn't able to download raw email related to the report with ID {0} in Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail)

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Download Report Email". Motivo: {0}''.format(error.Stacktrace)

Se esiste un file con il nome file e la sovrascrittura è false: "Errore durante l'esecuzione dell'azione "Scarica email report". Motivo: esiste già un file con questo percorso. Rimuovilo o imposta "Overwrite" su true."

Generale

Scarica l'anteprima del report

Descrizione

Scarica l'anteprima dell'immagine dall'email relativa al report di Cofense Triage.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID report	Stringa	N/D	Sì	Specifica l'ID del report, che contiene l'email non elaborata da scaricare.
Cartella Download	Stringa	N/D	Sì	Specifica il percorso assoluto della cartella di download. Nota: il nome verrà creato nel seguente modo: {report id}.eml.
Sovrascrivi	Casella di controllo	Selezionata	No	Se attivata, l'azione sovrascriverà il file con lo stesso nome e percorso.
Formato immagine	DDL	PNG Valori possibili: PNG JPG	Sì	Specifica il formato dell'immagine.
Crea approfondimento	Casella di controllo	Deselezionata	No	Se attivata, l'azione creerà un insight che contiene l'email non elaborata del report.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
    "absolute_file_path": "{filepath}"
}

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se l'operazione va a buon fine (is_success=true):"Successfully downloaded preview related to the report with ID {0} in Cofense Triage.".format(report_id) Se l'operazione non va a buon fine, viene visualizzato il codice di stato 400 (is_success=false): "L'azione non è riuscita a scaricare un'anteprima relativa al report con ID {0} in Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail) L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro:"Errore durante l'esecuzione dell'azione "Scarica anteprima report". Motivo: {0}''.format(error.Stacktrace) Se esiste un file con il nome file e la sovrascrittura è false: "Errore durante l'esecuzione dell'azione "Scarica email report". Motivo: esiste già un file con questo percorso. Rimuovilo o imposta "Overwrite" su true."	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se l'operazione va a buon fine (is_success=true):"Successfully downloaded preview related to the report with ID {0} in Cofense Triage.".format(report_id)

Se l'operazione non va a buon fine, viene visualizzato il codice di stato 400 (is_success=false): "L'azione non è riuscita a scaricare un'anteprima relativa al report con ID {0} in Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail)

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro:"Errore durante l'esecuzione dell'azione "Scarica anteprima report". Motivo: {0}''.format(error.Stacktrace)

Generale

Arricchisci URL

Descrizione

Restituisce informazioni sull'URL da Cofense Triage.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
Soglia del punteggio di rischio	Numero intero	50	Sì	Specifica la soglia del punteggio di rischio per Google SecOps per etichettare l'URL come sospetto. Il valore massimo è 100.

Run On

Questa azione viene eseguita sull'entità URL.

Risultati dell'azione

Arricchimento delle entità

Nome del campo di arricchimento	Logica: quando applicare
COFENSE_TRG_id	Se disponibile nel risultato JSON.
COFENSE_TRG_risk_score	Se disponibile nel risultato JSON.
COFENSE_TRG_created_at	Se disponibile nel risultato JSON.
COFENSE_TRG_updated_at	Se disponibile nel risultato JSON.

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
    "data": [
        {
            "id": "1",
            "type": "urls",
            "links": {
                "self": "https://tap.phishmecloud.com/api/public/v2/urls/1"
            },
            "attributes": {
                "url": "https://www.paypal.com/us",
                "risk_score": null,
                "created_at": "2019-04-12T02:58:20.008Z",
                "updated_at": "2019-04-12T02:58:20.008Z"
            },
            "relationships": {
                "hostname": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/urls/1/relationships/hostname",
                        "related": "https://tap.phishmecloud.com/api/public/v2/urls/1/hostname"
                    },
                    "data": {
                        "type": "hostnames",
                        "id": "2"
                    }
                },
                "clusters": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/urls/1/relationships/clusters",
                        "related": "https://tap.phishmecloud.com/api/public/v2/urls/1/clusters"
                    }
                },
                "reports": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/urls/1/relationships/reports",
                        "related": "https://tap.phishmecloud.com/api/public/v2/urls/1/reports"
                    }
                }
            }
        },
        {
            "id": "2",
            "type": "urls",
            "links": {
                "self": "https://tap.phishmecloud.com/api/public/v2/urls/2"
            },
            "attributes": {
                "url": "http://cie.org.mx/leather.php?amount=1qw2f60krdrf8c",
                "risk_score": null,
                "created_at": "2019-04-12T02:58:20.011Z",
                "updated_at": "2019-04-12T02:58:20.011Z"
            },
            "relationships": {
                "hostname": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/urls/2/relationships/hostname",
                        "related": "https://tap.phishmecloud.com/api/public/v2/urls/2/hostname"
                    },
                    "data": {
                        "type": "hostnames",
                        "id": "1"
                    }
                },
                "clusters": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/urls/2/relationships/clusters",
                        "related": "https://tap.phishmecloud.com/api/public/v2/urls/2/clusters"
                    }
                },
                "reports": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/urls/2/relationships/reports",
                        "related": "https://tap.phishmecloud.com/api/public/v2/urls/2/reports"
                    }
                }
            }
        }
    ],
    "links": {
        "first": "https://tap.phishmecloud.com/api/public/v2/urls?filter%5Burl%5D=https%3A%2F%2Fwww.paypal.com%2Fus%2Chttp%3A%2F%2Fcie.org.mx%2Fleather.php%3Famount%3D1qw2f60krdrf8c&page%5Bnumber%5D=1&page%5Bsize%5D=20",
        "last": "https://tap.phishmecloud.com/api/public/v2/urls?filter%5Burl%5D=https%3A%2F%2Fwww.paypal.com%2Fus%2Chttp%3A%2F%2Fcie.org.mx%2Fleather.php%3Famount%3D1qw2f60krdrf8c&page%5Bnumber%5D=1&page%5Bsize%5D=20"
    }
}

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: if successful for at least one URL(is_success = true): print "Successfully enriched the following URLs using Cofense Triage: \n {0}".format(entity.identifier list) if successful for at least one URL(is_success = true): print "Action wasn't able to enrich the following URLs using Cofense Triage: \n {0}".format(entity.identifier list) Se l'arricchimento non va a buon fine per tutte le entità (is_success = false): stampa: "Nessun URL è stato arricchito". L'azione deve non riuscire e interrompere l'esecuzione di un playbook: if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Enrich URL". Motivo: {0}''.format(error.Stacktrace)	Generale
CSV	Campi presenti nella sezione della tabella di arricchimento, ma senza il prefisso "COFENSE_TRG_"	Entità

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

if successful for at least one URL(is_success = true): print "Successfully enriched the following URLs using Cofense Triage: \n {0}".format(entity.identifier list)

if successful for at least one URL(is_success = true): print "Action wasn't able to enrich the following URLs using Cofense Triage: \n {0}".format(entity.identifier list)

Se l'arricchimento non va a buon fine per tutte le entità (is_success = false): stampa: "Nessun URL è stato arricchito".

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Enrich URL". Motivo: {0}''.format(error.Stacktrace)

Generale

CSV

Campi presenti nella sezione della tabella di arricchimento, ma senza il prefisso "COFENSE_TRG_"

Entità

Esegui playbook

Descrizione

Avvia l'esecuzione di un playbook in Cofense Triage.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID report	Stringa	N/D	Sì	Specifica l'ID del report su cui vuoi eseguire il playbook.
Nome playbook	Stringa	N/D	Sì	Specifica il nome del playbook da eseguire.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

N/A

Bacheca casi

Tipo di risultato	Valore/Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se viene segnalato il codice di stato 204 (is_success=true): "Playbook {playbook name} eseguito correttamente sul report {report id} in Cofense Triage." L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se viene fornito un valore non valido per il parametro "Numero massimo di record da restituire": "Errore durante l'esecuzione dell'azione "Esegui playbook". Motivo: {0}''.format(error.Stacktrace)" Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Elenca playbook". Motivo: {0}''.format(error.Stacktrace) Se nella risposta vengono segnalati errori: "Errore durante l'esecuzione dell'azione "Esegui playbook". Motivo: {0}''.format(detail)" Se il playbook non viene trovato: "Errore durante l'esecuzione dell'azione "Esegui playbook". Motivo: il playbook con nome {name} non è stato trovato."	Generale

Tipo di risultato

Valore/Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se viene segnalato il codice di stato 204 (is_success=true): "Playbook {playbook name} eseguito correttamente sul report {report id} in Cofense Triage."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se viene fornito un valore non valido per il parametro "Numero massimo di record da restituire": "Errore durante l'esecuzione dell'azione "Esegui playbook". Motivo: {0}''.format(error.Stacktrace)"

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Elenca playbook". Motivo: {0}''.format(error.Stacktrace)

Se nella risposta vengono segnalati errori: "Errore durante l'esecuzione dell'azione "Esegui playbook". Motivo: {0}''.format(detail)"

Se il playbook non viene trovato: "Errore durante l'esecuzione dell'azione "Esegui playbook". Motivo: il playbook con nome {name} non è stato trovato."

Generale

Recupera dettagli dominio

Descrizione

Restituisce informazioni sul dominio da Cofense Triage.

Parametri

Nome visualizzato del parametro
N/A

Run On

Questa azione viene eseguita sull'entità URL.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
    "data": [
        {
            "id": "1",
            "type": "hostnames",
            "attributes": {
                "hostname": "cie.org.mx",
                "risk_score": null,
                "created_at": "2019-04-12T02:58:19.893Z",
                "updated_at": "2019-04-12T02:58:19.974Z"
            },
            "relationships": {
                "clusters": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/hostnames/1/relationships/clusters",
                        "related": "https://tap.phishmecloud.com/api/public/v2/hostnames/1/clusters"
                    }
                },
                "reports": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/hostnames/1/relationships/reports",
                        "related": "https://tap.phishmecloud.com/api/public/v2/hostnames/1/reports"
                    }
                },
                "urls": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/hostnames/1/relationships/urls",
                        "related": "https://tap.phishmecloud.com/api/public/v2/hostnames/1/urls"
                    }
                }
            }
        },
        {
            "id": "2",
            "type": "hostnames",
            "links": {
                "self": "https://tap.phishmecloud.com/api/public/v2/hostnames/2"
            },
            "attributes": {
                "hostname": "www.paypal.com",
                "risk_score": null,
                "created_at": "2019-04-12T02:58:19.898Z",
                "updated_at": "2019-04-12T02:58:19.965Z"
            },
            "relationships": {
                "clusters": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/hostnames/2/relationships/clusters",
                        "related": "https://tap.phishmecloud.com/api/public/v2/hostnames/2/clusters"
                    }
                },
                "reports": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/hostnames/2/relationships/reports",
                        "related": "https://tap.phishmecloud.com/api/public/v2/hostnames/2/reports"
                    }
                },
                "urls": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/hostnames/2/relationships/urls",
                        "related": "https://tap.phishmecloud.com/api/public/v2/hostnames/2/urls"
                    }
                }
            }
        }
    ],
    "links": {
        "first": "https://tap.phishmecloud.com/api/public/v2/hostnames?filter%5Bhostname%5D=www.paypal.com%2Ccie.org.mx&page%5Bnumber%5D=1&page%5Bsize%5D=20",
        "last": "https://tap.phishmecloud.com/api/public/v2/hostnames?filter%5Bhostname%5D=www.paypal.com%2Ccie.org.mx&page%5Bnumber%5D=1&page%5Bsize%5D=20"
    }
}

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: if successful for at least one URL(is_success = true): print "Successfully returned details about the following domains using Cofense Triage: \n {0}".format(entity.identifier list) Se l'operazione è riuscita per almeno un URL(is_success = true): stampa "L'azione non è riuscita a ottenere dettagli sui seguenti domini utilizzando Cofense Triage: \n {0}".format(entity.identifier list) Se l'arricchimento non va a buon fine per tutte le entità (is_success = false): stampa: "Non sono state trovate informazioni sui domini". L'azione deve non riuscire e interrompere l'esecuzione di un playbook: if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Get Domain Details". Motivo: {0}''.format(error.Stacktrace)	Generale
CSV	Nome tabella:Dettagli del dominio Colonne della tabella: Nome - nome host Punteggio di rischio - risk_score	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

if successful for at least one URL(is_success = true): print "Successfully returned details about the following domains using Cofense Triage: \n {0}".format(entity.identifier list)

Se l'operazione è riuscita per almeno un URL(is_success = true): stampa "L'azione non è riuscita a ottenere dettagli sui seguenti domini utilizzando Cofense Triage: \n {0}".format(entity.identifier list)

Se l'arricchimento non va a buon fine per tutte le entità (is_success = false): stampa: "Non sono state trovate informazioni sui domini".

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Get Domain Details". Motivo: {0}''.format(error.Stacktrace)

Generale

CSV

Nome tabella:Dettagli del dominio

Colonne della tabella:

Nome - nome host

Punteggio di rischio - risk_score

Generale

Scarica le intestazioni del report

Descrizione

Restituisce informazioni sull'intestazione relativa al report di Cofense Triage.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID report	Stringa	N/D	Sì	Specifica l'ID del report per il quale vuoi recuperare le intestazioni.
Numero massimo di intestazioni da restituire	Numero intero	50	No	Specifica il numero di intestazioni da restituire.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
    "data": [
        {
            "id": "4",
            "type": "headers",
            "attributes": {
                "key": "Mime-Version",
                "value": "1.0",
                "created_at": "2020-11-03T16:43:33.767Z",
                "updated_at": "2020-11-03T16:43:33.767Z"
            },
            "relationships": {
                "reports": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/headers/4/relationships/reports",
                        "related": "https://tap.phishmecloud.com/api/public/v2/headers/4/reports"
                    }
                }
            }
        }
    ],
    "links": {
        "first": "https://tap.phishmecloud.com/api/public/v2/reports/13507/headers?page%5Bnumber%5D=1&page%5Bsize%5D=20",
        "last": "https://tap.phishmecloud.com/api/public/v2/reports/13507/headers?page%5Bnumber%5D=1&page%5Bsize%5D=20"
    }
}

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: if successful(is_success = true): print "Successfully returned related headers to the report with ID {0} in Cofense Triage.".format(report_id) if unsuccessful aka status code 404(is_success = false): print "Action wasn't able to return related headers to the report with ID {0} in Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail) Se non vengono trovate regole (is_success = false): stampa: "Non sono state trovate intestazioni correlate al report con ID {0} in Cofense Triage.".format(report_id) L'azione deve non riuscire e interrompere l'esecuzione di un playbook: se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: stampa "Errore durante l'esecuzione dell'azione "Recupera intestazioni report". Motivo: {0}''.format(error.Stacktrace)	Generale
CSV	Nome tabella: intestazioni del report {0} Colonne della tabella: Tasto Nome - Valore - valore	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

if successful(is_success = true): print "Successfully returned related headers to the report with ID {0} in Cofense Triage.".format(report_id)

if unsuccessful aka status code 404(is_success = false): print "Action wasn't able to return related headers to the report with ID {0} in Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail)

Se non vengono trovate regole (is_success = false): stampa: "Non sono state trovate intestazioni correlate al report con ID {0} in Cofense Triage.".format(report_id)

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: stampa "Errore durante l'esecuzione dell'azione "Recupera intestazioni report". Motivo: {0}''.format(error.Stacktrace)

Generale

CSV

Nome tabella: intestazioni del report {0}

Colonne della tabella:

Tasto Nome -

Valore - valore

Generale

Get Report Reporters

Descrizione

Restituisce informazioni sull'autore della segnalazione relative alla segnalazione di Cofense Triage.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID report	Stringa	N/D	Sì	Specifica l'ID del report per il quale vuoi recuperare i reporter.
Numero massimo di autori di report da restituire	Numero intero	50	No	Specifica il numero di reporter da restituire.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

 "data": {
        "id": "5331",
        "type": "reporters",
        "attributes": {
            "email": "user@example.com",
            "reports_count": 277,
            "last_reported_at": "2020-11-06T18:32:47.000Z",
            "reputation_score": 561,
            "vip": true,
            "created_at": "2019-10-24T01:05:28.649Z",
            "updated_at": "2020-11-06T18:33:59.004Z"
        },
        "relationships": {
            "clusters": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reporters/5331/relationships/clusters",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reporters/5331/clusters"
                }
            },
            "reports": {
                "links": {
                    "self": "https://tap.phishmecloud.com/api/public/v2/reporters/5331/relationships/reports",
                    "related": "https://tap.phishmecloud.com/api/public/v2/reporters/5331/reports"
                }
            }
        }
    }
}

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: if successful(is_success = true): print "Successfully returned related reporters to the report with ID {0} in Cofense Triage.".format(report_id) if unsuccessful aka status code 404(is_success = false): print "Action wasn't able to return related reporters to the report with ID {0} in Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail) Se non vengono trovate regole (is_success = false): stampa: "Non sono stati trovati reporter correlati al report con ID {0} in Cofense Triage.".format(report_id) L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: stampa "Errore durante l'esecuzione dell'azione "Recupera autori report". Motivo: {0}''.format(error.Stacktrace)	Generale
CSV	Nome tabella: Report {0} Reporters Colonne della tabella: Email - email Conteggio report - reports_count Punteggio di reputazione - reputation_score VIP - vip	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

if successful(is_success = true): print "Successfully returned related reporters to the report with ID {0} in Cofense Triage.".format(report_id)

if unsuccessful aka status code 404(is_success = false): print "Action wasn't able to return related reporters to the report with ID {0} in Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail)

Se non vengono trovate regole (is_success = false): stampa: "Non sono stati trovati reporter correlati al report con ID {0} in Cofense Triage.".format(report_id)

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: stampa "Errore durante l'esecuzione dell'azione "Recupera autori report". Motivo: {0}''.format(error.Stacktrace)

Generale

CSV

Nome tabella: Report {0} Reporters

Colonne della tabella:

Email - email

Conteggio report - reports_count

Punteggio di reputazione - reputation_score

VIP - vip

Generale

Ottenere i dettagli dell'indicatore di minaccia

Descrizione

Restituisce informazioni sulle entità in base ai dettagli dell'indicatore di minaccia di Cofense Triage.

Parametri

Nome visualizzato del parametro
N/A

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Arricchimento delle entità

Nome del campo di arricchimento	Logica: quando applicare
COFENSE_TRG_ti_id	Se disponibile nel risultato JSON.
COFENSE_TRG_ti_type	Se disponibile nel risultato JSON.
COFENSE_TRG_ti_threat_level	Se disponibile nel risultato JSON.
COFENSE_TRG_ti_threat_source	Se disponibile nel risultato JSON.
COFENSE_TRG_ti_created_at	Se disponibile nel risultato JSON.
COFENSE_TRG_id_updated_at	Se disponibile nel risultato JSON.

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
    "data": [
        {
            "id": "1",
            "type": "threat_indicators",
            "attributes": {
                "threat_level": "Malicious",
                "threat_type": "MD5",
                "threat_value": "f1364ab115332cb44b5d7bb734d2cbf6",
                "threat_source": "Triage-UI",
                "created_at": "2019-06-06T18:55:38.107Z",
                "updated_at": "2020-11-03T16:41:19.972Z"
            },
            "relationships": {
                "reports": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/threat_indicators/1/relationships/reports",
                        "related": "https://tap.phishmecloud.com/api/public/v2/threat_indicators/1/reports"
                    }
                }
            }
        }
}

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: if successful for at least one entity(is_success = true): print "Successfully returned threat indicator details about the following entities using Cofense Triage: \n {0}".format(entity.identifier list) if successful for at least one entity(is_success = true): print "Action wasn't able to return threat indicator details about the following entities using Cofense Triage: \n {0}".format(entity.identifier list) Se l'arricchimento non va a buon fine per tutte le entità (is_success = false): stampa: "Non sono state trovate informazioni sugli indicatori di minaccia relativi alle entità". L'azione deve non riuscire e interrompere l'esecuzione di un playbook: se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: stampa "Errore durante l'esecuzione dell'azione "Recupera dettagli indicatore minaccia". Motivo: {0}''.format(error.Stacktrace)	Generale
CSV	Campi presenti nella sezione della tabella di arricchimento, ma senza il prefisso "COFENSE_TRG_"	Entità

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

if successful for at least one entity(is_success = true): print "Successfully returned threat indicator details about the following entities using Cofense Triage: \n {0}".format(entity.identifier list)

if successful for at least one entity(is_success = true): print "Action wasn't able to return threat indicator details about the following entities using Cofense Triage: \n {0}".format(entity.identifier list)

Se l'arricchimento non va a buon fine per tutte le entità (is_success = false): stampa: "Non sono state trovate informazioni sugli indicatori di minaccia relativi alle entità".

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: stampa "Errore durante l'esecuzione dell'azione "Recupera dettagli indicatore minaccia". Motivo: {0}''.format(error.Stacktrace)

Generale

CSV

Campi presenti nella sezione della tabella di arricchimento, ma senza il prefisso "COFENSE_TRG_"

Entità

Descrizione

Elenca le categorie disponibili in Cofense Triage.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
Nomi	CSV	N/D	No	Specifica un elenco di nomi di categorie separati da virgole. Questo parametro è utile per verificare se esiste una categoria con il nome specificato.
Punteggio più basso da recuperare	Numero intero	N/D	No	Specifica il punteggio minimo accettato per la categoria. Questo parametro può funzionare con valori negativi.
Solo dannoso	Casella di controllo	Deselezionata	No	Se abilitata, l'azione restituisce solo le categorie dannose.
Solo archiviati	Casella di controllo	Deselezionata	No	Se l'opzione è abilitata, l'azione restituisce solo le categorie archiviate.
Solo non archiviati	Casella di controllo	Deselezionata	No	Se abilitata, l'azione restituisce solo le categorie non archiviate.
Solo non dannosi	Casella di controllo	Deselezionata	No	Se abilitata, l'azione restituisce solo categorie non dannose.
Numero massimo di categorie da restituire	Numero intero	N/D	No	Specifica il numero di categorie da restituire.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
    "data": [
        {
            "id": "1",
            "type": "categories",
            "links": {
                "self": "https://tap.phishmecloud.com/api/public/v2/categories/1"
            },
            "attributes": {
                "name": "Non-Malicious",
                "score": -5,
                "malicious": false,
                "color": "#739d75",
                "archived": false,
                "created_at": "2019-04-11T08:24:49.787Z",
                "updated_at": "2019-11-12T19:15:37.849Z"
            },
            "relationships": {
                "one_clicks": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/categories/1/relationships/one_clicks",
                        "related": "https://tap.phishmecloud.com/api/public/v2/categories/1/one_clicks"
                    }
                },
                "reports": {
                    "links": {
                        "self": "https://tap.phishmecloud.com/api/public/v2/categories/1/relationships/reports",
                        "related": "https://tap.phishmecloud.com/api/public/v2/categories/1/reports"
                    }
                }
            }
        }
    ],
    "links": {
        "first": "https://tap.phishmecloud.com/api/public/v2/categories?filter%5Barchived%5D=false&filter%5Bmalicious%5D=false&filter%5Bname%5D=Non-Malicious&filter%5Bscore_gteq%5D=-5&page%5Bnumber%5D=1&page%5Bsize%5D=20",
        "last": "https://tap.phishmecloud.com/api/public/v2/categories?filter%5Barchived%5D=false&filter%5Bmalicious%5D=false&filter%5Bname%5D=Non-Malicious&filter%5Bscore_gteq%5D=-5&page%5Bnumber%5D=1&page%5Bsize%5D=20"
    }
}

Bacheca casi

Tipo di risultato	Valore/Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se l'operazione ha esito positivo (is_success=true): "Successfully returned available categories from Cofense Triage." (Restituzione riuscita delle categorie disponibili da Cofense Triage.) Se non vengono trovate categorie (is_success=false) "Nessuna categoria trovata per i criteri." L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Elenca categorie". Motivo: {0}''.format(error.Stacktrace)	Generale
Tabella Bacheca casi	Nome tabella: Available Categories Colonna della tabella: Nome - nome Punteggio - punteggio ID - id Dannoso - dannoso Archiviata - Archiviata	Generale

Tipo di risultato

Valore/Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se l'operazione ha esito positivo (is_success=true): "Successfully returned available categories from Cofense Triage." (Restituzione riuscita delle categorie disponibili da Cofense Triage.)

Se non vengono trovate categorie (is_success=false) "Nessuna categoria trovata per i criteri."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Elenca categorie". Motivo: {0}''.format(error.Stacktrace)

Generale

Tabella Bacheca casi

Nome tabella: Available Categories

Colonna della tabella:

Nome - nome
Punteggio - punteggio
ID - id
Dannoso - dannoso
Archiviata - Archiviata

Generale

Elenca playbook

Descrizione

Elenca i playbook disponibili in Cofense Triage.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
Chiave di filtro	DDL	Selezionane uno Valori possibili: Nome Descrizione	No	Specifica la chiave da utilizzare per filtrare i playbook.
Logica di filtro	DDL	Non specificato Valori possibili: Non specificato Uguale Contiene	No	Specifica il tipo di logica di filtro da applicare. La logica di filtraggio funziona in base al valore fornito nel parametro "Chiave filtro". Nota: la logica "Uguale a" fa distinzione tra maiuscole e minuscole, mentre "Contiene" non fa distinzione tra maiuscole e minuscole.
Valore filtro	Stringa	N/D	No	Specifica il valore da utilizzare nel filtro. Se è selezionato "Uguale", l'azione tenta di trovare la corrispondenza esatta tra i risultati. Se è selezionato "Contiene", l'azione tenta di trovare risultati che contengano quella sottostringa. Se non viene fornito alcun valore in questo parametro, il filtro non viene applicato. La logica di filtraggio funziona in base al valore fornito nel parametro "Chiave filtro".
Numero massimo di record da restituire	Numero intero	50	No	Specifica il numero di record da restituire. Se non viene fornito nulla, l'azione restituisce 50 record. Massimo: 200

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

[
        {
            "id": "1",
            "type": "playbooks",
            "links": {
                "self": "https://reltest6.phishmecloud.com/api/public/v2/playbooks/1"
            },
            "attributes": {
                "name": "SN_Test",
                "description": "",
                "active": true,
                "button_color": "#204d74",
                "add_rule_tags_to_report_tags": true,
                "remove_existing_report_tags": false,
                "remove_existing_cluster_tags": false,
                "report_tags": [
                    "SN_Test"
                ],
                "cluster_tags": [
                    "SN_Cluster_Test",
                    "test1"
                ],
                "delete_report": false,
                "guid": "b443a844-ffc2-49d2-8903-1a5f7fde7526",
                "created_at": "2021-05-28T01:29:22.080Z",
                "updated_at": "2022-04-08T06:04:17.016Z"
            }
        }
]

Bacheca casi

Tipo di risultato	Valore/Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se i dati sono disponibili (is_success=true): "Successfully found playbooks for the provided criteria in Cofense Triage." Se i dati non sono disponibili (is_success=false): "Non sono stati trovati playbook per i criteri forniti in Cofense Triage". Se il parametro "Valore filtro" è vuoto (is_success=true): "Il filtro non è stato applicato perché il parametro "Valore filtro" ha un valore vuoto." Se il parametro "Logica di filtro" è impostato su "Non specificato" (is_success=true): "Il filtro non è stato applicato perché il parametro "Logica di filtro" non è specificato." L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se il parametro "Chiave filtro" è impostato su "Seleziona uno" e il parametro "Logica filtro" è impostato su "Uguale a" o "Contiene": "Errore durante l'esecuzione dell'azione "{nome azione}". Motivo: devi selezionare un campo dal parametro "Chiave filtro". Se viene fornito un valore non valido per il parametro "Numero massimo di record da restituire": "Errore durante l'esecuzione dell'azione "{nome azione}". Motivo: "È stato fornito un valore non valido per "Numero massimo di record da restituire": . Deve essere fornito un numero positivo"." Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Elenca playbook". Motivo: {0}''.format(error.Stacktrace)	Generale
Tabella Bacheca casi	Nome tabella:Available Playbooks Colonna della tabella: Nome - nome Attivo - attivo ID - id Descrizione - description Tag: file CSV di report_tags + cluster_tags Data di creazione - created_at	Generale

Tipo di risultato

Valore/Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se i dati sono disponibili (is_success=true): "Successfully found playbooks for the provided criteria in Cofense Triage."

Se i dati non sono disponibili (is_success=false): "Non sono stati trovati playbook per i criteri forniti in Cofense Triage".

Se il parametro "Valore filtro" è vuoto (is_success=true): "Il filtro non è stato applicato perché il parametro "Valore filtro" ha un valore vuoto."

Se il parametro "Logica di filtro" è impostato su "Non specificato" (is_success=true): "Il filtro non è stato applicato perché il parametro "Logica di filtro" non è specificato."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se il parametro "Chiave filtro" è impostato su "Seleziona uno" e il parametro "Logica filtro" è impostato su "Uguale a" o "Contiene": "Errore durante l'esecuzione dell'azione "{nome azione}". Motivo: devi selezionare un campo dal parametro "Chiave filtro".

Se viene fornito un valore non valido per il parametro "Numero massimo di record da restituire": "Errore durante l'esecuzione dell'azione "{nome azione}". Motivo: "È stato fornito un valore non valido per "Numero massimo di record da restituire": . Deve essere fornito un numero positivo"."

Generale

Tabella Bacheca casi

Nome tabella:Available Playbooks

Colonna della tabella:

Nome - nome
Attivo - attivo
ID - id
Descrizione - description
Tag: file CSV di report_tags + cluster_tags
Data di creazione - created_at

Generale

Elenco dei report correlati agli indicatori di minaccia

Descrizione

Elenca i report relativi agli indicatori di minaccia in Cofense Triage.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
Crea tabella Case Wall	Casella di controllo	Deselezionata	No	Se attivata, l'azione creerà una tabella della bacheca delle richieste con informazioni sui report.
Numero massimo di report da restituire	Numero intero	100	No	Specifica il numero di report da restituire.

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

 {
    "reports": [
        {
            "id": "13219",
            "type": "reports",
            "links": {
                "self": "https://tap.phishmecloud.com/api/public/v2/reports/13219"
            },
            "attributes": {
                "location": "Inbox",
                "risk_score": null,
                "from_address": null,
                "subject": "Delivery reports about your e-mail",
                "received_at": "2019-05-17T01:25:07.642Z",
                "reported_at": "2019-05-16T23:01:50.000Z",
                "raw_headers": "Date: Fri, 17 May 2019 01:25:07 +0000\r\nMessage-ID: <5cde0d73994b2_10902aea1885332418512@ip-10-132-9-226.ec2.internal.mail>\r\nSubject: Delivery reports about your e-mail\r\nMime-Version: 1.0\r\nContent-Type: multipart/mixed;\r\n boundary=\"--==_mimepart_5cde0d7399130_10902aea18853324184a7\";\r\n charset=UTF-8\r\nContent-Transfer-Encoding: 7bit",
                "md5": "3e4c2e6e85695569ae7a11aac8a774c6",
                "sha256": "1434d565d7735a841f39cb953cfdbbba1d0793324900d42c25b212b454a77993",
                "match_priority": 4,
                "tags": [],
                "categorization_tags": [],
                "processed_at": null,
                "created_at": "2019-05-17T01:25:07.652Z",
                "updated_at": "2019-05-17T01:25:10.032Z"
            },
            "meta": {
                "risk_score_summary": null
            }
        },
        {
            "id": "13227",
            "type": "reports",
            "links": {
                "self": "https://tap.phishmecloud.com/api/public/v2/reports/13227"
            },
            "attributes": {
                "location": "Inbox",
                "risk_score": null,
                "from_address": null,
                "subject": "Delivery reports about your e-mail",
                "received_at": "2019-05-17T14:53:54.318Z",
                "reported_at": "2019-05-16T23:01:50.000Z",
                "raw_headers": "Date: Fri, 17 May 2019 14:53:54 +0000\r\nMessage-ID: <5cdecb024a663_107f2b040f2cd3306399@ip-10-132-9-226.ec2.internal.mail>\r\nSubject: Delivery reports about your e-mail\r\nMime-Version: 1.0\r\nContent-Type: multipart/mixed;\r\n boundary=\"--==_mimepart_5cdecb024a2fd_107f2b040f2cd3306387b\";\r\n charset=UTF-8\r\nContent-Transfer-Encoding: 7bit",
                "md5": "92bb365c3fe712216610e884621c771a",
                "sha256": "da37a508cd47987e9989fc8a2af12352c6652fa5c421f4556ef6a198bf73821e",
                "match_priority": 4,
                "tags": [],
                "categorization_tags": [],
                "processed_at": null,
                "created_at": "2019-05-17T14:53:54.327Z",
                "updated_at": "2019-05-17T14:53:56.453Z"
            },
            "meta": {
                "risk_score_summary": null
            }
        }
    ],
}

Bacheca casi

Tipo di risultato	Valore/Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se l'operazione ha esito positivo: "Successfully returned reports related to provided entities from Cofense Triage." Se non vengono trovati report: "No related reports were found for the provided entities". L'azione deve non riuscire e interrompere l'esecuzione di un playbook: if fatal error, like wrong credentials, no connection to server, other: "Error executing action "List Reports Related To Threat Indicators". Motivo: (error.Stacktrace)	Generale
Tabella Bacheca casi	Nome tabella:report correlati Colonna della tabella: ID Oggetto Ora di creazione: Località	Generale

Tipo di risultato

Valore/Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se l'operazione ha esito positivo: "Successfully returned reports related to provided entities from Cofense Triage."
Se non vengono trovati report: "No related reports were found for the provided entities".

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, like wrong credentials, no connection to server, other: "Error executing action "List Reports Related To Threat Indicators". Motivo: (error.Stacktrace)

Generale

Tabella Bacheca casi

Nome tabella:report correlati

Colonna della tabella:

Oggetto

Ora di creazione:

Località

Generale

Dindin

Descrizione

Testa la connettività a Cofense Triage con i parametri forniti nella pagina di configurazione dell'integrazione nella scheda Google Security Operations Marketplace.

Parametri

N/D

Run On

Questa azione non viene eseguita sulle entità e non ha parametri di input obbligatori.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se l'operazione va a buon fine: "Connessione al server Cofense Triage riuscita con i parametri di connessione forniti." L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook: Se non riesci: "Impossibile connettersi al server Cofense Triage. Error is {0}".format(exception.stacktrace)	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se l'operazione va a buon fine: "Connessione al server Cofense Triage riuscita con i parametri di connessione forniti."

L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook:

Se non riesci: "Impossibile connettersi al server Cofense Triage. Error is {0}".format(exception.stacktrace)

Generale

Connettore

Cofense Triage - Connettore report

Estrai i report da Cofense Triage.

Configurare Cofense Triage - Reports Connector in Google SecOps

Per istruzioni dettagliate su come configurare un connettore in Google SecOps, vedi Configurazione del connettore.

Parametri del connettore

Utilizza i seguenti parametri per configurare il connettore:

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio<	Descrizione
Nome campo prodotto	Stringa	Nome prodotto	Sì	Inserisci il nome del campo di origine per recuperare il nome del campo prodotto.
Nome campo evento	Stringa	località	Sì	Inserisci il nome del campo di origine per recuperare il nome del campo evento.
Nome campo ambiente	Stringa	""	No	Descrive il nome del campo in cui è memorizzato il nome dell'ambiente. Se il campo dell'ambiente non viene trovato, l'ambiente è quello predefinito.
Pattern regex ambiente	Stringa	.*	No	Un pattern regex da eseguire sul valore trovato nel campo "Nome campo ambiente". Il valore predefinito è .* per acquisire tutto e restituire il valore invariato. Utilizzato per consentire all'utente di manipolare il campo dell'ambiente tramite la logica delle espressioni regolari. Se il pattern regex è null o vuoto oppure il valore dell'ambiente è null, il risultato finale dell'ambiente è l'ambiente predefinito.
Timeout dello script (secondi)	Numero intero	180	Sì	Limite di timeout per il processo Python che esegue lo script corrente.
Root API	Stringa	https://tap.phishmecloud.com	Sì	Radice dell'API dell'istanza di Cofense Triage.
ID client	Stringa	N/D	Sì	ID client dell'account Cofense Triage.
Client secret	Password	N/D	Sì	Client secret dell'account Cofense Triage.
Punteggio di rischio più basso da recuperare	Numero intero	0	Sì	Il punteggio di rischio più basso che verrà utilizzato per recuperare le email. Il valore massimo è 100.
Recupero ore massime a ritroso	Numero intero	1	No	Quantità di ore da cui recuperare le email.
Numero massimo di report da recuperare	Numero intero	10	No	Il numero di report da elaborare per ogni iterazione del connettore.
Utilizzare la lista consentita come lista nera	Casella di controllo	Deselezionata	Sì	Se questa opzione è abilitata, la lista consentita verrà utilizzata come lista bloccata.
Verifica SSL	Casella di controllo	Deselezionata	Sì	Se abilitato, verifica che il certificato SSL per la connessione al server Cofense Triage sia valido.
Indirizzo del server proxy	Stringa	N/D	No	L'indirizzo del server proxy da utilizzare.
Nome utente proxy	Stringa	N/D	No	Il nome utente del proxy con cui eseguire l'autenticazione.
Password proxy	Password	N/D	No	La password del proxy per l'autenticazione.

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