Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Cofense Triage

En este documento, se describe cómo integrar Cofense Triage con Google Security Operations.

Casos de uso

Transferir informes de Cofense Triage y usarlos para crear alertas de Google Security Operations A continuación, en Google SecOps, las alertas se pueden usar para realizar orquestaciones con guías o análisis manuales.
Enriquecimiento de las entidades relacionadas y detalles sobre el informe.
Clasificación del informe

Configura la integración de Cofense Triage en Google SecOps

Si quieres obtener instrucciones detalladas para configurar una integración en Google SecOps, consulta Configura integraciones.

Parámetros de integración

Usa los siguientes parámetros para configurar la integración:

Nombre visible del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
Raíz de la API	String	https://tap.phishmecloud.com	N/A	Es la raíz de la API de la instancia de Cofense Triage.
ID de cliente	String	N/A	Sí	Es el ID de cliente de la cuenta de Cofense Triage.
Secreto del cliente	Contraseña	N/A	Sí	Es el secreto del cliente de la cuenta de Cofense Triage.
Verificar SSL	Casilla de verificación	Desmarcado	Sí	Si se habilita, se verifica que el certificado SSL para la conexión con el servidor de Cofense Triage sea válido.

Acciones

Agrega etiquetas al informe

Descripción

Agrega etiquetas a un informe en Cofense Triage.

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID del informe	String	N/A	Sí	Especifica el ID del informe al que quieres agregar etiquetas.
Etiquetas	CSV	N/A	Sí	Especifica una lista separada por comas de las etiquetas que se deben aplicar al informe.

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero o falso	is_success:False

Resultado de 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
            }
        }
    }
}

Muro de casos

Tipo de resultado	Valor / Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: if successful(is_success = true): print "Successfully added tags to the the report with ID {0} in Cofense Triage.".format(report_id) Si no se realiza correctamente, es decir, el código de estado es 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) La acción debería fallar y detener la ejecución de una guía: if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Add Tags To Report". Reason: {0}''.format(error.Stacktrace)	General

Tipo de resultado

Valor / Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

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

Si no se realiza correctamente, es decir, el código de estado es 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)

La acción debería fallar y detener la ejecución de una guía:

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

General

Informe de categorización

Descripción

Categorizar un informe en Cofense Triage

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID del informe	String	N/A	Sí	Especifica el ID del informe al que quieres agregar etiquetas.
Nombre de la categoría	String	N/A	Sí	Especifica el nombre de la categoría que se debe aplicar al informe. Las categorías disponibles se pueden encontrar en la acción "List Categories".

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero o falso	is_success:False

Resultado de 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
            }
        }
    }
}

Muro de casos

Tipo de resultado	Valor / Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: 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) Si no se realiza correctamente, es decir, si el código de estado es 404(is_success = false): Imprime "Action wasn't able to update the category on the report with ID {0} to {1} in Cofense Triage. Reason: \n {2}".format(report_id, category_name, errors/detail) La acción debería fallar y detener la ejecución de una guía: if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Categorize Report". Reason: {0}''.format(error.Stacktrace)	General

Tipo de resultado

Valor / Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

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)

Si no se realiza correctamente, es decir, si el código de estado es 404(is_success = false): Imprime "Action wasn't able to update the category on the report with ID {0} to {1} in Cofense Triage. Reason: \n {2}".format(report_id, category_name, errors/detail)

La acción debería fallar y detener la ejecución de una guía:

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

General

Correo electrónico para descargar el informe

Descripción

Descarga el correo electrónico sin procesar relacionado con el informe de Cofense Triage.

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID del informe	String	N/A	Sí	Especifica el ID del informe, que contiene el correo electrónico sin procesar que se debe descargar.
Descargar carpeta	String	N/A	Sí	Especifica la ruta de acceso absoluta a la carpeta de descarga. Nota: El nombre se construirá de la siguiente manera: {ID del informe}.eml.
Reemplazar	Casilla de verificación	Marcado	No	Si se habilita, la acción reemplazará el archivo con el mismo nombre y la misma ruta de acceso.
Crea estadísticas	Casilla de verificación	Desmarcado	No	Si se habilita, la acción creará una estadística que contendrá el correo electrónico sin procesar del informe.

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero o falso	is_success:False

Resultado de JSON

{
    "absolute_file_path": "{filepath}"
}

Estadística

Nombre	Cuerpo
Informe {ID}. Correo electrónico sin procesar	{contenido de la respuesta. \n se debe reemplazar por \ }

Muro de casos

Tipo de resultado	Valor / Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: 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) La acción debería fallar y detener la ejecución de una guía: if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Download Report Email". Motivo: {0}''.format(error.Stacktrace) Si el archivo con el nombre de archivo existe y el reemplazo es falso: "Error executing action "Download Report Email". Motivo: Ya existe un archivo con esa ruta de acceso. Quítalo o establece "Reemplazar" como verdadero".	General

Tipo de resultado

Valor / Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

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)

La acción debería fallar y detener la ejecución de una guía:

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

Si el archivo con el nombre de archivo existe y el reemplazo es falso: "Error executing action "Download Report Email". Motivo: Ya existe un archivo con esa ruta de acceso. Quítalo o establece "Reemplazar" como verdadero".

General

Descargar vista previa del informe

Descripción

Descarga la vista previa de la imagen del correo electrónico relacionado con el informe de Cofense Triage.

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID del informe	String	N/A	Sí	Especifica el ID del informe, que contiene el correo electrónico sin procesar que se debe descargar.
Descargar carpeta	String	N/A	Sí	Especifica la ruta de acceso absoluta a la carpeta de descarga. Nota: El nombre se construirá de la siguiente manera: {ID del informe}.eml.
Reemplazar	Casilla de verificación	Marcado	No	Si se habilita, la acción reemplazará el archivo con el mismo nombre y la misma ruta de acceso.
Formato de imagen	DDL	PNG Valores posibles: PNG JPG	Sí	Especifica el formato de la imagen.
Crea estadísticas	Casilla de verificación	Desmarcado	No	Si se habilita, la acción creará una estadística que contendrá el correo electrónico sin procesar del informe.

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero o falso	is_success:False

Resultado de JSON

{
    "absolute_file_path": "{filepath}"
}

Muro de casos

Tipo de resultado	Valor / Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: Si se realiza correctamente (is_success=true):"Successfully downloaded preview related to the report with ID {0} in Cofense Triage.".format(report_id) Si no se realiza correctamente, se muestra el código de estado 400 (is_success=false): "La acción no pudo descargar una vista previa relacionada con el informe con el ID {0} en Cofense Triage. Reason: \n {1}".format(report_id, errors/detail) La acción debería fallar y detener la ejecución de una guía: Si se informa un error grave, como credenciales incorrectas, falta de conexión al servidor, entre otros:"Error al ejecutar la acción "Descargar vista previa del informe". Reason: {0}''.format(error.Stacktrace) Si el archivo con el nombre de archivo existe y el reemplazo es falso: "Error executing action "Download Report Email". Motivo: Ya existe un archivo con esa ruta de acceso. Quítalo o establece "Reemplazar" como verdadero".	General

Tipo de resultado

Valor / Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se realiza correctamente (is_success=true):"Successfully downloaded preview related to the report with ID {0} in Cofense Triage.".format(report_id)

Si no se realiza correctamente, se muestra el código de estado 400 (is_success=false): "La acción no pudo descargar una vista previa relacionada con el informe con el ID {0} en Cofense Triage. Reason: \n {1}".format(report_id, errors/detail)

La acción debería fallar y detener la ejecución de una guía:

Si se informa un error grave, como credenciales incorrectas, falta de conexión al servidor, entre otros:"Error al ejecutar la acción "Descargar vista previa del informe". Reason: {0}''.format(error.Stacktrace)

General

URL de enriquecimiento

Descripción

Devuelve información sobre la URL de Cofense Triage.

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
Umbral de puntuación de riesgo	Número entero	50	Sí	Especifica cuál debe ser el umbral de puntuación de riesgo para que Google SecOps etiquete esa URL como sospechosa. El máximo es 100.

Ejecutar en

Esta acción se ejecuta en la entidad de URL.

Resultados de la acción

Enriquecimiento de entidades

Nombre del campo de enriquecimiento	Lógica: Cuándo aplicar
COFENSE_TRG_id	Si está disponible en el resultado de JSON.
COFENSE_TRG_risk_score	Si está disponible en el resultado de JSON.
COFENSE_TRG_created_at	Si está disponible en el resultado de JSON.
COFENSE_TRG_updated_at	Si está disponible en el resultado de JSON.

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero o falso	is_success:False

Resultado de 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"
    }
}

Muro de casos

Tipo de resultado	Valor / Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: 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) Si no se enriquecen todas las entidades (is_success = false): Imprime: "No URLs were enriched." La acción debería fallar y detener la ejecución de una guía: if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Enrich URL". Reason: {0}''.format(error.Stacktrace)	General
CSV	Campos que se encuentran en la sección de la tabla de enriquecimiento, pero sin el prefijo "COFENSE_TRG_"	Entidad

Tipo de resultado

Valor / Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

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)

Si no se enriquecen todas las entidades (is_success = false): Imprime: "No URLs were enriched."

La acción debería fallar y detener la ejecución de una guía:

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

General

CSV

Campos que se encuentran en la sección de la tabla de enriquecimiento, pero sin el prefijo "COFENSE_TRG_"

Entidad

Ejecutar guía

Descripción

Inicia la ejecución de una guía en Cofense Triage.

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID del informe	String	N/A	Sí	Especifica el ID del informe en el que deseas ejecutar la guía.
Nombre de la guía	String	N/A	Sí	Especifica el nombre de la guía que se debe ejecutar.

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero o falso	is_success:False

Resultado de JSON

N/A

Muro de casos

Tipo de resultado	Valor/Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: Si se informa el código de estado 204 (is_success=true): "Successfully executed playbook {playbook name} on report {report id} in Cofense Triage." La acción debería fallar y detener la ejecución de una guía: Si se proporciona un valor no válido para el parámetro "Max Records to Return": "Error executing action "Execute Playbook". Motivo: {0}''.format(error.Stacktrace)" Si se informa un error grave, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error executing action "List Playbooks". Reason: {0}''.format(error.Stacktrace) Si se informan errores en la respuesta: "Error al ejecutar la acción "Ejecutar guía". Reason: {0}''.format(detail)" Si no se encuentra la guía, se mostrará el mensaje "Error executing action "Execute Playbook". Motivo: No se encontró la guía con el nombre {name}."	General

Tipo de resultado

Valor/Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se informa el código de estado 204 (is_success=true): "Successfully executed playbook {playbook name} on report {report id} in Cofense Triage."

La acción debería fallar y detener la ejecución de una guía:

Si se proporciona un valor no válido para el parámetro "Max Records to Return": "Error executing action "Execute Playbook". Motivo: {0}''.format(error.Stacktrace)"

Si se informa un error grave, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error executing action "List Playbooks". Reason: {0}''.format(error.Stacktrace)

Si se informan errores en la respuesta: "Error al ejecutar la acción "Ejecutar guía". Reason: {0}''.format(detail)"

Si no se encuentra la guía, se mostrará el mensaje "Error executing action "Execute Playbook". Motivo: No se encontró la guía con el nombre {name}."

General

Obtén detalles del dominio

Descripción

Devuelve información sobre el dominio de Cofense Triage.

Parámetros

Nombre visible del parámetro
N/A

Ejecutar en

Esta acción se ejecuta en la entidad de URL.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero o falso	is_success:False

Resultado de 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"
    }
}

Muro de casos

Tipo de resultado	Valor / Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: 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) if successful for at least one URL(is_success = true): print "Action wasn't able to get details about the following domains using Cofense Triage: \n {0}".format(entity.identifier list) Si no se puede enriquecer para todas las entidades (is_success = false): Imprime: "No information about the domains was found." La acción debería fallar y detener la ejecución de una guía: if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Get Domain Details". Reason: {0}''.format(error.Stacktrace)	General
CSV	Nombre de la tabla: Detalles del dominio Columnas de la tabla: Nombre: nombre de host Puntuación de riesgo: risk_score	General

Tipo de resultado

Valor / Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

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)

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

Si no se puede enriquecer para todas las entidades (is_success = false): Imprime: "No information about the domains was found."

La acción debería fallar y detener la ejecución de una guía:

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

General

CSV

Nombre de la tabla: Detalles del dominio

Columnas de la tabla:

Nombre: nombre de host

Puntuación de riesgo: risk_score

General

Obtener encabezados de informes

Descripción

Devuelve información sobre el encabezado relacionado con el informe de Cofense Triage.

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID del informe	String	N/A	Sí	Especifica el ID del informe del que quieres recuperar los encabezados.
Cantidad máxima de encabezados que se devolverán	Número entero	50	No	Especifica cuántos encabezados se deben devolver.

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero o falso	is_success:False

Resultado de 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"
    }
}

Muro de casos

Tipo de resultado	Valor / Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: 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) Si no se encuentran reglas (is_success = false): Imprime: "No related headers were found to the report with ID {0} in Cofense Triage.".format(report_id) La acción debería fallar y detener la ejecución de una guía: if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Get Report Headers". Reason: {0}''.format(error.Stacktrace)	General
CSV	Nombre de la tabla: Encabezados del informe {0} Columnas de la tabla: Nombre: clave Valor - valor	General

Tipo de resultado

Valor / Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

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)

Si no se encuentran reglas (is_success = false): Imprime: "No related headers were found to the report with ID {0} in Cofense Triage.".format(report_id)

La acción debería fallar y detener la ejecución de una guía:

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

General

CSV

Nombre de la tabla: Encabezados del informe {0}

Columnas de la tabla:

Nombre: clave

Valor - valor

General

Obtén los denunciantes de un informe

Descripción

Devuelve información sobre el informante relacionada con el informe de Cofense Triage.

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID del informe	String	N/A	Sí	Especifica el ID del informe del que quieres recuperar los denunciantes.
Cantidad máxima de informantes que se devolverán	Número entero	50	No	Especifica cuántos informantes se deben mostrar.

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero o falso	is_success:False

Resultado de 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"
                }
            }
        }
    }
}

Muro de casos

Tipo de resultado	Valor / Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: 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) Si no se encuentran reglas (is_success = false): Imprime: "No related reporters were found to the report with ID {0} in Cofense Triage.".format(report_id) La acción debería fallar y detener la ejecución de una guía: if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Get Report Reporters". Reason: {0}''.format(error.Stacktrace)	General
CSV	Nombre de la tabla: Denunciantes del informe {0} Columnas de la tabla: Correo electrónico: correo electrónico Recuento de informes: reports_count Puntuación de reputación: reputation_score VIP: vip	General

Tipo de resultado

Valor / Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

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)

Si no se encuentran reglas (is_success = false): Imprime: "No related reporters were found to the report with ID {0} in Cofense Triage.".format(report_id)

La acción debería fallar y detener la ejecución de una guía:

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

General

CSV

Nombre de la tabla: Denunciantes del informe {0}

Columnas de la tabla:

Correo electrónico: correo electrónico

Recuento de informes: reports_count

Puntuación de reputación: reputation_score

VIP: vip

General

Obtén detalles de los indicadores de amenazas

Descripción

Muestra información sobre las entidades según los detalles del indicador de amenazas de Cofense Triage.

Parámetros

Nombre visible del parámetro
N/A

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Enriquecimiento de entidades

Nombre del campo de enriquecimiento	Lógica: Cuándo aplicar
COFENSE_TRG_ti_id	Si está disponible en el resultado de JSON.
COFENSE_TRG_ti_type	Si está disponible en el resultado de JSON.
COFENSE_TRG_ti_threat_level	Si está disponible en el resultado de JSON.
COFENSE_TRG_ti_threat_source	Si está disponible en el resultado de JSON.
COFENSE_TRG_ti_created_at	Si está disponible en el resultado de JSON.
COFENSE_TRG_id_updated_at	Si está disponible en el resultado de JSON.

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero o falso	is_success:False

Resultado de 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"
                    }
                }
            }
        }
}

Muro de casos

Tipo de resultado	Valor / Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: 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) Si no se puede enriquecer para todas las entidades (is_success = false): Imprime: "No threat indicator information about the entities was found." La acción debería fallar y detener la ejecución de una guía: if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Get Threat Indicator Details". Reason: {0}''.format(error.Stacktrace)	General
CSV	Campos que se encuentran en la sección de la tabla de enriquecimiento, pero sin el prefijo "COFENSE_TRG_"	Entidad

Tipo de resultado

Valor / Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

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)

Si no se puede enriquecer para todas las entidades (is_success = false): Imprime: "No threat indicator information about the entities was found."

La acción debería fallar y detener la ejecución de una guía:

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

General

CSV

Campos que se encuentran en la sección de la tabla de enriquecimiento, pero sin el prefijo "COFENSE_TRG_"

Entidad

Descripción

Enumera las categorías disponibles en Cofense Triage.

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
Nombres	CSV	N/A	No	Especifica una lista de nombres de categorías separados por comas. Este parámetro es útil para verificar si existe una categoría con el nombre especificado.
Puntuación más baja que se recuperará	Número entero	N/A	No	Especifica la puntuación más baja aceptada para la categoría. Este parámetro puede funcionar con valores negativos.
Solo malicioso	Casilla de verificación	Desmarcado	No	Si está habilitada, la acción solo devuelve categorías maliciosas.
Solo archivados	Casilla de verificación	Desmarcado	No	Si está habilitada, la acción solo devuelve las categorías archivadas.
Solo no archivados	Casilla de verificación	Desmarcado	No	Si se habilita, la acción solo devuelve categorías no archivadas.
Solo no malicioso	Casilla de verificación	Desmarcado	No	Si se habilita, la acción solo devuelve categorías no maliciosas.
Cantidad máxima de categorías que se devolverán	Número entero	N/A	No	Especifica la cantidad de categorías que se devolverán.

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero o falso	is_success:False

Resultado de 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"
    }
}

Muro de casos

Tipo de resultado	Valor/Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: Si se ejecuta correctamente (is_success=true): "Successfully returned available categories from Cofense Triage." Si no se encuentran categorías (is_success=false) "No categories were found for the criteria." La acción debería fallar y detener la ejecución de una guía: Si se informa un error grave, como credenciales incorrectas, falta de conexión al servidor, entre otros: "Error al ejecutar la acción "Listar categorías". Reason: {0}''.format(error.Stacktrace)	General
Tabla del muro de casos	Nombre de la tabla: Available Categories Columna de la tabla: Nombre - nombre Score - score ID - id Malicioso: Malicioso Archivado: archivado	General

Tipo de resultado

Valor/Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se ejecuta correctamente (is_success=true): "Successfully returned available categories from Cofense Triage."

Si no se encuentran categorías (is_success=false) "No categories were found for the criteria."

La acción debería fallar y detener la ejecución de una guía:

Si se informa un error grave, como credenciales incorrectas, falta de conexión al servidor, entre otros: "Error al ejecutar la acción "Listar categorías". Reason: {0}''.format(error.Stacktrace)

General

Tabla del muro de casos

Nombre de la tabla: Available Categories

Columna de la tabla:

Nombre - nombre
Score - score
ID - id
Malicioso: Malicioso
Archivado: archivado

General

Guías de listas

Descripción

Enumera las guías disponibles en Cofense Triage.

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
Clave de filtro	DDL	Selecciona una opción Valores posibles: Nombre Descripción	No	Especifica la clave que se debe usar para filtrar las guías.
Lógica de filtrado	DDL	No especificado Valores posibles: No especificado Igual Contiene	No	Especifica el tipo de lógica de filtro que se debe aplicar. La lógica de filtrado funciona según el valor proporcionado en el parámetro "Clave de filtro". Nota: La lógica "Es igual a" distingue mayúsculas de minúsculas, mientras que "Contiene" no lo hace.
Valor del filtro	String	N/A	No	Especifica el valor que se debe usar en el filtro. Si se selecciona "Igual", la acción intenta encontrar la coincidencia exacta entre los resultados. Si se selecciona "Contiene", la acción intenta encontrar resultados que contengan esa subcadena. Si no se proporciona nada en este parámetro, no se aplica el filtro. La lógica de filtrado funciona según el valor proporcionado en el parámetro "Clave de filtro".
Cantidad máxima de registros para devolver	Número entero	50	No	Especifica la cantidad de registros que se devolverán. Si no se proporciona nada, la acción devuelve 50 registros. Máximo: 200

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero o falso	is_success:False

Resultado de 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"
            }
        }
]

Muro de casos

Tipo de resultado	Valor/Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: Si hay datos disponibles (is_success=true): "Successfully found playbooks for the provided criteria in Cofense Triage." Si los datos no están disponibles (is_success=false): "No se encontraron guías para los criterios proporcionados en Cofense Triage". Si el parámetro "Filter Value" está vacío (is_success=true): "The filter was not applied, because parameter "Filter Value" has an empty value." Si el parámetro "Filter Logic" se establece en "Not Specified" (is_success=true): "The filter was not applied, because parameter "Filter Logic" is not specified." La acción debería fallar y detener la ejecución de una guía: Si el parámetro "Filter Key" se establece en "Select One" y el parámetro "Filter Logic" se establece en "Equal" o "Contains": "Error executing action "{action name}". Motivo: Debes seleccionar un campo del parámetro "Clave de filtro". Si se proporciona un valor no válido para el parámetro "Cantidad máxima de registros que se mostrarán": "Error al ejecutar la acción "{action name}". Motivo: "Se proporcionó un valor no válido para "Cantidad máxima de registros que se mostrarán": `PROVIDED_VALUE`. Se debe proporcionar un número positivo"." Si se informa un error grave, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error executing action "List Playbooks". Reason: {0}''.format(error.Stacktrace)	General
Tabla del muro de casos	Nombre de la tabla: Guías disponibles Columna de la tabla: Nombre - nombre Activa-activa ID - id Descripción: descripción Etiquetas: CSV de report_tags + cluster_tags Fecha de creación: created_at	General

Tipo de resultado

Valor/Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si hay datos disponibles (is_success=true): "Successfully found playbooks for the provided criteria in Cofense Triage."

Si los datos no están disponibles (is_success=false): "No se encontraron guías para los criterios proporcionados en Cofense Triage".

Si el parámetro "Filter Value" está vacío (is_success=true): "The filter was not applied, because parameter "Filter Value" has an empty value."

Si el parámetro "Filter Logic" se establece en "Not Specified" (is_success=true): "The filter was not applied, because parameter "Filter Logic" is not specified."

La acción debería fallar y detener la ejecución de una guía:

Si el parámetro "Filter Key" se establece en "Select One" y el parámetro "Filter Logic" se establece en "Equal" o "Contains": "Error executing action "{action name}". Motivo: Debes seleccionar un campo del parámetro "Clave de filtro".

Si se proporciona un valor no válido para el parámetro "Cantidad máxima de registros que se mostrarán": "Error al ejecutar la acción "{action name}". Motivo: "Se proporcionó un valor no válido para "Cantidad máxima de registros que se mostrarán": PROVIDED_VALUE. Se debe proporcionar un número positivo"."

Si se informa un error grave, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error executing action "List Playbooks". Reason: {0}''.format(error.Stacktrace)

General

Tabla del muro de casos

Nombre de la tabla: Guías disponibles

Columna de la tabla:

Nombre - nombre
Activa-activa
ID - id
Descripción: descripción
Etiquetas: CSV de report_tags + cluster_tags
Fecha de creación: created_at

General

Enumera los informes relacionados con los indicadores de amenazas

Descripción

Enumera los informes relacionados con los indicadores de amenazas en Cofense Triage.

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
Crea una tabla de muro de casos	Casilla de verificación	Desmarcado	No	Si se habilita, la acción creará una tabla de muro de casos con información sobre los informes.
Cantidad máxima de informes que se devolverán	Número entero	100	No	Especifica cuántos informes se deben mostrar.

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero o falso	is_success:False

Resultado de 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
            }
        }
    ],
}

Muro de casos

Tipo de resultado	Valor/Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: Si se ejecuta correctamente: "Successfully returned reports related to provided entities from Cofense Triage." Si no se encuentran informes: "No related reports were found for the provided entities". La acción debería fallar y detener la ejecución de una guía: Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error executing action "List Reports Related To Threat Indicators". Motivo: (error.Stacktrace)	General
Tabla del muro de casos	Nombre de la tabla: Informes relacionados Columna de la tabla: ID Asunto Fecha de creación Ubicación	General

Tipo de resultado

Valor/Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se ejecuta correctamente: "Successfully returned reports related to provided entities from Cofense Triage."
Si no se encuentran informes: "No related reports were found for the provided entities".

La acción debería fallar y detener la ejecución de una guía:

Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error executing action "List Reports Related To Threat Indicators". Motivo: (error.Stacktrace)

General

Tabla del muro de casos

Nombre de la tabla: Informes relacionados

Columna de la tabla:

Asunto

Fecha de creación

Ubicación

General

Ping

Descripción

Prueba la conectividad con Cofense Triage con los parámetros proporcionados en la página de configuración de la integración en la página de Google SecOps Content Hub.

Parámetros

N/A

Ejecutar en

Esta acción no se ejecuta en entidades ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero o falso	is_success:False

Muro de casos

Tipo de resultado	Valor / Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: Si se realiza correctamente: "Successfully connected to the Cofense Triage server with the provided connection parameters!" La acción debería fallar y detener la ejecución de una guía: Si no se realiza correctamente, aparecerá el mensaje "Failed to connect to the Cofense Triage server! Error is {0}".format(exception.stacktrace)	General

Tipo de resultado

Valor / Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se realiza correctamente: "Successfully connected to the Cofense Triage server with the provided connection parameters!"

La acción debería fallar y detener la ejecución de una guía:

Si no se realiza correctamente, aparecerá el mensaje "Failed to connect to the Cofense Triage server! Error is {0}".format(exception.stacktrace)

General

Conector

Cofense Triage: Conector de informes

Extrae informes de Cofense Triage.

Configura el conector de Cofense Triage - Reports en Google SecOps

Para obtener instrucciones detalladas sobre cómo configurar un conector en Google SecOps, consulta Configura el conector.

Parámetros del conector

Usa los siguientes parámetros para configurar el conector:

Nombre visible del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
Nombre del campo del producto	String	Nombre del producto	Sí	Ingresa el nombre del campo de origen para recuperar el nombre del campo del producto.
Nombre del campo del evento	String	ubicación	Sí	Ingresa el nombre del campo de origen para recuperar el nombre del campo de evento.
Nombre del campo de entorno	String	""	No	Describe el nombre del campo en el que se almacena el nombre del entorno. Si no se encuentra el campo de entorno, el entorno es el predeterminado.
Patrón de regex del entorno	String	.*	No	Es un patrón de regex que se ejecuta en el valor que se encuentra en el campo "Nombre del campo de entorno". El valor predeterminado es .* para capturar todo y devolver el valor sin cambios. Se usa para permitir que el usuario manipule el campo de entorno a través de la lógica de regex. Si el patrón de regex es nulo o está vacío, o si el valor del entorno es nulo, el resultado final del entorno es el entorno predeterminado.
Tiempo de espera de la secuencia de comandos (segundos)	Número entero	180	Sí	Es el límite de tiempo de espera para el proceso de Python que ejecuta la secuencia de comandos actual.
Raíz de la API	String	https://tap.phishmecloud.com	Sí	Es la raíz de la API de la instancia de Cofense Triage.
ID de cliente	String	N/A	Sí	Es el ID de cliente de la cuenta de Cofense Triage.
Ubicación desde la que se informó	CSV	Inbox,Reconnaissance	No	Es una lista separada por comas de las ubicaciones de informes desde las que el conector debe transferir datos. Solo se transferirán los informes de las ubicaciones proporcionadas. Los valores posibles son los siguientes: Recibidos Reconocimiento Procesado Si no se proporciona ningún valor, el conector transferirá informes de todas las ubicaciones.
Secreto del cliente	Contraseña	N/A	Sí	Es el secreto del cliente de la cuenta de Cofense Triage.
Puntuación de riesgo más baja que se recuperará	Número entero	0	Sí	Es la puntuación de riesgo más baja que se usará para recuperar correos electrónicos. El máximo es 100.
Categoría	CSV	N/A	No	Es una lista separada por comas de las categorías que se usan para filtrar los informes entrantes. El conector transfiere un informe solo si coincide con al menos una categoría de la lista.
Recuperar la cantidad máxima de horas hacia atrás	Número entero	1	No	Es la cantidad de horas desde las que se recuperarán los correos electrónicos.
Cantidad máxima de informes que se recuperarán	Número entero	10	No	Indica cuántos informes se procesarán por iteración del conector.
Usa la lista de entidades permitidas como una lista de entidades rechazadas	Casilla de verificación	Desmarcado	Sí	Si se habilita, la lista de entidades permitidas se usará como una lista de entidades rechazadas.
Verificar SSL	Casilla de verificación	Desmarcado	Sí	Si está habilitado, verifica que el certificado SSL para la conexión con el servidor de Cofense Triage sea válido.
Dirección del servidor proxy	String	N/A	No	Es la dirección del servidor proxy que se usará.
Nombre de usuario del proxy	String	N/A	No	Es el nombre de usuario del proxy con el que se autenticará.
Contraseña del proxy	Contraseña	N/A	No	Es la contraseña del proxy con la que se realizará la autenticación.

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.