Netmiko

Details

ID	`Netmiko`
Provider	Open Source
Category	Utilities
From Version	6.0.0
Docker Image	`demisto/netmiko:1.0.0.9067966`
Supported Modules	Agentix XSIAM

README

Netmiko SSH module integration

This integration provides ssh-based access to network devices, servers, and other appliances that support this method of configuration. For a complete list of supported platforms, please visit the below URL:

Netmiko Platforms.md on Github

Configure Netmiko Integration in Cortex XSOAR

Navigate to Settings - Integrations
Search for Netmiko
Click Add instance to create and configure a new integration instance.

Name: a name for the integration instance.
Platform: the platform identifier taken from the above SSH or Telnet platform name lists (e.g., linux_ssh, paloalto_panos, etc.)
NOTE: Platform names are taken from the supported
SSH or Telnet device type lists on GitHub.
- Hostname: The IP address, hostname, or FQDN for the device to connect to via SSH.
- Port: The port to connect to via SSH
- Credentials: The username/password, or XSOAR credential object, to be used for the connection
- Override the default timeout value: Override the timeout value (in seconds) for a given integration instance. This is useful for devices that are slow in responding with requested output over SSH.

Click Test to validate the new instance. This performs a simple connection to the system hosting the SSH server.

Commands

The Netmiko integration currently only supports the netmiko-cmds command for SSH. This command can be used via the XSOAR CLI, as part of an automation, or as a task in an XSOAR playbook. Like other XSOAR commands, this object can be passed a single command, a list of commands, or an array of commands to execute in a single session.

Executes a command, or series of commands, over an SSH connection: netmiko-cmds

netmiko-cmds

Executes a command, or series of commands, over an SSH connection. Outputs from the executed commands are returned to the incident/playground context.

Base Command

netmiko-cmds

Input

Argument Name	Description	Required
cmds	The command, or commands, to execute. When commands are manually specified and executed via the XSOAR CLI or in a task, place each command after the first on a new line (no comma required)	Required
disable_context	The package ID. Package ID or package name is required. When both exist, ID is used.	Optional
exit_argument	The optional exit command to be executed after the cmds parameter. This is tied to the requires_exit optional parameter. (Default: q)	Optional
isConfig	Specifies whether or not the commands being executed require a configure command to be executed first (e.g., conf t for Cisco IOS). The specific configure command is handled by the Netmiko Python module, and is associated with the Platform parameter specified in the integration instance. (Default: False)	Optional
override_host	If specified, uses this host in place of the one specified in the instance configuration.	Optional
override_password	If specified, uses this password in place of the one specified in the instance configuration.	Optional
override_platform	If specified, uses this platform name in place of the one specified in the instance configuration.	Optional
override_port	If specified, uses this port in place of the one specified in the instance configuration.	Optional
override_username	If specified, uses this username in place of the one specified in the instance configuration.	Optional
raw_print	Prints the raw output directly to the war room (Default: False)	Optional
require_enable	Specifies whether or not the enable command must be executed before the commands specified in the cmds parameter. (Default: False)	Optional
require_exit	Specifies an optional command that must be executed upon completion of the cmds parameter being executed. (Default: False)	Optional

Context Output

Path	Type	Description
Netmiko.Command	String	The executed command(s)
Netmiko.DateTimeUTC	DateTime	The datetime at which the command(s) were executed (in UTC)
Netmiko.Hostname	String	The hostname used for this execution of the integration
Netmiko.Output	String	The results of the command(s) that were executed

Command Example (Single command)

!netmiko-cmds cmds="whoami"

Context Example

{

“Command”: “whoami”,

“DateTimeUTC”: “2023-04-24T21:40:21.755985”,

“Hostname”: “192.168.0.1”,

“Output”: “[someuser@someserver ~]$ root”

}

Human Readable Output

Command(s) against 192.168.0.1 (linux)

Command	DateTimeUTC	Hostname	Output
whoami	2023-04-24T21:40:21.755985	192.168.0.1	root

Command Example (Multiple commands)

As multiple commands via CLI or task

!netmiko-cmds cmds="whoami
who"

As multiple commands via CLI or task using an array

array context key = ["whoami", "who"]
!netmiko-cmds cmds=${array}

Context Example

{

“Netmiko”: [{

“Command”: “whoami”,

“DateTimeUTC”: “2023-04-24T21:59:02.177240”,

“Hostname”: “192.168.0.1”,

“Output”: “[someuser@somehost ~]$ root”

},

{

“Command”: “who”,

“DateTimeUTC”: “2023-04-24T21:59:04.882842”,

“Hostname”: “192.168.0.1”,

“Output”: “[someuser@somehost ~]$ root pts/0 2023-04-24 17:58 (192.168.0.1)”

}]

}

Human Readable Output

Command(s) against 192.168.0.1 (linux)

Command	DateTimeUTC	Hostname	Output
whoami	2023-04-24T21:59:02.177240	192.168.0.1	root
who	2023-04-24T21:59:04.882842	192.168.0.1	[someuser@somehost ~]$ root pts/0 2023-04-24 17:58 (192.168.0.1)

Configuration parameters

hostname — Hostname (required)
port — Port (required)
platform — Platform (required)
credentials — Credentials (required)
TimeoutOverride — Override the default timeout value

Commands (1)

netmiko-cmds
Execute commands using Netmiko.

Source

Netmiko.py Netmiko_test.py Netmiko.yml Netmiko_description.md

Download History Raw

import json

from Netmiko import cmds_command


def get_test_data():
    with open("test_data/test_data.json") as f:
        return json.loads(f.read())


class MockClient:
    def __init__(self, args):
        self.platform = args["platform"]
        self.hostname = args["hostname"]
        self.username = args["username"]
        self.password = args["password"]
        self.port = args["port"]
        self.keys = args["sshkey"]
        self.net_connect = None

    def cmds(self, require_exit, exit_argument, commands, enable, isConfig):
        return {"Hostname": self.hostname, "DateTimeUTC": "1973-01-01T00:00:59+00:00", "Commands": commands, "Output": "root"}


def test_cmds_command():
    args = get_test_data()
    client = MockClient(args)

    result = cmds_command(client, args)

    assert result.outputs["Output"] == args["output"]
    assert result.outputs["Hostname"] == args["hostname"]
    assert result.outputs["Commands"][0] == args["cmds"]