Uses Netmiko to start a SSH or Telnet session with a target device. It will attempt
to use SSH first, and if it fails it will try Telnet. For each connection method, it
will attempt each credential specified in the cred argument (if specified) or the
config.cc.credentials list otherwise.

Keyword Arguments:

cred (dict) – If supplied, this method will only use the specified credential.
Uses the config.cc.credentials list otherwise.

port (int) – If supplied, this method will connect only on this port

ip (str) – The IP address to connect to

netmiko_platform (str) – The platform of the device, in the Netmiko format

handler (ConnectHandler) – A Netmiko-type handler to use. Currently using
one of Netmiko.ConnectHandler, Netmiko.ssh_autodetect.SSHDetect.
Uses Netmiko.ConnectHandler by default.

Returns:

A dict containing:

connection (ConnectHandler): A Netmiko ConnectHandler object with a successfully opened connection

Starts a Single Scan (-sS) run. This scan polls a single device and
presents information about the device to the console. Useful for testing
a connection, as well as getting a quick overview of the target.

Keyword Arguments:

target (str) – The network address of the device to scan

netmiko_platform (str) – The Netmiko platform of the target
device. If one is not given, it will attempt to autodetect the
device type.