O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Cofense Triage

Neste documento, descrevemos como integrar o Cofense Triage ao Google Security Operations.

Casos de uso

Ingerir relatórios do Cofense Triage e usá-los para criar alertas do Google Security Operations. Em seguida, no Google SecOps, os alertas podem ser usados para realizar orquestrações com playbooks ou análise manual.
Enriquecimento das entidades relacionadas e detalhes sobre o relatório.
Triagem do relatório.

Configurar a integração do Cofense Triage no Google SecOps

Para instruções detalhadas sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.

Parâmetros de integração

Use os seguintes parâmetros para configurar a integração:

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Raiz da API	String	https://tap.phishmecloud.com	N/A	Raiz da API da instância do Cofense Triage.
ID do cliente	String	N/A	Sim	ID do cliente da conta do Cofense Triage.
Chave secreta do cliente	Senha	N/A	Sim	Chave secreta do cliente da conta do Cofense Triage.
Verificar SSL	Caixa de seleção	Desmarcado	Sim	Se ativada, verifica se o certificado SSL da conexão com o servidor do Cofense Triage é válido.

Ações

Adicionar tags ao relatório

Descrição

Adicione tags a um relatório no Cofense Triage.

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
ID do relatório	String	N/A	Sim	Especifique o ID do relatório em que você quer adicionar tags.
Tags	CSV	N/A	Sim	Especifique uma lista separada por vírgulas de tags que precisam ser aplicadas ao relatório.

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/falso	is_success:False

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

Painel de casos

Tipo de resultado	Valor / Descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: if successful(is_success = true): print "Successfully added tags to the the report with ID {0} in Cofense Triage.".format(report_id) Se não for bem-sucedido, ou seja, código de status 404(is_success = false): print "A ação não conseguiu adicionar tags ao relatório com o ID {0} no Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail) A ação deve falhar e interromper a execução de um playbook: Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros:mostre "Erro ao executar a ação 'Adicionar tags ao relatório'". Motivo: {0}''.format(error.Stacktrace)	Geral

Tipo de resultado

Valor / Descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

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

Se não for bem-sucedido, ou seja, código de status 404(is_success = false):
print "A ação não conseguiu adicionar tags ao relatório com o ID {0} no Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail)

A ação deve falhar e interromper a execução de um playbook:

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros:mostre "Erro ao executar a ação 'Adicionar tags ao relatório'". Motivo: {0}''.format(error.Stacktrace)

Geral

Categorizar relatório

Descrição

Categorizar um relatório no Cofense Triage.

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
ID do relatório	String	N/A	Sim	Especifique o ID do relatório em que você quer adicionar tags.
Nome da categoria	String	N/A	Sim	Especifique o nome da categoria que deve ser aplicada ao relatório. As categorias disponíveis podem ser encontradas na ação "Listar categorias".

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/falso	is_success:False

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

Painel de casos

Tipo de resultado	Valor / Descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: if successful(is_success = true): print "Successfully updated category on the the report with ID {0} to {1} in Cofense Triage.".format(report_id, category_name) Se não for bem-sucedido, ou seja, código de status 404(is_success = false): print "A ação não conseguiu atualizar a categoria no relatório com o ID {0} para {1} no Cofense Triage. Motivo: \n {2}".format(report_id, category_name, errors/detail) A ação deve falhar e interromper a execução de um playbook: Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: mostre "Erro ao executar a ação 'Categorizar relatório'". Motivo: {0}''.format(error.Stacktrace)	Geral

Tipo de resultado

Valor / Descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

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

Se não for bem-sucedido, ou seja, código de status 404(is_success = false): print "A ação não conseguiu atualizar a categoria no relatório com o ID {0} para {1} no Cofense Triage. Motivo: \n {2}".format(report_id, category_name, errors/detail)

A ação deve falhar e interromper a execução de um playbook:

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: mostre "Erro ao executar a ação 'Categorizar relatório'". Motivo: {0}''.format(error.Stacktrace)

Geral

E-mail para download do relatório

Descrição

Faça o download do e-mail bruto relacionado ao relatório do Cofense Triage.

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
ID do relatório	String	N/A	Sim	Especifique o ID do relatório que contém o e-mail bruto que precisa ser baixado.
Pasta de download	String	N/A	Sim	Especifique o caminho absoluto para a pasta de download. Observação: o nome será construído da seguinte maneira: {ID do relatório}.eml.
Substituir	Caixa de seleção	Selecionado	Não	Se ativada, a ação vai substituir o arquivo com o mesmo nome e caminho.
Criar insight	Caixa de seleção	Desmarcado	Não	Se ativada, a ação vai criar um insight que contém o e-mail bruto do relatório.

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/falso	is_success:False

Resultado do JSON

{
    "absolute_file_path": "{filepath}"
}

Insight

Nome	Corpo
Denúncia {ID}. E-mail bruto	{conteúdo da resposta. \n deve ser substituído por \ }

Painel de casos

Tipo de resultado	Valor / Descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: if successful(is_success = true): print "Successfully downloaded raw email related to the report with ID {0} in Cofense Triage.".format(report_id) Se não for bem-sucedido, ou seja, código de status 400(is_success = false): mostre "A ação não conseguiu fazer o download do e-mail bruto relacionado ao relatório com o ID {0} no Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail) A ação deve falhar e interromper a execução de um playbook: Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: mostre "Erro ao executar a ação 'Fazer o download do e-mail do relatório'. Motivo: {0}''.format(error.Stacktrace) Se o arquivo com o nome de arquivo existir e a substituição for falsa: "Erro ao executar a ação 'Fazer download do e-mail do relatório'. Motivo: já existe um arquivo com esse caminho. Remova-o ou defina "Overwrite" como verdadeiro.	Geral

Tipo de resultado

Valor / Descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

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

Se não for bem-sucedido, ou seja, código de status 400(is_success = false): mostre "A ação não conseguiu fazer o download do e-mail bruto relacionado ao relatório com o ID {0} no Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail)

A ação deve falhar e interromper a execução de um playbook:

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: mostre "Erro ao executar a ação 'Fazer o download do e-mail do relatório'. Motivo: {0}''.format(error.Stacktrace)

Se o arquivo com o nome de arquivo existir e a substituição for falsa: "Erro ao executar a ação 'Fazer download do e-mail do relatório'. Motivo: já existe um arquivo com esse caminho. Remova-o ou defina "Overwrite" como verdadeiro.

Geral

Baixar prévia do relatório

Descrição

Baixe a prévia da imagem do e-mail relacionado ao relatório do Cofense Triage.

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
ID do relatório	String	N/A	Sim	Especifique o ID do relatório que contém o e-mail bruto que precisa ser baixado.
Pasta de download	String	N/A	Sim	Especifique o caminho absoluto para a pasta de download. Observação: o nome será construído da seguinte maneira: {ID do relatório}.eml.
Substituir	Caixa de seleção	Selecionado	Não	Se ativada, a ação vai substituir o arquivo com o mesmo nome e caminho.
Formato da imagem	DDL	PNG Valores possíveis: PNG JPG	Sim	Especifique o formato da imagem.
Criar insight	Caixa de seleção	Desmarcado	Não	Se ativada, a ação vai criar um insight que contém o e-mail bruto do relatório.

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/falso	is_success:False

Resultado do JSON

{
    "absolute_file_path": "{filepath}"
}

Painel de casos

Tipo de resultado	Valor / Descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se for bem-sucedido (is_success=true):"Successfully downloaded preview related to the report with ID {0} in Cofense Triage.".format(report_id) Se não for bem-sucedido, o código de status 400 (is_success=false) será retornado: "A ação não conseguiu fazer o download de uma prévia relacionada ao relatório com o ID {0} no Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail) A ação deve falhar e interromper a execução de um playbook: Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Fazer o download da prévia do relatório'. Motivo: {0}''.format(error.Stacktrace) Se o arquivo com o nome de arquivo existir e a substituição for falsa: "Erro ao executar a ação 'Fazer download do e-mail do relatório'. Motivo: já existe um arquivo com esse caminho. Remova-o ou defina "Overwrite" como verdadeiro.	Geral

Tipo de resultado

Valor / Descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se for bem-sucedido (is_success=true):"Successfully downloaded preview related to the report with ID {0} in Cofense Triage.".format(report_id)

Se não for bem-sucedido, o código de status 400 (is_success=false) será retornado: "A ação não conseguiu fazer o download de uma prévia relacionada ao relatório com o ID {0} no Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail)

A ação deve falhar e interromper a execução de um playbook:

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Fazer o download da prévia do relatório'. Motivo: {0}''.format(error.Stacktrace)

Geral

URL de enriquecimento

Descrição

Retorna informações sobre o URL da Cofense Triage.

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Limite da pontuação de risco	Inteiro	50	Sim	Especifique qual deve ser o limite de pontuação de risco para que o Google SecOps rotule esse URL como suspeito. O máximo é 100.

Corrida

Essa ação é executada na entidade de URL.

Resultados da ação

Enriquecimento de entidades

Nome do campo de aprimoramento	Lógica: quando aplicar
COFENSE_TRG_id	Se disponível no resultado em JSON.
COFENSE_TRG_risk_score	Se disponível no resultado em JSON.
COFENSE_TRG_created_at	Se disponível no resultado em JSON.
COFENSE_TRG_updated_at	Se disponível no resultado em JSON.

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/falso	is_success:False

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

Painel de casos

Tipo de resultado	Valor / Descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se for bem-sucedido para pelo menos um URL(is_success = true): print "Successfully enriched the following URLs using Cofense Triage: \n {0}".format(entity.identifier list) if successful for at least one URL(is_success = true): print "Action wasn't able to enrich the following URLs using Cofense Triage: \n {0}".format(entity.identifier list) Se a otimização falhar para todas as entidades (is_success = false): mostre "Nenhum URL foi otimizado". A ação deve falhar e interromper a execução de um playbook: Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: print "Erro ao executar a ação 'Enriquecer URL'. Motivo: {0}''.format(error.Stacktrace)	Geral
CSV	Campos que estão na seção da tabela de enriquecimento, mas sem o prefixo "COFENSE_TRG_"	Entidade

Tipo de resultado

Valor / Descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se for bem-sucedido para pelo menos um URL(is_success = true): print "Successfully enriched the following URLs using Cofense Triage: \n {0}".format(entity.identifier list)

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

Se a otimização falhar para todas as entidades (is_success = false): mostre "Nenhum URL foi otimizado".

A ação deve falhar e interromper a execução de um playbook:

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: print "Erro ao executar a ação 'Enriquecer URL'. Motivo: {0}''.format(error.Stacktrace)

Geral

CSV

Campos que estão na seção da tabela de enriquecimento, mas sem o prefixo "COFENSE_TRG_"

Entidade

Executar playbook

Descrição

Inicie a execução de um playbook no Cofense Triage.

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
ID do relatório	String	N/A	Sim	Especifique o ID do relatório em que você quer executar o playbook.
Nome do playbook	String	N/A	Sim	Especifique o nome do playbook que precisa ser executado.

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/falso	is_success:False

Resultado do JSON

N/A

Painel de casos

Tipo de resultado	Valor/descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se o código de status 204 for informado (is_success=true): "O playbook {playbook name} foi executado com sucesso no relatório {report id} no Cofense Triage." A ação deve falhar e interromper a execução de um playbook: Se um valor inválido for fornecido para o parâmetro "Max Records to Return": "Error executing action 'Execute Playbook'. Motivo: {0}''.format(error.Stacktrace)" Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Listar playbooks'. Motivo: {0}''.format(error.Stacktrace) Se forem informados erros na resposta: "Erro ao executar a ação 'Executar playbook'". Motivo: {0}''.format(detail)" Se o playbook não for encontrado: "Erro ao executar a ação 'Executar playbook'". Motivo: o playbook com o nome {name} não foi encontrado."	Geral

Tipo de resultado

Valor/descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se o código de status 204 for informado (is_success=true): "O playbook {playbook name} foi executado com sucesso no relatório {report id} no Cofense Triage."

A ação deve falhar e interromper a execução de um playbook:

Se um valor inválido for fornecido para o parâmetro "Max Records to Return": "Error executing action 'Execute Playbook'. Motivo: {0}''.format(error.Stacktrace)"

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Listar playbooks'. Motivo: {0}''.format(error.Stacktrace)

Se forem informados erros na resposta: "Erro ao executar a ação 'Executar playbook'". Motivo: {0}''.format(detail)"

Se o playbook não for encontrado: "Erro ao executar a ação 'Executar playbook'". Motivo: o playbook com o nome {name} não foi encontrado."

Geral

Receber detalhes do domínio

Descrição

Retorna informações sobre o domínio do Cofense Triage.

Parâmetros

Nome de exibição do parâmetro
N/A

Corrida

Essa ação é executada na entidade de URL.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/falso	is_success:False

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

Painel de casos

Tipo de resultado	Valor / Descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: se for bem-sucedido para pelo menos um 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) Se não for possível enriquecer todas as entidades (is_success = false): mostre "No information about the domains was found." A ação deve falhar e interromper a execução de um playbook: Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: print "Erro ao executar a ação 'Ver detalhes do domínio'. Motivo: {0}''.format(error.Stacktrace)	Geral
CSV	Nome da tabela:Domain Details Colunas da tabela: Nome: nome do host Pontuação de risco: risk_score	Geral

Tipo de resultado

Valor / Descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

se for bem-sucedido para pelo menos um 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)

Se não for possível enriquecer todas as entidades (is_success = false): mostre "No information about the domains was found."

A ação deve falhar e interromper a execução de um playbook:

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: print "Erro ao executar a ação 'Ver detalhes do domínio'. Motivo: {0}''.format(error.Stacktrace)

Geral

CSV

Nome da tabela:Domain Details

Colunas da tabela:

Nome: nome do host

Pontuação de risco: risk_score

Geral

Receber cabeçalhos de relatório

Descrição

Retorna informações sobre o cabeçalho relacionado ao relatório do Cofense Triage.

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
ID do relatório	String	N/A	Sim	Especifique o ID do relatório para o qual você quer recuperar os cabeçalhos.
Número máximo de cabeçalhos a serem retornados	Inteiro	50	Não	Especifique quantos cabeçalhos serão retornados.

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/falso	is_success:False

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

Painel de casos

Tipo de resultado	Valor / Descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: if successful(is_success = true): print "Successfully returned related headers to the report with ID {0} in Cofense Triage.".format(report_id) Se não for bem-sucedido, ou seja, código de status 404(is_success = false): mostre "A ação não conseguiu retornar os cabeçalhos relacionados ao relatório com o ID {0} no Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail) Se nenhuma regra for encontrada (is_success = false): mostre "No related headers were found to the report with ID {0} in Cofense Triage.".format(report_id) A ação deve falhar e interromper a execução de um playbook: Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: print "Erro ao executar a ação 'Receber cabeçalhos do relatório'. Motivo: {0}''.format(error.Stacktrace)	Geral
CSV	Nome da tabela:cabeçalhos do relatório {0} Colunas da tabela: Nome: chave Valor: valor	Geral

Tipo de resultado

Valor / Descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

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

Se não for bem-sucedido, ou seja, código de status 404(is_success = false): mostre "A ação não conseguiu retornar os cabeçalhos relacionados ao relatório com o ID {0} no Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail)

Se nenhuma regra for encontrada (is_success = false): mostre "No related headers were found to the report with ID {0} in Cofense Triage.".format(report_id)

A ação deve falhar e interromper a execução de um playbook:

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: print "Erro ao executar a ação 'Receber cabeçalhos do relatório'. Motivo: {0}''.format(error.Stacktrace)

Geral

CSV

Nome da tabela:cabeçalhos do relatório {0}

Colunas da tabela:

Nome: chave

Valor: valor

Geral

Receber denunciantes de relatórios

Descrição

Retorna informações sobre o denunciante relacionadas à denúncia do Cofense Triage.

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
ID do relatório	String	N/A	Sim	Especifique o ID do relatório para o qual você quer recuperar os denunciantes.
Número máximo de denunciantes a serem retornados	Inteiro	50	Não	Especifique quantos repórteres serão retornados.

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/falso	is_success:False

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

Painel de casos

Tipo de resultado	Valor / Descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se for bem-sucedido(is_success = true): print "Successfully returned related reporters to the report with ID {0} in Cofense Triage.".format(report_id) Se não for bem-sucedido, ou seja, código de status 404(is_success = false): mostre "A ação não conseguiu retornar os repórteres relacionados ao relatório com o ID {0} no Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail) Se nenhuma regra for encontrada (is_success = false): mostre "No related reporters were found to the report with ID {0} in Cofense Triage.".format(report_id) A ação deve falhar e interromper a execução de um playbook: Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: exiba "Erro ao executar a ação 'Receber denunciantes do relatório'. Motivo: {0}''.format(error.Stacktrace)	Geral
CSV	Nome da tabela:denunciar {0} denunciantes Colunas da tabela: E-mail: e-mail Contagem de relatórios: reports_count Pontuação de reputação: reputation_score VIP: vip	Geral

Tipo de resultado

Valor / Descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se for bem-sucedido(is_success = true): print "Successfully returned related reporters to the report with ID {0} in Cofense Triage.".format(report_id)

Se não for bem-sucedido, ou seja, código de status 404(is_success = false): mostre "A ação não conseguiu retornar os repórteres relacionados ao relatório com o ID {0} no Cofense Triage. Motivo: \n {1}".format(report_id, errors/detail)

Se nenhuma regra for encontrada (is_success = false): mostre "No related reporters were found to the report with ID {0} in Cofense Triage.".format(report_id)

A ação deve falhar e interromper a execução de um playbook:

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: exiba "Erro ao executar a ação 'Receber denunciantes do relatório'. Motivo: {0}''.format(error.Stacktrace)

Geral

CSV

Nome da tabela:denunciar {0} denunciantes

Colunas da tabela:

E-mail: e-mail

Contagem de relatórios: reports_count

Pontuação de reputação: reputation_score

VIP: vip

Geral

Receber detalhes do indicador de ameaça

Descrição

Retorna informações sobre as entidades com base nos detalhes do indicador de ameaça da Cofense Triage.

Parâmetros

Nome de exibição do parâmetro
N/A

Corrida

Essa ação é executada em todas as entidades.

Resultados da ação

Enriquecimento de entidades

Nome do campo de aprimoramento	Lógica: quando aplicar
COFENSE_TRG_ti_id	Se disponível no resultado em JSON.
COFENSE_TRG_ti_type	Se disponível no resultado em JSON.
COFENSE_TRG_ti_threat_level	Se disponível no resultado em JSON.
COFENSE_TRG_ti_threat_source	Se disponível no resultado em JSON.
COFENSE_TRG_ti_created_at	Se disponível no resultado em JSON.
COFENSE_TRG_id_updated_at	Se disponível no resultado em JSON.

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/falso	is_success:False

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

Painel de casos

Tipo de resultado	Valor / Descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se for bem-sucedido para pelo menos uma entidade(is_success = true): print "Successfully returned threat indicator details about the following entities using Cofense Triage: \n {0}".format(entity.identifier list) Se for bem-sucedido para pelo menos uma entidade(is_success = true): mostre "A ação não conseguiu retornar detalhes do indicador de ameaça sobre as seguintes entidades usando o Cofense Triage: \n {0}".format(entity.identifier list) Se não for possível enriquecer todas as entidades (is_success = false): mostre "No threat indicator information about the entities was found". A ação deve falhar e interromper a execução de um playbook: Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: print "Error executing action "Get Threat Indicator Details". Motivo: {0}''.format(error.Stacktrace)	Geral
CSV	Campos que estão na seção da tabela de enriquecimento, mas sem o prefixo "COFENSE_TRG_"	Entidade

Tipo de resultado

Valor / Descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se for bem-sucedido para pelo menos uma entidade(is_success = true): print "Successfully returned threat indicator details about the following entities using Cofense Triage: \n {0}".format(entity.identifier list)

Se for bem-sucedido para pelo menos uma entidade(is_success = true): mostre "A ação não conseguiu retornar detalhes do indicador de ameaça sobre as seguintes entidades usando o Cofense Triage: \n {0}".format(entity.identifier list)

Se não for possível enriquecer todas as entidades (is_success = false): mostre "No threat indicator information about the entities was found".

A ação deve falhar e interromper a execução de um playbook:

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: print "Error executing action "Get Threat Indicator Details". Motivo: {0}''.format(error.Stacktrace)

Geral

CSV

Campos que estão na seção da tabela de enriquecimento, mas sem o prefixo "COFENSE_TRG_"

Entidade

Descrição

Lista as categorias disponíveis no Cofense Triage.

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Nomes	CSV	N/A	Não	Especifique uma lista separada por vírgulas de nomes de categorias. Esse parâmetro é útil para verificar se existe uma categoria com o nome especificado.
Pontuação mais baixa para buscar	Inteiro	N/A	Não	Especifique a pontuação mais baixa aceita para a categoria. Esse parâmetro pode funcionar com valores negativos.
Somente maliciosos	Caixa de seleção	Desmarcado	Não	Se ativada, a ação só vai retornar categorias maliciosas.
Somente arquivados	Caixa de seleção	Desmarcado	Não	Se ativada, a ação retorna apenas categorias arquivadas.
Somente não arquivados	Caixa de seleção	Desmarcado	Não	Se ativada, a ação retorna apenas categorias não arquivadas.
Somente não maliciosos	Caixa de seleção	Desmarcado	Não	Se ativada, a ação vai retornar apenas categorias não maliciosas.
Número máximo de categorias a serem retornadas	Inteiro	N/A	Não	Especifique o número de categorias a serem retornadas.

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/falso	is_success:False

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

Painel de casos

Tipo de resultado	Valor/descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se for bem-sucedido (is_success=true): "Successfully returned available categories from Cofense Triage." Se nenhuma categoria for encontrada (is_success=false): "Nenhuma categoria foi encontrada para os critérios." A ação deve falhar e interromper a execução de um playbook: Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Listar categorias'. Motivo: {0}''.format(error.Stacktrace)	Geral
Tabela do painel de casos	Nome da tabela:Available Categories Coluna da tabela: Nome - nome Pontuação - pontuação ID - id Mal-intencionado: mal-intencionado Arquivado - arquivado	Geral

Tipo de resultado

Valor/descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se for bem-sucedido (is_success=true): "Successfully returned available categories from Cofense Triage."

Se nenhuma categoria for encontrada (is_success=false): "Nenhuma categoria foi encontrada para os critérios."

A ação deve falhar e interromper a execução de um playbook:

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Listar categorias'. Motivo: {0}''.format(error.Stacktrace)

Geral

Tabela do painel de casos

Nome da tabela:Available Categories

Coluna da tabela:

Nome - nome
Pontuação - pontuação
ID - id
Mal-intencionado: mal-intencionado
Arquivado - arquivado

Geral

Listar playbooks

Descrição

Lista os playbooks disponíveis no Cofense Triage.

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Chave de filtro	DDL	Selecione uma opção. Valores possíveis: Nome Descrição	Não	Especifique a chave que precisa ser usada para filtrar playbooks.
Lógica de filtro	DDL	Não especificado Valores possíveis: Não especificado Igual Contém	Não	Especifique o tipo de lógica de filtro que deve ser aplicada. A lógica de filtragem funciona com base no valor fornecido no parâmetro "Chave de filtro". Observação:a lógica "É igual a" diferencia maiúsculas de minúsculas, enquanto "Contém" não diferencia.
Filtrar por valor	String	N/A	Não	Especifique o valor que deve ser usado no filtro. Se "Igual" for selecionado, a ação vai tentar encontrar a correspondência exata entre os resultados. Se "Contém" estiver selecionado, a ação vai tentar encontrar resultados que contenham essa substring. Se nada for fornecido nesse parâmetro, o filtro não será aplicado. A lógica de filtragem funciona com base no valor fornecido no parâmetro "Chave de filtro".
Número máximo de registros a serem retornados	Inteiro	50	Não	Especifique o número de registros a serem retornados. Se nada for fornecido, a ação vai retornar 50 registros. Máximo: 200

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/falso	is_success:False

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

Painel de casos

Tipo de resultado	Valor/descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se os dados estiverem disponíveis (is_success=true): "Playbooks encontrados para os critérios fornecidos no Cofense Triage." Se os dados não estiverem disponíveis (is_success=false): "Nenhum playbook foi encontrado para os critérios fornecidos no Cofense Triage". Se o parâmetro "Valor do filtro" estiver vazio (is_success=true): "O filtro não foi aplicado porque o parâmetro 'Valor do filtro' está vazio." Se o parâmetro "Lógica do filtro" estiver definido como "Não especificado" (is_success=true): "O filtro não foi aplicado porque o parâmetro 'Lógica do filtro' não foi especificado." A ação deve falhar e interromper a execução de um playbook: Se o parâmetro "Chave de filtro" estiver definido como "Selecionar um" e o parâmetro "Lógica de filtro" estiver definido como "Igual" ou "Contém": "Erro ao executar a ação '{action name}'. Motivo: é necessário selecionar um campo do parâmetro "Chave de filtro"." Se um valor inválido for fornecido para o parâmetro "Máximo de registros a serem retornados": "Erro ao executar a ação '{nome da ação}'. Motivo: "O valor fornecido para 'Máximo de registros a serem retornados' é inválido: `PROVIDED_VALUE`. É necessário informar um número positivo"." Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Listar playbooks'. Motivo: {0}''.format(error.Stacktrace)	Geral
Tabela do painel de casos	Nome da tabela:Available Playbooks Coluna da tabela: Nome - nome Ativo-ativo ID - id Descrição - description Tags: CSV de report_tags + cluster_tags Criado em - created_at	Geral

Tipo de resultado

Valor/descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se os dados estiverem disponíveis (is_success=true): "Playbooks encontrados para os critérios fornecidos no Cofense Triage."

Se os dados não estiverem disponíveis (is_success=false): "Nenhum playbook foi encontrado para os critérios fornecidos no Cofense Triage".

Se o parâmetro "Valor do filtro" estiver vazio (is_success=true): "O filtro não foi aplicado porque o parâmetro 'Valor do filtro' está vazio."

Se o parâmetro "Lógica do filtro" estiver definido como "Não especificado" (is_success=true): "O filtro não foi aplicado porque o parâmetro 'Lógica do filtro' não foi especificado."

A ação deve falhar e interromper a execução de um playbook:

Se o parâmetro "Chave de filtro" estiver definido como "Selecionar um" e o parâmetro "Lógica de filtro" estiver definido como "Igual" ou "Contém": "Erro ao executar a ação '{action name}'. Motivo: é necessário selecionar um campo do parâmetro "Chave de filtro"."

Se um valor inválido for fornecido para o parâmetro "Máximo de registros a serem retornados": "Erro ao executar a ação '{nome da ação}'. Motivo: "O valor fornecido para 'Máximo de registros a serem retornados' é inválido: PROVIDED_VALUE. É necessário informar um número positivo"."

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Listar playbooks'. Motivo: {0}''.format(error.Stacktrace)

Geral

Tabela do painel de casos

Nome da tabela:Available Playbooks

Coluna da tabela:

Nome - nome
Ativo-ativo
ID - id
Descrição - description
Tags: CSV de report_tags + cluster_tags
Criado em - created_at

Geral

Listar relatórios relacionados a indicadores de ameaças

Descrição

Lista relatórios relacionados a indicadores de ameaças no Cofense Triage.

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Criar tabela de parede de casos	Caixa de seleção	Desmarcado	Não	Se ativada, a ação vai criar uma tabela de mural de casos com informações sobre os relatórios.
Número máximo de relatórios a serem retornados	Inteiro	100	Não	Especifique quantos relatórios serão retornados.

Corrida

Essa ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/falso	is_success:False

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

Painel de casos

Tipo de resultado	Valor/descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se for bem-sucedido: "Os relatórios relacionados às entidades fornecidas pela Cofense Triage foram retornados." Se nenhum relatório for encontrado: "Nenhum relatório relacionado foi encontrado para as entidades fornecidas". A ação deve falhar e interromper a execução de um playbook: Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: "Erro ao executar a ação 'Listar relatórios relacionados a indicadores de ameaças'. Motivo: (error.Stacktrace)	Geral
Tabela do painel de casos	Nome da tabela:Relatórios relacionados Coluna da tabela: ID Assunto Criado em Local	Geral

Tipo de resultado

Valor/descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se for bem-sucedido: "Os relatórios relacionados às entidades fornecidas pela Cofense Triage foram retornados."
Se nenhum relatório for encontrado: "Nenhum relatório relacionado foi encontrado para as entidades fornecidas".

A ação deve falhar e interromper a execução de um playbook:

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: "Erro ao executar a ação 'Listar relatórios relacionados a indicadores de ameaças'. Motivo: (error.Stacktrace)

Geral

Tabela do painel de casos

Nome da tabela:Relatórios relacionados

Coluna da tabela:

Assunto

Criado em

Local

Geral

Ping

Descrição

Teste a conectividade com o Cofense Triage com os parâmetros fornecidos na página de configuração da integração na página do Google SecOps Content Hub.

Parâmetros

N/A

Corrida

Essa ação não é executada em entidades nem tem parâmetros de entrada obrigatórios.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/falso	is_success:False

Painel de casos

Tipo de resultado	Valor / Descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se for bem-sucedida: "Successfully connected to the Cofense Triage server with the provided connection parameters!" A ação deve falhar e interromper a execução de um playbook: Se não for concluída: "Falha ao se conectar ao servidor do Cofense Triage! O erro é {0}".format(exception.stacktrace)	Geral

Tipo de resultado

Valor / Descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se for bem-sucedida: "Successfully connected to the Cofense Triage server with the provided connection parameters!"

A ação deve falhar e interromper a execução de um playbook:

Se não for concluída: "Falha ao se conectar ao servidor do Cofense Triage! O erro é {0}".format(exception.stacktrace)

Geral

Conector

Cofense Triage - Conector de relatórios

Extraia relatórios do Cofense Triage.

Configurar o Cofense Triage - Conector de relatórios no Google SecOps

Para instruções detalhadas sobre como configurar um conector no Google SecOps, consulte Configurar o conector.

Parâmetros do conector

Use os seguintes parâmetros para configurar o conector:

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Nome do campo do produto	String	Nome do produto	Sim	Insira o nome do campo de origem para recuperar o nome do campo do produto.
Nome do campo do evento	String	local	Sim	Insira o nome do campo de origem para recuperar o nome do campo de evento.
Nome do campo do ambiente	String	""	Não	Descreve o nome do campo em que o nome do ambiente é armazenado. Se o campo de ambiente não for encontrado, o ambiente será o padrão.
Padrão Regex do ambiente	String	.*	Não	Um padrão de regex para ser executado no valor encontrado no campo "Nome do campo de ambiente". O padrão é .* para capturar tudo e retornar o valor inalterado. Usado para permitir que o usuário manipule o campo de ambiente usando a lógica de regex. Se o padrão de regex for nulo ou vazio, ou se o valor do ambiente for nulo, o resultado final será o ambiente padrão.
Tempo limite de script (segundos)	Inteiro	180	Sim	Limite de tempo limite para o processo do Python que executa o script atual.
Raiz da API	String	https://tap.phishmecloud.com	Sim	Raiz da API da instância do Cofense Triage.
ID do cliente	String	N/A	Sim	ID do cliente da conta do Cofense Triage.
Local do relatório	CSV	Caixa de entrada,Reconhecimento	Não	Lista separada por vírgulas de locais de relatórios em que o conector deve ingerir dados. Somente os relatórios dos locais fornecidos serão ingeridos. Os valores possíveis são os seguintes: Caixa de entrada Reconhecimento Processado Se nenhum valor for fornecido, o conector vai ingerir relatórios de todos os locais.
Chave secreta do cliente	Senha	N/A	Sim	Chave secreta do cliente da conta do Cofense Triage.
Pontuação de risco mais baixa para buscar	Inteiro	0	Sim	A menor pontuação de risco que será usada para buscar e-mails. O máximo é 100.
Categoria	CSV	N/A	Não	Lista separada por vírgulas de categorias usadas para filtrar os relatórios recebidos. O conector só vai ingerir um relatório se ele corresponder a pelo menos uma categoria da lista.
Buscar o máximo de horas anteriores	Inteiro	1	Não	Quantidade de horas de onde os e-mails serão buscados.
Número máximo de relatórios a serem buscados	Inteiro	10	Não	Quantos relatórios serão processados por iteração do conector.
Usar a lista de permissões como uma lista de bloqueio	Caixa de seleção	Desmarcado	Sim	Se ativada, a lista de permissões será usada como uma lista de bloqueio.
Verificar SSL	Caixa de seleção	Desmarcado	Sim	Se ativado, verifique se o certificado SSL da conexão com o servidor do Cofense Triage é válido.
Endereço do servidor proxy	String	N/A	Não	O endereço do servidor proxy a ser usado.
Nome de usuário do proxy	String	N/A	Não	O nome de usuário do proxy para autenticação.
Senha do proxy	Senha	N/A	Não	A senha do proxy para autenticação.

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.