Skip to content

Trend Micro Email Security

Overview

Trend Micro Email Security is a robust email protection solution that safeguards against email-borne threats such as phishing, malware, and spam, offering advanced threat detection and content filtering to secure corporate email communications effectively.

Warning

Important note - This format is currently in beta. We highly value your feedback to improve its performance.

Event Categories

The following table lists the data source offered by this integration.

Data Source Description
Email gateway Trend Micro Email Security generates mail tracking logs.

In details, the following table denotes the type of events produced by this integration.

Name Values
Kind ``
Category email
Type info

Event Samples

Find below few samples of events and how they are normalized by Sekoia.io.

{
    "message": "{\"size\": 8245, \"action\": \"Bounced\", \"mailID\": \"b879ff84-55a3-4813-be99-9e0386a446f7\", \"sender\": \"noreply@example.org\", \"details\": \"mail for example.org loops back to myself\", \"genTime\": \"2023-09-28T13:55:45Z\", \"subject\": \"My subject\", \"tlsInfo\": \"upstreamTLS: TLS 1.2; downstreamTLS: None\", \"headerTo\": [\"jane.doe@example.org\"], \"senderIP\": \"1.2.3.4\", \"direction\": \"out\", \"messageID\": \"<22222222222222222222222222222222222222222222222222222222@EXAMPLE>\", \"recipient\": \"jane.doe@example.org\", \"timestamp\": \"2023-09-28T13:55:33Z\", \"headerFrom\": \"noreply@example.org\", \"deliveredTo\": \"none\", \"deliveryTime\": \"2023-09-28T13:55:33Z\"}",
    "event": {
        "action": "Bounced",
        "category": [
            "email"
        ],
        "type": [
            "info"
        ]
    },
    "@timestamp": "2023-09-28T13:55:33Z",
    "email": {
        "from": {
            "address": "noreply@example.org"
        },
        "local_id": "b879ff84-55a3-4813-be99-9e0386a446f7",
        "message_id": "22222222222222222222222222222222222222222222222222222222@EXAMPLE",
        "sender": {
            "address": "noreply@example.org"
        },
        "subject": "My subject",
        "to": {
            "address": [
                "jane.doe@example.org"
            ]
        }
    }
}
{
    "message": "{\"size\": 2538013, \"action\": \"Delivered\", \"mailID\": \"b879ff84-55a3-4813-be99-9e0386a446f7\", \"sender\": \"john.doe@example.org\", \"details\": \"250 2.0.0 1z3r022fdx-1 Message accepted for delivery\", \"genTime\": \"2023-09-28T13:51:23Z\", \"subject\": \"Automn is coming\", \"tlsInfo\": \"upstreamTLS: TLS 1.2; downstreamTLS: TLS 1.2\", \"headerTo\": [\"jane.doe@example.org\", \"cedric.martin@example.org\"], \"senderIP\": \"1.2.3.4\", \"direction\": \"out\", \"messageID\": \"<11111111111111111111111111111111111111@example.org>\", \"recipient\": \"jane.doe@example.org\", \"timestamp\": \"2023-09-28T13:51:13Z\", \"headerFrom\": \"john.doe@example.org\", \"attachments\": [{\"sha256\": \"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b\", \"fileName\": \"attachment.pdf\"}], \"deliveredTo\": \"antispam.example.org[5.6.7.8]:25\", \"deliveryTime\": \"2023-09-28T13:51:18Z\", \"embeddedUrls\": [\"https://aws.amazon.com\", \"https://cloud.google.com\", \"https://www.azure.com\"]}",
    "event": {
        "action": "Delivered",
        "category": [
            "email"
        ],
        "type": [
            "info"
        ]
    },
    "@timestamp": "2023-09-28T13:51:13Z",
    "email": {
        "attachments": [
            {
                "file": {
                    "hash": "01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b",
                    "name": "attachment.pdf"
                }
            }
        ],
        "from": {
            "address": "john.doe@example.org"
        },
        "local_id": "b879ff84-55a3-4813-be99-9e0386a446f7",
        "message_id": "11111111111111111111111111111111111111@example.org",
        "sender": {
            "address": "john.doe@example.org"
        },
        "subject": "Automn is coming",
        "to": {
            "address": [
                "cedric.martin@example.org",
                "jane.doe@example.org"
            ]
        }
    },
    "trendmicro": {
        "email": {
            "embedded_urls": [
                "https://aws.amazon.com",
                "https://cloud.google.com",
                "https://www.azure.com"
            ]
        }
    }
}
{
    "message": "{\"size\": 51149, \"action\": \"Quarantined\", \"mailID\": \"b879ff84-55a3-4813-be99-9e0386a446f7\", \"sender\": \"john.doe@example.org\", \"genTime\": \"2023-09-28T13:47:18Z\", \"subject\": \"My beautiful subject\", \"headerTo\": [\"jane.doe@example.org\"], \"direction\": \"in\", \"messageID\": \"<11111111111111111111111111111111111111111111111111111111111111111@example.org>\", \"recipient\": \"jane.doe@example.org\", \"timestamp\": \"2023-09-28T13:45:59Z\", \"headerFrom\": \"john.doe@example.org\", \"embeddedUrls\": [\"https://sekoia.io\", \"https://www.nytimes.com\"]}",
    "event": {
        "action": "Quarantined",
        "category": [
            "email"
        ],
        "type": [
            "info"
        ]
    },
    "@timestamp": "2023-09-28T13:45:59Z",
    "email": {
        "from": {
            "address": "john.doe@example.org"
        },
        "local_id": "b879ff84-55a3-4813-be99-9e0386a446f7",
        "message_id": "11111111111111111111111111111111111111111111111111111111111111111@example.org",
        "sender": {
            "address": "john.doe@example.org"
        },
        "subject": "My beautiful subject",
        "to": {
            "address": [
                "jane.doe@example.org"
            ]
        }
    },
    "trendmicro": {
        "email": {
            "embedded_urls": [
                "https://sekoia.io",
                "https://www.nytimes.com"
            ]
        }
    }
}
{
    "message": "{\"size\": 48984, \"action\": \"Scanning in sandbox\", \"mailID\": \"b879ff84-55a3-4813-be99-9e0386a446f7\", \"sender\": \"bounce@example.org\", \"genTime\": \"2023-09-28T13:55:53Z\", \"subject\": \"My beautiful subject\", \"tlsInfo\": \"upstreamTLS: TLS 1.3\", \"headerTo\": [\"jane.doe@example.org\"], \"senderIP\": \"1.2.3.4\", \"direction\": \"in\", \"messageID\": \"<11111111111111111111111111111111@example.org>\", \"recipient\": \"jane.doe@example.org\", \"timestamp\": \"2023-09-28T13:55:44Z\", \"headerFrom\": \"john.doe@example.org\", \"embeddedUrls\": [\"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\", \"https://lemonde.fr\"]}",
    "event": {
        "action": "Scanning in sandbox",
        "category": [
            "email"
        ],
        "type": [
            "info"
        ]
    },
    "@timestamp": "2023-09-28T13:55:44Z",
    "email": {
        "from": {
            "address": "john.doe@example.org"
        },
        "local_id": "b879ff84-55a3-4813-be99-9e0386a446f7",
        "message_id": "11111111111111111111111111111111@example.org",
        "sender": {
            "address": "bounce@example.org"
        },
        "subject": "My beautiful subject",
        "to": {
            "address": [
                "jane.doe@example.org"
            ]
        }
    },
    "trendmicro": {
        "email": {
            "embedded_urls": [
                "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd",
                "https://lemonde.fr"
            ]
        }
    }
}

Extracted Fields

The following table lists the fields that are extracted, normalized under the ECS format, analyzed and indexed by the parser. It should be noted that infered fields are not listed.

Name Type Description
@timestamp date Date/time when the event originated.
email.attachments nested List of objects describing the attachments.
email.from.address keyword The sender's email address.
email.local_id keyword Unique identifier given by the source.
email.message_id wildcard Value from the Message-ID header.
email.sender.address keyword Address of the message sender.
email.subject keyword The subject of the email message.
email.to.address keyword Email address of recipient
event.action keyword The action captured by the event.
event.category keyword Event category. The second categorization field in the hierarchy.
event.type keyword Event type. The third categorization field in the hierarchy.
trendmicro.email.embedded_urls array

Configure

How to get an API key

  1. Log on to the Trend Micro Email Security administrator console.
  2. Go to Administration

Step 1

  1. Click on Service Integration. The API Access tab displays by default.

Click on Service Integration

  1. Click Add to generate an API Key.

Click on Add

  1. Copy the API Key value and save the value. Keep the API Key private

Create your intake

  1. Go to the intake page and create a new intake from the Trend Micro Email Security.
  2. Copy the associated Intake key

Pull the logs to collect them on Sekoia.io

Go to the Sekoia.io playbook page, and follow these steps:

  1. Click on + PLAYBOOK button to create a new one
  2. Select Create a playbook from scratch
  3. Give it a name in the field Name
  4. Open the left panel, click Trend Micro Email Security then select the trigger Fetch new logs
  5. Click on Create

  6. Create a Trigger configuration using your Service URL, Username, API key and Intake key. All four are required.

  7. API key is created on the first step

  8. username is your Login ID entered during account creating
  9. The value of service URL varies according to your location:
Location Service URL
North America, Latin America and Asia Pacific api.tmes.trendmicro.com
Europe, the Middle East and Africa api.tmes.trendmicro.eu
Australia and New Zealand api.tmes-anz.trendmicro.com
Japan api.tmems-jp.trendmicro.com
Singapore api.tmes-sg.trendmicro.com
India api.tmes-in.trendmicro.com
  • Type the Intake key created on the previous step

  • Click on the Save button

  • Activate the playbook with the toggle button in the top right corner of the page

Enjoy your events on the Events page