Cisco ETD Connector v1.0.0

Cisco Email Threat Defense (ETD) integration for Cortex XSIAM providing ETD message event log ingestion, email threat analytics.

Author:
Nusummit
Support:
community
Default data source:
CiscoETDConnector
XSIAM
Analytics & SIEM

Integrations (1)

README

Cisco ETD Pack

Overview

The Cisco ETD Pack provides integration for Cisco Email Threat Defense (ETD) within Cortex XSIAM.

The pack enables ingestion, visualization, and monitoring of Cisco ETD Message Event Logs for email security analytics and threat visibility.

Included Content

Integrations

  • Cisco ETD Integration

What does this pack do?

  • Cisco ETD Message Event Log ingestion
  • Email threat classification
  • Email traffic trend visualization
  • XQL-based analytics

Supported Platform

  • Cortex XSIAM

This pack is intended for Cortex XSIAM Event Collection and is not supported on Cortex XSOAR.

Use Cases

  • Email threat monitoring
  • SIEM correlation
  • Email security analytics
  • Threat visibility and reporting

Supported Log Types

The integration ingests the following Cisco ETD log types:

  • Message Logs
  • Audit Logs
  • Connection Logs

Requirements

  • Cisco Email Threat Defense access
  • Cisco ETD API credentials
  • Cortex XSIAM instance

Configuration

Prerequisites

Before configuring the integration, ensure the following requirements are met:

  • Cisco Email Threat Defense (ETD) tenant access
  • Cisco ETD API credentials
  • Cortex XSIAM tenant with permissions to configure integrations

Obtain Cisco ETD API Credentials

  1. Log in to the Cisco ETD administration portal.
  2. Navigate to the API access or application management section.
  3. Create or locate an API application.

  4. Record the following values:

    • Client ID
    • Client Secret
    • API Key

Configure the Integration

  1. Navigate to Settings → Configurations → Integrations.
  2. Search for Cisco ETD Connector.
  3. Click Add Instance.
  4. Configure the following parameters:
Parameter Description
ETD Base URL Cisco ETD API URL (for example, https://your-etd-instance.example.com).
API Key Cisco ETD API Key
Client ID Cisco ETD Client ID
Client Secret Cisco ETD Client Secret
Fetch Events Enable continuous log ingestion into Cortex XSIAM
Use system proxy settings Enable if your environment requires a proxy

Note: You must enable Fetch Events for continuous log ingestion into Cortex XSIAM.

Verify Connectivity

  1. Click Test.
  2. Verify that the integration returns:
ok
  1. Click Save & Enable.

Log Collection

Once enabled, the integration automatically retrieves Cisco ETD logs and ingests them into Cortex XSIAM.

The integration collects the following log types:

  • Message Logs
  • Audit Logs
  • Connection Logs

Verify Data Ingestion

Successfully ingested events are available in the following dataset:

cisco_etd_raw

You can verify ingestion by running:

dataset = cisco_etd_raw
| limit 10

Dashboard Configuration

The Cisco ETD integration does not automatically deploy a Cortex XSIAM dashboard. After installing the integration and ingesting data into the cisco_etd_raw dataset, users can create a custom dashboard using the following widgets.

Create a Dashboard

  1. Navigate to Dashboards in Cortex XSIAM.
  2. Click Create Dashboard.
  3. Enter a dashboard name (for example, Cisco ETD Dashboard).
  4. Add the widgets described below.

Widget 1: Total ETD Logs

Visualization Type: Pie Chart

XQL Query:

dataset = cisco_etd_raw
| comp count() as log_count by source_log_type
| view graph type = pie xaxis = source_log_type yaxis = log_count

Purpose

Displays the distribution of ETD log types (Message, Audit, and Connection logs).

Widget 2: Email Classification Summary

Visualization Type: Pie Chart

XQL Query:

dataset = cisco_etd_raw
| filter source_log_type = "message"
| alter verdict = json_extract_scalar(message, "$.verdict.verdict")
| alter category = if(verdict in ("phishing", "bec", "scam", "malicious"), "Threat", if(verdict in ("spam", "graymail"), "Unwanted", "Legit"))
| comp count() as category_count by category
| view graph type = pie xaxis = category yaxis = category_count

Purpose

Provides a high-level classification of email activity into:

  • Threat
  • Unwanted
  • Legit

Widget 3: ETD Log Activity Trend

Visualization Type: Line Chart

XQL Query:

dataset = cisco_etd_raw
| comp count() as event_count by logDate, source_log_type
| sort asc logDate
| view graph type = line xaxis = logDate yaxis = event_count series = source_log_type

Purpose

Displays ETD activity trends over time and allows users to monitor ingestion volume by log type.

Recommended Dashboard Layout

Row Widget
Top Left Total ETD Logs
Top Right Email Classification Summary
Bottom (Full Width) ETD Log Activity Trend

This layout provides a high-level overview of Cisco ETD activity, email classification statistics, and ingestion trends within Cortex XSIAM.

Troubleshooting

Test Connection Fails

Verify:

  • ETD Base URL is correct
  • Client ID is valid
  • Client Secret is valid
  • API Key is valid
  • Network connectivity exists between Cortex XSIAM and Cisco ETD

No Events Ingested

Verify:

  • Fetch Events is enabled
  • Cisco ETD contains data for the selected time range
  • The dataset contains records

Run:

dataset = cisco_etd_raw
| limit 10

Dashboard Widgets Show No Data

Verify:

  • Events are present in the cisco_etd_raw dataset
  • The dashboard time range contains data
  • The XQL queries return results when executed manually in XQL Search

Run:

dataset = cisco_etd_raw
| limit 10

Author

Nusummit

Version

1.0.0