Skip to content

Cisco Duo Security

Overview

Cisco Duo Security offers solutions for strong authentication.

  • Vendor: Cisco
  • Supported environment: SaaS
  • Detection based on: Telemetry
  • Supported application or feature: Authentication logs

Configure

Generate Credentials

  1. Sign up for a Duo account.
  2. Log in to the Duo Admin Panel and navigate to Applications.
  3. Click Protect an Application and locate the entry for Admin API in the applications list. Click Protect to the far-right to configure the application and get your integration key, secret key, and API hostname. You'll need this information to complete your setup.
  4. Check Grant read log permission
  5. Click Save changes

More details in Duo documentation

Create the intake in Sekoia.io

Go to the intake page and create a new intake from the format Cisco Duo Security. Copy the intake key.

Pull events

To start to pull events, you have to:

  1. Go to the playbooks page and create a new playbook with the Fetch new logs from Duo trigger
  2. Set up the module configuration with the base URL of your Netskope instance. Set up the trigger configuration with the API token and the intake key
  3. Start the playbook and enjoy your events

Raw Events Samples

In this section, you will find examples of raw logs as generated natively by the source. These examples are provided to help integrators understand the data format before ingestion into Sekoia.io. It is crucial for setting up the correct parsing stages and ensuring that all relevant information is captured.

{
    "action": "admin_login",
    "description": "{\"ip_address\": \"1.2.3.4\", \"role\": \"Owner\", \"device\": \"+555 123456\", \"factor\": \"push\", \"primary_auth_method\": \"Password\"}",
    "isotimestamp": "2024-08-06T09:52:42+00:00",
    "object": null,
    "timestamp": 1722937962,
    "username": "John Doe",
    "eventtype": "admin_log",
    "host": "example.duosecurity.com"
}
{
    "eventtype": "admin_log",
    "action": "admin_login_error",
    "description": "{\"ip_address\": \"10.1.23.116\", \"error\": \"SAML login is disabled\", \"email\": \"narroway@example.com\"}",
    "isotimestamp": "2020-01-23T16:18:58+00:00",
    "object": null,
    "timestamp": 1579796338,
    "username": ""
}
{
    "eventtype": "admin_log",
    "action": "user_update",
    "description": "{\"notes\": \"Joe asked for their nickname to be displayed instead of Joseph.\", \"realname\": \"Joe Smith\"}",
    "isotimestamp": "2020-01-24T15:09:42+00:00",
    "object": "jsmith",
    "timestamp": 1579878582,
    "username": "admin"
}
{
    "eventtype": "auth_log",
    "access_device": {
        "browser": "Chrome",
        "browser_version": "67.0.3396.99",
        "flash_version": "uninstalled",
        "hostname": null,
        "ip": "169.232.89.219",
        "is_encryption_enabled": true,
        "is_firewall_enabled": true,
        "is_password_set": true,
        "java_version": "uninstalled",
        "location": {
            "city": "Ann Arbor",
            "country": "United States",
            "state": "Michigan"
        },
        "os": "Mac OS X",
        "os_version": "10.14.1",
        "security_agents": []
    },
    "adaptive_trust_assessments": {
        "more_secure_auth": {
            "features_version": "3.0",
            "model_version": "2022.07.19.001",
            "policy_enabled": false,
            "reason": "Normal level of trust; no detection of known attack pattern",
            "trust_level": "NORMAL"
        },
        "remember_me": {
            "features_version": "3.0",
            "model_version": "2022.07.19.001",
            "policy_enabled": false,
            "reason": "Known Access IP",
            "trust_level": "NORMAL"
        }
    },
    "alias": "",
    "application": {
        "key": "DIY231J8BR23QK4UKBY8",
        "name": "Microsoft Azure Active Directory"
    },
    "auth_device": {
        "ip": "192.168.225.254",
        "key": "DP5BJ05HI4WRBVI4Q7JF",
        "location": {
            "city": "Ann Arbor",
            "country": "United States",
            "state": "Michigan"
        },
        "name": "My iPhone X (734-555-2342)"
    },
    "email": "narroway@example.com",
    "event_type": "authentication",
    "factor": "duo_push",
    "isotimestamp": "2020-02-13T18:56:20.351346+00:00",
    "ood_software": null,
    "reason": "user_approved",
    "result": "success",
    "timestamp": 1581620180,
    "trusted_endpoint_status": "not trusted",
    "txid": "340a23e3-23f3-23c1-87dc-1491a23dfdbb",
    "user": {
        "groups": [
            "Duo Users",
            "CorpHQ Users"
        ],
        "key": "DU3KC77WJ06Y5HIV7XKQ",
        "name": "narroway@example.com"
    }
}
{
    "access_device": {
        "browser": "Electron",
        "browser_version": "11.5.0",
        "epkey": "EPKEYEXAMPLE",
        "flash_version": "uninstalled",
        "hostname": null,
        "ip": "1.2.3.4",
        "is_encryption_enabled": "unknown",
        "is_firewall_enabled": "unknown",
        "is_password_set": "unknown",
        "java_version": "uninstalled",
        "location": {
            "city": "Paris",
            "country": "France",
            "state": "\u00cele-de-France"
        },
        "os": "Windows",
        "os_version": "10"
    },
    "adaptive_trust_assessments": {
        "more_secure_auth": {
            "detected_attack_detectors": null,
            "features_version": "3.0",
            "model_version": "2022.07.19.001",
            "policy_enabled": false,
            "preview_mode_enabled": true,
            "reason": "Normal level of trust; no detection of known attack pattern",
            "trust_level": "NORMAL"
        },
        "remember_me": {
            "features_version": "3.0",
            "model_version": "2022.07.19.001",
            "policy_enabled": false,
            "reason": "Known Access IP",
            "trust_level": "NORMAL"
        }
    },
    "alias": "",
    "application": {
        "key": "APPLICATIONKEY",
        "name": "Fortigate VPN SSL - Single Sign-On"
    },
    "auth_device": {
        "ip": null,
        "key": null,
        "location": {
            "city": null,
            "country": null,
            "state": null
        },
        "name": null
    },
    "email": "john.doe@example.com",
    "event_type": "authentication",
    "factor": "remembered_device",
    "isotimestamp": "2024-08-06T13:06:35.435426+00:00",
    "ood_software": null,
    "rbfs_triggered_attacks": null,
    "reason": "remembered_device",
    "remembered_factor": "duo_push",
    "result": "success",
    "timestamp": 1722949595,
    "trusted_endpoint_status": "unknown",
    "txid": "9f79ad67-e7f5-4f33-850c-75175d79253a",
    "user": {
        "groups": [
            "GG_VPN_DUO (from AD sync \"AD Sync\")"
        ],
        "key": "EXAMPLEKEY",
        "name": "vsainterosemeril"
    },
    "eventtype": "auth_log",
    "host": "example.duosecurity.com"
}
{
    "eventtype": "offline_log",
    "action": "o2fa_user_provisioned",
    "description": "{\"user_agent\": \"DuoCredProv/4.0.6.413 (Windows NT 6.3.9600; x64; Server)\", \"hostname\": \"WKSW10x64\", \"factor\": \"duo_otp\"}",
    "isotimestamp": "2019-08-30T16:10:05+00:00",
    "object": "Acme Laptop Windows Logon",
    "timestamp": 1567181405,
    "username": "narroway"
}
{
    "eventtype": "telephony_log",
    "context": "administrator login",
    "credits": 0,
    "phone": "+13135559542",
    "telephony_id": "5bf1a860-fe39-49e3-be29-217659663a74",
    "ts": "2022-10-25T16:07:45.304526+00:00",
    "txid": "fb0c129b-f994-4d3d-953b-c3e764272eb7",
    "type": "sms"
}
{
    "eventtype": "telephony_log",
    "context": "authentication",
    "credits": 2,
    "phone": "+17345551311",
    "telephony_id": "60799fee-f08f-4ba8-971f-4e53b3473e9a",
    "ts": "2023-01-26T20:54:12.573580+00:00",
    "txid": "373bd5f3-1e42-4a5d-aefa-b33ae278fac8",
    "type": "phone"
}
{
    "eventtype": "telephony_log",
    "context": "enrollment",
    "credits": 1,
    "phone": "+12125556707",
    "telephony_id": "220f89ff-bff8-4466-b6cb-b7787940ce68",
    "ts": "2023-03-21T22:34:49.466370+00:00",
    "txid": "2f5d34d3-053f-422c-9dd4-77a5d58706b1",
    "type": "sms"
}

Detection section

The following section provides information for those who wish to learn more about the detection capabilities enabled by collecting this intake. It includes details about the built-in rule catalog, event categories, and ECS fields extracted from raw events. This is essential for users aiming to create custom detection rules, perform hunting activities, or pivot in the events page.

The following Sekoia.io built-in rules match the intake Cisco Duo Security. This documentation is updated automatically and is based solely on the fields used by the intake which are checked against our rules. This means that some rules will be listed but might not be relevant with the intake.

SEKOIA.IO x Cisco Duo Security on ATT&CK Navigator

Cryptomining

Detection of domain names potentially related to cryptomining activities.

  • Effort: master
Dynamic DNS Contacted

Detect communication with dynamic dns domain. This kind of domain is often used by attackers. This rule can trigger false positive in non-controlled environment because dynamic dns is not always malicious.

  • Effort: master
Entra ID Sign-In Via Known AiTM Phishing Kit

Detects a sign-in attempt from an IP address belonging to a known adversary-in-the-middle phishing kit.

  • Effort: elementary
Exfiltration Domain

Detects traffic toward a domain flagged as a possible exfiltration vector.

  • Effort: master
Nimbo-C2 User Agent

Nimbo-C2 Uses an unusual User-Agent format in its implants.

  • Effort: intermediate
Potential Bazar Loader User-Agents

Detects potential Bazar loader communications through the user-agent

  • Effort: elementary
Potential Lemon Duck User-Agent

Detects LemonDuck user agent. The format used two sets of alphabetical characters separated by dashes, for example "User-Agent: Lemon-Duck-[A-Z]-[A-Z]".

  • Effort: elementary
RSA SecurID Failed Authentification

Detects many failed attempts to authenticate followed by a successfull login for a super admin account.

  • Effort: advanced
Remote Access Tool Domain

Detects traffic toward a domain flagged as a Remote Administration Tool (RAT).

  • Effort: master
Remote Monitoring and Management Software - AnyDesk

Detect artifacts related to the installation or execution of the Remote Monitoring and Management tool AnyDesk.

  • Effort: master
SEKOIA.IO Intelligence Feed

Detect threats based on indicators of compromise (IOCs) collected by SEKOIA's Threat and Detection Research team.

  • Effort: elementary
Sekoia.io EICAR Detection

Detects observables in Sekoia.io CTI tagged as EICAR, which are fake samples meant to test detection.

  • Effort: master
TOR Usage Generic Rule

Detects TOR usage globally, whether the IP is a destination or source. TOR is short for The Onion Router, and it gets its name from how it works. TOR intercepts the network traffic from one or more apps on user’s computer, usually the user web browser, and shuffles it through a number of randomly-chosen computers before passing it on to its destination. This disguises user location, and makes it harder for servers to pick him/her out on repeat visits, or to tie together separate visits to different sites, this making tracking and surveillance more difficult. Before a network packet starts its journey, user’s computer chooses a random list of relays and repeatedly encrypts the data in multiple layers, like an onion. Each relay knows only enough to strip off the outermost layer of encryption, before passing what’s left on to the next relay in the list.

  • Effort: master

Event Categories

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

Data Source Description
Authentication logs Duo Security provides audit logs about authentication sessions

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

Name Values
Kind ``
Category authentication, iam
Type admin, info

Transformed Events Samples after Ingestion

This section demonstrates how the raw logs will be transformed by our parsers. It shows the extracted fields that will be available for use in the built-in detection rules and hunting activities in the events page. Understanding these transformations is essential for analysts to create effective detection mechanisms with custom detection rules and to leverage the full potential of the collected data.

{
    "message": "{\"action\": \"admin_login\", \"description\": \"{\\\"ip_address\\\": \\\"1.2.3.4\\\", \\\"role\\\": \\\"Owner\\\", \\\"device\\\": \\\"+555 123456\\\", \\\"factor\\\": \\\"push\\\", \\\"primary_auth_method\\\": \\\"Password\\\"}\", \"isotimestamp\": \"2024-08-06T09:52:42+00:00\", \"object\": null, \"timestamp\": 1722937962, \"username\": \"John Doe\", \"eventtype\": \"admin_log\", \"host\": \"example.duosecurity.com\"}",
    "event": {
        "action": "admin_login",
        "category": [
            "iam"
        ],
        "dataset": "admin_log",
        "type": [
            "admin"
        ]
    },
    "@timestamp": "2024-08-06T09:52:42Z",
    "duo": {
        "security": {
            "telephony": {
                "phone_number": "+555 123456"
            }
        }
    },
    "observer": {
        "hostname": "example.duosecurity.com",
        "product": "Duo Security",
        "vendor": "Duo"
    },
    "related": {
        "hosts": [
            "example.duosecurity.com"
        ],
        "ip": [
            "1.2.3.4"
        ],
        "user": [
            "John Doe"
        ]
    },
    "source": {
        "address": "1.2.3.4",
        "ip": "1.2.3.4"
    },
    "user": {
        "name": "John Doe"
    }
}
{
    "message": "{\"eventtype\": \"admin_log\", \"action\": \"admin_login_error\", \"description\": \"{\\\"ip_address\\\": \\\"10.1.23.116\\\", \\\"error\\\": \\\"SAML login is disabled\\\", \\\"email\\\": \\\"narroway@example.com\\\"}\", \"isotimestamp\": \"2020-01-23T16:18:58+00:00\", \"object\": null, \"timestamp\": 1579796338, \"username\": \"\"}",
    "event": {
        "action": "admin_login_error",
        "category": [
            "iam"
        ],
        "dataset": "admin_log",
        "reason": "SAML login is disabled",
        "type": [
            "admin"
        ]
    },
    "@timestamp": "2020-01-23T16:18:58Z",
    "observer": {
        "product": "Duo Security",
        "vendor": "Duo"
    },
    "related": {
        "ip": [
            "10.1.23.116"
        ]
    },
    "source": {
        "address": "10.1.23.116",
        "ip": "10.1.23.116"
    },
    "user": {
        "email": "narroway@example.com"
    }
}
{
    "message": "{\"eventtype\": \"admin_log\", \"action\": \"user_update\", \"description\": \"{\\\"notes\\\": \\\"Joe asked for their nickname to be displayed instead of Joseph.\\\", \\\"realname\\\": \\\"Joe Smith\\\"}\", \"isotimestamp\": \"2020-01-24T15:09:42+00:00\", \"object\": \"jsmith\", \"timestamp\": 1579878582, \"username\": \"admin\"}",
    "event": {
        "action": "user_update",
        "category": [
            "iam"
        ],
        "dataset": "admin_log",
        "type": [
            "admin"
        ]
    },
    "@timestamp": "2020-01-24T15:09:42Z",
    "duo": {
        "security": {
            "object": "jsmith"
        }
    },
    "observer": {
        "product": "Duo Security",
        "vendor": "Duo"
    },
    "related": {
        "user": [
            "admin"
        ]
    },
    "user": {
        "name": "admin"
    }
}
{
    "message": "{\"eventtype\": \"auth_log\", \"access_device\": {\"browser\": \"Chrome\", \"browser_version\": \"67.0.3396.99\", \"flash_version\": \"uninstalled\", \"hostname\": null, \"ip\": \"169.232.89.219\", \"is_encryption_enabled\": true, \"is_firewall_enabled\": true, \"is_password_set\": true, \"java_version\": \"uninstalled\", \"location\": {\"city\": \"Ann Arbor\", \"country\": \"United States\", \"state\": \"Michigan\"}, \"os\": \"Mac OS X\", \"os_version\": \"10.14.1\", \"security_agents\": []}, \"adaptive_trust_assessments\": {\"more_secure_auth\": {\"features_version\": \"3.0\", \"model_version\": \"2022.07.19.001\", \"policy_enabled\": false, \"reason\": \"Normal level of trust; no detection of known attack pattern\", \"trust_level\": \"NORMAL\"}, \"remember_me\": {\"features_version\": \"3.0\", \"model_version\": \"2022.07.19.001\", \"policy_enabled\": false, \"reason\": \"Known Access IP\", \"trust_level\": \"NORMAL\"}}, \"alias\": \"\", \"application\": {\"key\": \"DIY231J8BR23QK4UKBY8\", \"name\": \"Microsoft Azure Active Directory\"}, \"auth_device\": {\"ip\": \"192.168.225.254\", \"key\": \"DP5BJ05HI4WRBVI4Q7JF\", \"location\": {\"city\": \"Ann Arbor\", \"country\": \"United States\", \"state\": \"Michigan\"}, \"name\": \"My iPhone X (734-555-2342)\"}, \"email\": \"narroway@example.com\", \"event_type\": \"authentication\", \"factor\": \"duo_push\", \"isotimestamp\": \"2020-02-13T18:56:20.351346+00:00\", \"ood_software\": null, \"reason\": \"user_approved\", \"result\": \"success\", \"timestamp\": 1581620180, \"trusted_endpoint_status\": \"not trusted\", \"txid\": \"340a23e3-23f3-23c1-87dc-1491a23dfdbb\", \"user\": {\"groups\": [\"Duo Users\", \"CorpHQ Users\"], \"key\": \"DU3KC77WJ06Y5HIV7XKQ\", \"name\": \"narroway@example.com\"}}",
    "event": {
        "category": [
            "authentication"
        ],
        "dataset": "auth_log",
        "type": [
            "info"
        ]
    },
    "@timestamp": "2020-02-13T18:56:20.351346Z",
    "host": {
        "os": {
            "name": "Mac OS X",
            "version": "10.14.1"
        }
    },
    "observer": {
        "product": "Duo Security",
        "vendor": "Duo"
    },
    "related": {
        "ip": [
            "169.232.89.219"
        ],
        "user": [
            "narroway@example.com"
        ]
    },
    "source": {
        "address": "169.232.89.219",
        "geo": {
            "city_name": "Ann Arbor",
            "country_name": "United States",
            "region_name": "Michigan"
        },
        "ip": "169.232.89.219"
    },
    "user": {
        "email": "narroway@example.com",
        "id": "DU3KC77WJ06Y5HIV7XKQ",
        "name": "narroway@example.com",
        "roles": [
            "CorpHQ Users",
            "Duo Users"
        ]
    },
    "user_agent": {
        "name": "Chrome",
        "version": "67.0.3396.99"
    }
}
{
    "message": "{\"access_device\": {\"browser\": \"Electron\", \"browser_version\": \"11.5.0\", \"epkey\": \"EPKEYEXAMPLE\", \"flash_version\": \"uninstalled\", \"hostname\": null, \"ip\": \"1.2.3.4\", \"is_encryption_enabled\": \"unknown\", \"is_firewall_enabled\": \"unknown\", \"is_password_set\": \"unknown\", \"java_version\": \"uninstalled\", \"location\": {\"city\": \"Paris\", \"country\": \"France\", \"state\": \"\\u00cele-de-France\"}, \"os\": \"Windows\", \"os_version\": \"10\"}, \"adaptive_trust_assessments\": {\"more_secure_auth\": {\"detected_attack_detectors\": null, \"features_version\": \"3.0\", \"model_version\": \"2022.07.19.001\", \"policy_enabled\": false, \"preview_mode_enabled\": true, \"reason\": \"Normal level of trust; no detection of known attack pattern\", \"trust_level\": \"NORMAL\"}, \"remember_me\": {\"features_version\": \"3.0\", \"model_version\": \"2022.07.19.001\", \"policy_enabled\": false, \"reason\": \"Known Access IP\", \"trust_level\": \"NORMAL\"}}, \"alias\": \"\", \"application\": {\"key\": \"APPLICATIONKEY\", \"name\": \"Fortigate VPN SSL - Single Sign-On\"}, \"auth_device\": {\"ip\": null, \"key\": null, \"location\": {\"city\": null, \"country\": null, \"state\": null}, \"name\": null}, \"email\": \"john.doe@example.com\", \"event_type\": \"authentication\", \"factor\": \"remembered_device\", \"isotimestamp\": \"2024-08-06T13:06:35.435426+00:00\", \"ood_software\": null, \"rbfs_triggered_attacks\": null, \"reason\": \"remembered_device\", \"remembered_factor\": \"duo_push\", \"result\": \"success\", \"timestamp\": 1722949595, \"trusted_endpoint_status\": \"unknown\", \"txid\": \"9f79ad67-e7f5-4f33-850c-75175d79253a\", \"user\": {\"groups\": [\"GG_VPN_DUO (from AD sync \\\"AD Sync\\\")\"], \"key\": \"EXAMPLEKEY\", \"name\": \"vsainterosemeril\"}, \"eventtype\": \"auth_log\", \"host\": \"example.duosecurity.com\"}",
    "event": {
        "category": [
            "authentication"
        ],
        "dataset": "auth_log",
        "type": [
            "info"
        ]
    },
    "@timestamp": "2024-08-06T13:06:35.435426Z",
    "host": {
        "os": {
            "name": "Windows",
            "version": "10"
        }
    },
    "observer": {
        "hostname": "example.duosecurity.com",
        "product": "Duo Security",
        "vendor": "Duo"
    },
    "related": {
        "hosts": [
            "example.duosecurity.com"
        ],
        "ip": [
            "1.2.3.4"
        ],
        "user": [
            "vsainterosemeril"
        ]
    },
    "source": {
        "address": "1.2.3.4",
        "geo": {
            "city_name": "Paris",
            "country_name": "France",
            "region_name": "\u00cele-de-France"
        },
        "ip": "1.2.3.4"
    },
    "user": {
        "email": "john.doe@example.com",
        "id": "EXAMPLEKEY",
        "name": "vsainterosemeril",
        "roles": [
            "GG_VPN_DUO (from AD sync \"AD Sync\")"
        ]
    },
    "user_agent": {
        "name": "Electron",
        "version": "11.5.0"
    }
}
{
    "message": "{\"eventtype\": \"offline_log\", \"action\": \"o2fa_user_provisioned\", \"description\": \"{\\\"user_agent\\\": \\\"DuoCredProv/4.0.6.413 (Windows NT 6.3.9600; x64; Server)\\\", \\\"hostname\\\": \\\"WKSW10x64\\\", \\\"factor\\\": \\\"duo_otp\\\"}\", \"isotimestamp\": \"2019-08-30T16:10:05+00:00\", \"object\": \"Acme Laptop Windows Logon\", \"timestamp\": 1567181405, \"username\": \"narroway\"}",
    "event": {
        "action": "o2fa_user_provisioned",
        "category": [
            "authentication"
        ],
        "dataset": "offline_log",
        "type": [
            "info"
        ]
    },
    "@timestamp": "2019-08-30T16:10:05Z",
    "duo": {
        "security": {
            "object": "Acme Laptop Windows Logon"
        }
    },
    "host": {
        "name": "WKSW10x64"
    },
    "observer": {
        "product": "Duo Security",
        "vendor": "Duo"
    },
    "related": {
        "user": [
            "narroway"
        ]
    },
    "user": {
        "name": "narroway"
    },
    "user_agent": {
        "device": {
            "name": "Other"
        },
        "name": "Other",
        "original": "DuoCredProv/4.0.6.413 (Windows NT 6.3.9600; x64; Server)",
        "os": {
            "name": "Windows",
            "version": "8.1"
        }
    }
}
{
    "message": "{\"eventtype\": \"telephony_log\", \"context\": \"administrator login\", \"credits\": 0, \"phone\": \"+13135559542\", \"telephony_id\": \"5bf1a860-fe39-49e3-be29-217659663a74\", \"ts\": \"2022-10-25T16:07:45.304526+00:00\", \"txid\": \"fb0c129b-f994-4d3d-953b-c3e764272eb7\", \"type\": \"sms\"}",
    "event": {
        "category": [
            "authentication"
        ],
        "dataset": "telephony_log",
        "reason": "administrator login",
        "type": [
            "info"
        ]
    },
    "duo": {
        "security": {
            "telephony": {
                "phone_number": "+13135559542",
                "type": "sms"
            }
        }
    },
    "observer": {
        "product": "Duo Security",
        "vendor": "Duo"
    }
}
{
    "message": "{\"eventtype\": \"telephony_log\", \"context\": \"authentication\", \"credits\": 2, \"phone\": \"+17345551311\", \"telephony_id\": \"60799fee-f08f-4ba8-971f-4e53b3473e9a\", \"ts\": \"2023-01-26T20:54:12.573580+00:00\", \"txid\": \"373bd5f3-1e42-4a5d-aefa-b33ae278fac8\", \"type\": \"phone\"}",
    "event": {
        "category": [
            "authentication"
        ],
        "dataset": "telephony_log",
        "reason": "authentication",
        "type": [
            "info"
        ]
    },
    "duo": {
        "security": {
            "telephony": {
                "phone_number": "+17345551311",
                "type": "phone"
            }
        }
    },
    "observer": {
        "product": "Duo Security",
        "vendor": "Duo"
    }
}
{
    "message": "{\"eventtype\": \"telephony_log\", \"context\": \"enrollment\", \"credits\": 1, \"phone\": \"+12125556707\", \"telephony_id\": \"220f89ff-bff8-4466-b6cb-b7787940ce68\", \"ts\": \"2023-03-21T22:34:49.466370+00:00\", \"txid\": \"2f5d34d3-053f-422c-9dd4-77a5d58706b1\", \"type\": \"sms\"}",
    "event": {
        "category": [
            "authentication"
        ],
        "dataset": "telephony_log",
        "reason": "enrollment",
        "type": [
            "info"
        ]
    },
    "duo": {
        "security": {
            "telephony": {
                "phone_number": "+12125556707",
                "type": "sms"
            }
        }
    },
    "observer": {
        "product": "Duo Security",
        "vendor": "Duo"
    }
}

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.
duo.security.object keyword The object that was acted on
duo.security.telephony.phone_number keyword The phone number that initiated this event
duo.security.telephony.type keyword The telephony event type. Either 'sms' or 'phone'
event.action keyword The action captured by the event.
event.category keyword Event category. The second categorization field in the hierarchy.
event.dataset keyword Name of the dataset.
event.reason keyword Reason why this event happened, according to the source
event.type keyword Event type. The third categorization field in the hierarchy.
host.name keyword Name of the host.
host.os.name keyword Operating system name, without the version.
host.os.version keyword Operating system version as a raw string.
observer.hostname keyword Hostname of the observer.
observer.product keyword The product name of the observer.
observer.vendor keyword Vendor name of the observer.
source.geo.city_name keyword City name.
source.geo.country_name keyword Country name.
source.geo.region_name keyword Region name.
source.ip ip IP address of the source.
user.email keyword User email address.
user.id keyword Unique identifier of the user.
user.name keyword Short name or login of the user.
user.roles keyword Array of user roles at the time of the event.
user_agent.name keyword Name of the user agent.
user_agent.original keyword Unparsed user_agent string.
user_agent.version keyword Version of the user agent.

For more information on the Intake Format, please find the code of the Parser, Smart Descriptions, and Supported Events here.