Se usó la API de Cloud Translation para traducir esta página.

Cofense Triage

Versión de integración: 10.0

Casos de uso

Ingiere informes de Cofense Triage y úsalos para crear alertas de Google Security Operations. A continuación, en Google SecOps, se pueden usar las alertas para realizar orquestaciones con guías o análisis manuales.
Es el enriquecimiento de las entidades relacionadas y los detalles sobre el informe.
Es la 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 está habilitado, verifica que el certificado SSL para la conexión al servidor de Cofense Triage sea válido.

Acciones

Agregar etiquetas al informe

Descripción

Agrega etiquetas a un informe en Cofense Triage.

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Is Mandatory	Descripción
ID del informe	String	N/A	Sí	Especifica el ID del informe al que deseas 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/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 o 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) 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) La acción debería fallar y detener la ejecución de la guía: Si se produce un error no recuperable, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, imprime “Error al ejecutar la acción "Add Tags To Report"”. Reason: {0}''.format(error.Stacktrace)	General

Tipo de resultado

Valor o 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)

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)

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

Si se produce un error no recuperable, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, imprime “Error al ejecutar la acción "Add Tags To Report"”. Reason: {0}''.format(error.Stacktrace)

General

Categorizar informe

Descripción

Categoriza un informe en Cofense Triage.

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Is Mandatory	Descripción
ID del informe	String	N/A	Sí	Especifica el ID del informe al que deseas 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/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 o 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) 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. 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: Si se produce un error fatal, como credenciales incorrectas, falta de conexión al servidor o algún otro problema, imprime "Error al ejecutar la acción "Categorize Report"". Reason: {0}''.format(error.Stacktrace)	General

Tipo de resultado

Valor o 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)

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

Si se produce un error fatal, como credenciales incorrectas, falta de conexión al servidor o algún otro problema, imprime "Error al ejecutar la acción "Categorize Report"". Reason: {0}''.format(error.Stacktrace)

General

Correo electrónico de descarga del 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	Is Mandatory	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.
Carpeta de descargas	String	N/A	Sí	Especifica la ruta de acceso absoluta a la carpeta de descargas. Nota: El nombre se construirá de la siguiente manera: {ID del informe}.eml.
Reemplazar	Casilla de verificación	Marcado	No	Si está habilitada, la acción reemplazará el archivo con el mismo nombre y ruta de acceso.
Crear estadística	Casilla de verificación	Desmarcado	No	Si está habilitada, la acción creará una estadística que contiene 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/Falso	is_success:False

Resultado de JSON

{
    "absolute_file_path": "{filepath}"
}

Estadística

Nombre	Cuerpo
Es el ID del informe. Correo electrónico sin procesar	{content of the response. \n se debe reemplazar por \ }

Muro de casos

Tipo de resultado	Valor o 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) Si no se pudo realizar la acción, es decir, si el código de estado es 400(is_success = false): Imprime "No se pudo descargar el correo electrónico sin procesar relacionado con el informe con el ID {0} en Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail) La acción debería fallar y detener la ejecución de la guía: Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, imprime “Error al ejecutar la acción "Download Report Email"”. Motivo: {0}''.format(error.Stacktrace) Si existe un archivo con el nombre de archivo y overwrite es falso: "Error al ejecutar la acción "Download Report Email". Motivo: Ya existe un archivo con esa ruta de acceso. Quítalo o configura "Overwrite" como verdadero".	General

Tipo de resultado

Valor o 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)

Si no se pudo realizar la acción, es decir, si el código de estado es 400(is_success = false): Imprime "No se pudo descargar el correo electrónico sin procesar relacionado con el informe con el ID {0} en Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail)

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

Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, imprime “Error al ejecutar la acción "Download Report Email"”. Motivo: {0}''.format(error.Stacktrace)

Si existe un archivo con el nombre de archivo y overwrite es falso: "Error al ejecutar la acción "Download Report Email". Motivo: Ya existe un archivo con esa ruta de acceso. Quítalo o configura "Overwrite" 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	Is Mandatory	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.
Carpeta de descargas	String	N/A	Sí	Especifica la ruta de acceso absoluta a la carpeta de descargas. Nota: El nombre se construirá de la siguiente manera: {ID del informe}.eml.
Reemplazar	Casilla de verificación	Marcado	No	Si está habilitada, la acción reemplazará el archivo con el mismo nombre y ruta de acceso.
Formato de imagen	DDL	PNG Valores posibles: PNG JPG	Sí	Especifica el formato de la imagen.
Crear estadística	Casilla de verificación	Desmarcado	No	Si está habilitada, la acción creará una estadística que contiene 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/Falso	is_success:False

Resultado de JSON

{
    "absolute_file_path": "{filepath}"
}

Muro de casos

Tipo de resultado	Valor o descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: Si la operación se realiza correctamente (is_success=true):"Se descargó correctamente la vista previa relacionada con el informe con el ID {0} en Cofense Triage".format(report_id) Si no se pudo descargar una vista previa relacionada con el informe con el ID {0} en Cofense Triage, se devuelve el código de estado 400 (is_success=false): Reason: \n {1}".format(report_id, errors/detail) La acción debería fallar y detener la ejecución de la guía: Si se informa un error no recuperable, como credenciales incorrectas, falta de conexión con el servidor o algún otro error, se mostrará el mensaje"Error al ejecutar la acción "Descargar vista previa del informe". Reason: {0}''.format(error.Stacktrace) Si existe un archivo con el nombre de archivo y overwrite es falso: "Error al ejecutar la acción "Download Report Email". Motivo: Ya existe un archivo con esa ruta de acceso. Quítalo o configura "Overwrite" como verdadero".	General

Tipo de resultado

Valor o descripción

Tipo

Mensaje de salida*

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

Si la operación se realiza correctamente (is_success=true):"Se descargó correctamente la vista previa relacionada con el informe con el ID {0} en Cofense Triage".format(report_id)

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

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

Si se informa un error no recuperable, como credenciales incorrectas, falta de conexión con el servidor o algún otro error, se mostrará el mensaje"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	Is Mandatory	Descripción
Umbral de la puntuación de riesgo	Número entero	50	Sí	Especifica cuál debe ser el umbral de la puntuación de riesgo para que Google SecOps etiquete esa URL como sospechosa. El valor 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/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 o 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 puede enriquecer para todas las entidades (is_success = false): Imprime: "No se enriqueció ninguna URL". La acción debería fallar y detener la ejecución de la 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 o 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 puede enriquecer para todas las entidades (is_success = false): Imprime: "No se enriqueció ninguna URL".

La acción debería fallar y detener la ejecución de la 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	Is Mandatory	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/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): "Se ejecutó correctamente el playbook {playbook name} en el informe {report id} en Cofense Triage". La acción debería fallar y detener la ejecución de la guía: Si se proporciona un valor no válido para el parámetro "Registros máximos que se devolverán": "Error al ejecutar la acción "Ejecutar guía". Reason: {0}''.format(error.Stacktrace)" Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema: "Error al ejecutar la acción "List Playbooks". Reason: {0}''.format(error.Stacktrace) Si se informan errores en la respuesta: "Error al ejecutar la acción "Ejecutar Playbook". Reason: {0}''.format(detail)" Si no se encuentra la guía: "Error al ejecutar la acción "Ejecutar guía". 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): "Se ejecutó correctamente el playbook {playbook name} en el informe {report id} en Cofense Triage".

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

Si se proporciona un valor no válido para el parámetro "Registros máximos que se devolverán": "Error al ejecutar la acción "Ejecutar guía". Reason: {0}''.format(error.Stacktrace)"

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema: "Error al ejecutar la acción "List Playbooks". Reason: {0}''.format(error.Stacktrace)

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

Si no se encuentra la guía: "Error al ejecutar la acción "Ejecutar guía". 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/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 o 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 se encontró información sobre los dominios". La acción debería fallar y detener la ejecución de la guía: Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, imprime “Error al ejecutar la acción "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 o 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 se encontró información sobre los dominios".

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

Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, imprime “Error al ejecutar la acción "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

Obtén los encabezados del informe

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	Is Mandatory	Descripción
ID del informe	String	N/A	Sí	Especifica el ID del informe para el que deseas recuperar los encabezados.
Cantidad máxima de encabezados que se pueden devolver	Número entero	50	No	Especifica la cantidad de encabezados 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/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 o 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) Si no se realiza correctamente, es decir, el código de estado es 404(is_success = false): Imprime "La acción no pudo devolver encabezados relacionados al informe con el ID {0} en Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail) Si no se encuentran reglas (is_success = false): Imprime: "No se encontraron encabezados relacionados con el informe con el ID {0} en Cofense Triage.".format(report_id) La acción debería fallar y detener la ejecución de la 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: Clave Name Valor: valor	General

Tipo de resultado

Valor o 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)

Si no se realiza correctamente, es decir, el código de estado es 404(is_success = false): Imprime "La acción no pudo devolver encabezados relacionados al informe con el ID {0} en Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail)

Si no se encuentran reglas (is_success = false): Imprime: "No se encontraron encabezados relacionados con el informe con el ID {0} en Cofense Triage.".format(report_id)

La acción debería fallar y detener la ejecución de la 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:

Clave Name

Valor: valor

General

Obtener denunciantes de informes

Descripción

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

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Is Mandatory	Descripción
ID del informe	String	N/A	Sí	Especifica el ID del informe para el que deseas recuperar los reporteros.
Cantidad máxima de reporteros que se pueden devolver	Número entero	50	No	Especifica cuántos reporteros 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/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 o 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) Si no se pudo realizar la acción, es decir, si el código de estado es 404(is_success = false): Imprime "No se pudo devolver los reporteros relacionados con el informe con ID {0} en Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail) If no rules found (is_success = false): Print: "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 la guía: Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, imprime "Error al ejecutar la acción "Get Report Reporters". Reason: {0}''.format(error.Stacktrace)	General
CSV	Nombre de la tabla: Informes de {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 o 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)

Si no se pudo realizar la acción, es decir, si el código de estado es 404(is_success = false): Imprime "No se pudo devolver los reporteros relacionados con el informe con ID {0} en Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail)

If no rules found (is_success = false): Print: "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 la guía:

Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, imprime "Error al ejecutar la acción "Get Report Reporters". Reason: {0}''.format(error.Stacktrace)

General

CSV

Nombre de la tabla: Informes de {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 del indicador de amenazas

Descripción

Devuelve información sobre las entidades en función de 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/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 o 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 se encontró información sobre indicadores de amenazas para las entidades". La acción debería fallar y detener la ejecución de la guía: Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, imprime el mensaje "Error al ejecutar la acción "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 o 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 se encontró información sobre indicadores de amenazas para las entidades".

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

Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, imprime el mensaje "Error al ejecutar la acción "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	Is Mandatory	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á habilitado, la acción solo devuelve categorías archivadas.
Solo los que no están archivados	Casilla de verificación	Desmarcado	No	Si está habilitada, la acción solo devuelve categorías no archivadas.
Solo contenido no malicioso	Casilla de verificación	Desmarcado	No	Si está habilitada, 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/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 la operación se realiza correctamente (is_success=true): "Se devolvieron correctamente las categorías disponibles de Cofense Triage". Si no se encuentran categorías (is_success=false) "No se encontraron categorías para los criterios". La acción debería fallar y detener la ejecución de la guía: Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema: "Error al ejecutar la acción "List Categories". Reason: {0}''.format(error.Stacktrace)	General
Tabla del muro de casos	Nombre de la tabla: Categorías disponibles Columna de la tabla: Nombre: nombre Puntuación: score ID: id Malicioso: Malicioso Archivada: archivada	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 la operación se realiza correctamente (is_success=true): "Se devolvieron correctamente las categorías disponibles de Cofense Triage".

Si no se encuentran categorías (is_success=false) "No se encontraron categorías para los criterios".

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

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema: "Error al ejecutar la acción "List Categories". Reason: {0}''.format(error.Stacktrace)

General

Tabla del muro de casos

Nombre de la tabla: Categorías disponibles

Columna de la tabla:

Nombre: nombre
Puntuación: score
ID: id
Malicioso: Malicioso
Archivada: archivada

General

Enumera las guías

Descripción

Enumera los cuadernos de estrategias disponibles en Cofense Triage.

Parámetros

Nombre visible del parámetro	Tipo	Valor predeterminado	Is Mandatory	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 los playbooks.
Lógica de filtro	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 del 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 a", la acción intenta encontrar la coincidencia exacta entre los resultados. Si se selecciona "Contiene", la acción intentará 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 del filtro".
Cantidad máxima de registros que se pueden 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/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): "Se encontraron correctamente los Playbooks para los criterios proporcionados en 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): "No se aplicó el filtro porque el parámetro "Filter Value" tiene un valor vacío". Si el parámetro "Lógica del filtro" se establece en "No especificado" (is_success=true): "No se aplicó el filtro porque no se especificó el parámetro "Lógica del filtro"". La acción debería fallar y detener la ejecución de la guía: Si el parámetro "Clave de filtro" está configurado como "Seleccionar uno" y el parámetro "Lógica de filtro" está configurado como "Igual a" o "Contiene": "Error al ejecutar la acción "{nombre de la acción}". Motivo: Debes seleccionar un campo del parámetro "Clave de filtro". Si se proporciona un valor no válido para el parámetro "Max Records to Return": "Error executing action "{action name}". Motivo: Se proporcionó un valor no válido para "Max Records to Return": . Se debe proporcionar un número positivo"." Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema: "Error al ejecutar la acción "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): "Se encontraron correctamente los Playbooks para los criterios proporcionados en 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): "No se aplicó el filtro porque el parámetro "Filter Value" tiene un valor vacío".

Si el parámetro "Lógica del filtro" se establece en "No especificado" (is_success=true): "No se aplicó el filtro porque no se especificó el parámetro "Lógica del filtro"".

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

Si el parámetro "Clave de filtro" está configurado como "Seleccionar uno" y el parámetro "Lógica de filtro" está configurado como "Igual a" o "Contiene": "Error al ejecutar la acción "{nombre de la acción}". Motivo: Debes seleccionar un campo del parámetro "Clave de filtro".

Si se proporciona un valor no válido para el parámetro "Max Records to Return": "Error executing action "{action name}". Motivo: Se proporcionó un valor no válido para "Max Records to Return": . Se debe proporcionar un número positivo"."

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	Is Mandatory	Descripción
Crea una tabla de pared para el estuche	Casilla de verificación	Desmarcado	No	Si está habilitada, la acción creará una tabla de muro de casos con información sobre los informes.
Cantidad máxima de informes que se pueden devolver	Número entero	100	No	Especifica la cantidad de informes que se devolverán.

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/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 la operación se realiza correctamente: "Se devolvieron correctamente los informes relacionados con las entidades proporcionadas de Cofense Triage". Si no se encuentran informes: "No se encontraron informes relacionados con las entidades proporcionadas". La acción debería fallar y detener la ejecución de la guía: Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor, etc.: "Error al ejecutar la acción "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 la operación se realiza correctamente: "Se devolvieron correctamente los informes relacionados con las entidades proporcionadas de Cofense Triage".
Si no se encuentran informes: "No se encontraron informes relacionados con las entidades proporcionadas".

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

Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor, etc.: "Error al ejecutar la acción "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 pestaña Google Security Operations Marketplace.

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/Falso	is_success:False

Muro de casos

Tipo de resultado	Valor o descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: Si la acción se realiza correctamente, "Se conectó correctamente al servidor de Cofense Triage con los parámetros de conexión proporcionados". La acción debería fallar y detener la ejecución del playbook: Si no se realiza correctamente: "No se pudo conectar al servidor de Cofense Triage. Error is {0}".format(exception.stacktrace)	General

Tipo de resultado

Valor o descripción

Tipo

Mensaje de salida*

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

Si la acción se realiza correctamente, "Se conectó correctamente al servidor de Cofense Triage con los parámetros de conexión proporcionados".

La acción debería fallar y detener la ejecución del playbook:

Si no se realiza correctamente: "No se pudo conectar al servidor de Cofense Triage. Error is {0}".format(exception.stacktrace)

General

Conector

Cofense Triage: conector de informes

Extrae informes de Cofense Triage.

Configura el conector de informes de Cofense Triage en Google SecOps

Si quieres obtener instrucciones detalladas para configurar un conector en Google SecOps, consulta Cómo configurar 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 del evento.
Nombre del campo del entorno	String	""	No	Describe el nombre del campo en el que se almacena el nombre del entorno. Si no se encuentra el campo del entorno, se usa el entorno predeterminado.
Patrón de expresión regular del entorno	String	.*	No	Es un patrón de regex que se ejecutará en el valor que se encuentra en el campo "Nombre del campo del entorno". El valor predeterminado es .* para capturar todo y devolver el valor sin cambios. Se usa para permitir que el usuario manipule el campo del 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.
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 para recuperar	Número entero	0	Sí	Es la puntuación de riesgo más baja que se usará para recuperar correos electrónicos. El valor máximo es 100.
Recuperar horas máximas hacia atrás	Número entero	1	No	Cantidad de horas desde las que se recuperarán los correos electrónicos.
Cantidad máxima de informes para recuperar	Número entero	10	No	Cantidad de informes que se procesarán por iteración del conector.
Usar la lista blanca como lista negra	Casilla de verificación	Desmarcado	Sí	Si se habilita, la lista de entidades permitidas se usará como lista de entidades bloqueadas.
Verificar SSL	Casilla de verificación	Desmarcado	Sí	Si está habilitado, verifica que el certificado SSL para la conexión al 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	Nombre de usuario del proxy con el que se realizará la autenticación.
Contraseña de proxy	Contraseña	N/A	No	Contraseña del proxy para la autenticación.

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