Cisco IOS

Overview

Cisco IOS is a network operating system for Cisco ASR routers and Cisco Catalyst switches.

Related Built-in Rules

The following Sekoia.io built-in rules match the intake Cisco IOS router and switch. 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 IOS router and switch on ATT&CK Navigator

RYUK Ransomeware - martinstevens Username

Detects user name "martinstevens". Wizard Spider is used to add the user name "martinstevens" to the AD of its victims. It was observed in several campaigns; in 2019 and 2020.

• Effort: elementary

SEKOIA.IO Intelligence Feed

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

• Effort: elementary

Event Categories

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

Data Source	Description
Host network interface	every packets are logged and information on the outcome, the source/destination are extracted
Network device logs	ACL logs are examined in detail
Network protocol analysis	packets are fully analyzed

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

Name	Values
Kind	event
Category	host
Type	``

Event Samples

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

test_lineproto_down.jsontest_lineproto_up.jsontest_link_down.jsontest_link_up.jsontest_login.jsontest_login_failed.jsontest_logout.jsontest_sys_macflap.jsontest_tty_expired.json

{
    "message": "FE03.LOCAL: Mar 6 2023 08:04:45.866 CET: %LINEPROTO-5-UPDOWN: Line protocol on Interface GigabitEthernet1/0/13, changed state to down",
    "event": {
        "action": "down",
        "category": [
            "host"
        ],
        "code": "UPDOWN",
        "kind": "event",
        "reason": "Line protocol on Interface GigabitEthernet1/0/13, changed state to down",
        "severity": 5,
        "type": [
            "info"
        ]
    },
    "@timestamp": "2023-03-06T07:04:45.866000Z",
    "cisco": {
        "ios": {
            "event": {
                "facility": "LINEPROTO"
            },
            "observer": {
                "interface": {
                    "name": "GigabitEthernet1/0/13"
                }
            }
        }
    },
    "host": {
        "name": "FE03.LOCAL"
    },
    "observer": {
        "product": "ios",
        "vendor": "Cisco"
    }
}

{
    "message": "STN01.LOCAL: Mar 6 2023 08:04:45.866 CET: %LINEPROTO-5-UPDOWN: Line protocol on Interface GigabitEthernet1/0/13, changed state to up",
    "event": {
        "action": "up",
        "category": [
            "host"
        ],
        "code": "UPDOWN",
        "kind": "event",
        "reason": "Line protocol on Interface GigabitEthernet1/0/13, changed state to up",
        "severity": 5,
        "type": [
            "info"
        ]
    },
    "@timestamp": "2023-03-06T07:04:45.866000Z",
    "cisco": {
        "ios": {
            "event": {
                "facility": "LINEPROTO"
            },
            "observer": {
                "interface": {
                    "name": "GigabitEthernet1/0/13"
                }
            }
        }
    },
    "host": {
        "name": "STN01.LOCAL"
    },
    "observer": {
        "product": "ios",
        "vendor": "Cisco"
    }
}

{
    "message": "FE05: Mar 6 2023 08:04:45.866: %LINK-3-UPDOWN: Interface GigabitEthernet2/0/13, changed state to down",
    "event": {
        "action": "down",
        "category": [
            "host"
        ],
        "code": "UPDOWN",
        "kind": "event",
        "reason": "Interface GigabitEthernet2/0/13, changed state to down",
        "severity": 3,
        "type": [
            "info"
        ]
    },
    "@timestamp": "2023-03-06T08:04:45.866000Z",
    "cisco": {
        "ios": {
            "event": {
                "facility": "LINK"
            },
            "observer": {
                "interface": {
                    "name": "GigabitEthernet2/0/13"
                }
            }
        }
    },
    "host": {
        "name": "FE05"
    },
    "observer": {
        "product": "ios",
        "vendor": "Cisco"
    }
}

{
    "message": "FE05: Mar 6 2023 08:04:45.866: %LINK-3-UPDOWN: Interface GigabitEthernet2/0/25, changed state to up",
    "event": {
        "action": "up",
        "category": [
            "host"
        ],
        "code": "UPDOWN",
        "kind": "event",
        "reason": "Interface GigabitEthernet2/0/25, changed state to up",
        "severity": 3,
        "type": [
            "info"
        ]
    },
    "@timestamp": "2023-03-06T08:04:45.866000Z",
    "cisco": {
        "ios": {
            "event": {
                "facility": "LINK"
            },
            "observer": {
                "interface": {
                    "name": "GigabitEthernet2/0/25"
                }
            }
        }
    },
    "host": {
        "name": "FE05"
    },
    "observer": {
        "product": "ios",
        "vendor": "Cisco"
    }
}

{
    "message": "FE08: Jan 13 2023 10:16:05.33: %SEC_LOGIN-5-LOGIN_SUCCESS: Login Success [user: jdoe] [Source: 1.2.3.4] [localport: 22] at 10:16:05 GMT Fri Jan 13 2023",
    "event": {
        "category": [
            "host"
        ],
        "code": "LOGIN_SUCCESS",
        "kind": "event",
        "reason": "Login Success [user: jdoe] [Source: 1.2.3.4] [localport: 22] at 10:16:05 GMT Fri Jan 13 2023",
        "severity": 5,
        "type": [
            "access",
            "start"
        ]
    },
    "@timestamp": "2023-01-13T10:16:05.330000Z",
    "cisco": {
        "ios": {
            "event": {
                "facility": "SEC_LOGIN"
            }
        }
    },
    "host": {
        "name": "FE08"
    },
    "observer": {
        "product": "ios",
        "vendor": "Cisco"
    },
    "related": {
        "ip": [
            "1.2.3.4"
        ],
        "user": [
            "jdoe"
        ]
    },
    "source": {
        "address": "1.2.3.4",
        "ip": "1.2.3.4",
        "port": 22
    },
    "user": {
        "name": "jdoe"
    }
}

{
    "message": "FE08: Jan 13 2023 10:16:05.33: %SYS-3-LOGGINGHOST_FAIL: Logging to host 3.2.4.5 port 514 failed",
    "event": {
        "category": [
            "host"
        ],
        "code": "LOGGINGHOST_FAIL",
        "kind": "event",
        "reason": "Logging to host 3.2.4.5 port 514 failed",
        "severity": 3,
        "type": [
            "access",
            "end"
        ]
    },
    "@timestamp": "2023-01-13T10:16:05.330000Z",
    "cisco": {
        "ios": {
            "event": {
                "facility": "SYS"
            }
        }
    },
    "destination": {
        "address": "3.2.4.5",
        "ip": "3.2.4.5",
        "port": 514
    },
    "host": {
        "name": "FE08"
    },
    "observer": {
        "product": "ios",
        "vendor": "Cisco"
    },
    "related": {
        "ip": [
            "3.2.4.5"
        ]
    }
}

{
    "message": "FE08: Jan 13 2023 10:16:05.33: %SYS-6-LOGOUT: User jdoe has exited tty session 2(1.2.3.4)",
    "event": {
        "category": [
            "host"
        ],
        "code": "LOGOUT",
        "kind": "event",
        "reason": "User jdoe has exited tty session 2(1.2.3.4)",
        "severity": 6,
        "type": [
            "access",
            "end"
        ]
    },
    "@timestamp": "2023-01-13T10:16:05.330000Z",
    "cisco": {
        "ios": {
            "event": {
                "facility": "SYS"
            },
            "observer": {
                "terminal": "2"
            }
        }
    },
    "host": {
        "name": "FE08"
    },
    "observer": {
        "product": "ios",
        "vendor": "Cisco"
    },
    "related": {
        "ip": [
            "1.2.3.4"
        ],
        "user": [
            "jdoe"
        ]
    },
    "source": {
        "address": "1.2.3.4",
        "ip": "1.2.3.4"
    },
    "user": {
        "name": "jdoe"
    }
}

{
    "message": "DN04.LOCAL: Feb 21 06:59:55.692: %SW_MATM-4-MACFLAP_NOTIF: Host 0011.2233.4455 in vlan 20 is flapping between port Gi1/0/9 and port Gi2/0/9",
    "event": {
        "category": [
            "host"
        ],
        "code": "MACFLAP_NOTIF",
        "kind": "event",
        "reason": "Host 0011.2233.4455 in vlan 20 is flapping between port Gi1/0/9 and port Gi2/0/9",
        "severity": 4,
        "type": [
            "info"
        ]
    },
    "@timestamp": "2023-02-21T06:59:55.692000Z",
    "cisco": {
        "ios": {
            "event": {
                "facility": "SW_MATM"
            },
            "observer": {
                "interface": {
                    "ports": [
                        "Gi1/0/9",
                        "Gi2/0/9"
                    ]
                }
            }
        }
    },
    "host": {
        "name": "DN04.LOCAL"
    },
    "network": {
        "vlan": {
            "id": "20"
        }
    },
    "observer": {
        "product": "ios",
        "vendor": "Cisco"
    },
    "source": {
        "mac": "00:11:22:33:44:55"
    }
}

{
    "message": "FE08: Jan 13 2023 10:16:05.33: %SYS-6-TTY_EXPIRE_TIMER: (exec timer expired, tty 2 (1.2.3.4)), user jdoe",
    "event": {
        "category": [
            "host"
        ],
        "code": "TTY_EXPIRE_TIMER",
        "kind": "event",
        "reason": "(exec timer expired, tty 2 (1.2.3.4)), user jdoe",
        "severity": 6,
        "type": [
            "info"
        ]
    },
    "@timestamp": "2023-01-13T10:16:05.330000Z",
    "cisco": {
        "ios": {
            "event": {
                "facility": "SYS"
            },
            "observer": {
                "terminal": "2"
            }
        }
    },
    "host": {
        "name": "FE08"
    },
    "observer": {
        "product": "ios",
        "vendor": "Cisco"
    },
    "related": {
        "ip": [
            "1.2.3.4"
        ],
        "user": [
            "jdoe"
        ]
    },
    "source": {
        "address": "1.2.3.4",
        "ip": "1.2.3.4"
    },
    "user": {
        "name": "jdoe"
    }
}

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.
cisco.ios.event.facility	keyword	The facility of the event
cisco.ios.observer.interface.name	keyword	The name of the interface
cisco.ios.observer.interface.ports	array	The list of ports associated to the interface
cisco.ios.observer.terminal	keyword	The identifier of the terminal used for the action
destination.ip	ip	IP address of the destination.
destination.port	long	Port of the destination.
event.action	keyword	The action captured by the event.
event.category	keyword	Event category. The second categorization field in the hierarchy.
event.code	keyword	Identification code for this event.
event.kind	keyword	The kind of the event. The highest categorization field in the hierarchy.
event.reason	keyword	Reason why this event happened, according to the source
event.severity	long	Numeric severity of the event.
host.name	keyword	Name of the host.
network.vlan.id	keyword	VLAN ID as reported by the observer.
observer.product	keyword	The product name of the observer.
observer.vendor	keyword	Vendor name of the observer.
source.ip	ip	IP address of the source.
source.mac	keyword	MAC address of the source.
source.port	long	Port of the source.
user.name	keyword	Short name or login of the user.

Configure

Prerequisites

An internal log concentrator is required to collect and forward events to Sekoia.io.

Enable Syslog forwarding

Log on your Cisco appliance and follow this guide to enable syslog forwarding.

Create the intake

Go to the intake page and create a new intake from the format Cisco IOS.

Forward logs to Sekoia.io

Please consult the Syslog Forwarding documentation to forward these logs to Sekoia.io.

Further Readings

• Cisco System Message Logging