Connections#

Module for connections to GVM server daemons like gvmd and ospd.

class gvm.connections.GvmConnection#

Base class for establishing a connection to a remote server daemon.

Parameters:

timeout – Timeout in seconds for the connection. None to wait indefinitely

__init__(timeout=60)#
connect()#

Establish a connection to a remote server

disconnect()#

Disconnect and close the connection to the remote server

finish_send()#

Indicate to the remote server you are done with sending data

read()#

Read data from the remote server

Returns:

data as utf-8 encoded string

Return type:

str

send(data)#

Send data to the connected remote server

Parameters:

data (Union[bytes, str]) – Data to be send to the server. Either utf-8 encoded string or bytes.

class gvm.connections.SSHConnection#

SSH Class to connect, read and write from GVM via SSH

Parameters:

  • timeout – Timeout in seconds for the connection.

  • hostname – DNS name or IP address of the remote server. Default is 127.0.0.1.

  • port – Port of the remote SSH server. Default is port 22.

  • username – Username to use for SSH login. Default is “gmp”.

  • password – Passwort to use for SSH login. Default is “”.

__init__(*, timeout=60, hostname='127.0.0.1', port=22, username='gmp', password='', known_hosts_file=None)#
connect()#

Connect to the SSH server and authenticate to it

disconnect()#

Disconnect and close the connection to the remote server

finish_send()#

Indicate to the remote server you are done with sending data

read()#

Read data from the remote server

Returns:

data as utf-8 encoded string

Return type:

str

send(data)#

Send data to the connected remote server

Parameters:

data (Union[bytes, str]) – Data to be send to the server. Either utf-8 encoded string or bytes.

class gvm.connections.TLSConnection#

TLS class to connect, read and write from a remote GVM daemon via TLS secured socket.

Parameters:

  • timeout – Timeout in seconds for the connection.

  • hostname – DNS name or IP address of the remote TLS server.

  • port – Port for the TLS connection. Default is 9390.

  • certfile – Path to PEM encoded certificate file. See python certificates for details.

  • cafile – Path to PEM encoded CA file. See python certificates for details.

  • keyfile – Path to PEM encoded private key. See python certificates for details.

  • password – Password for the private key. If the password argument is not specified and a password is required it will be interactively prompt the user for a password.

__init__(*, certfile=None, cafile=None, keyfile=None, hostname='127.0.0.1', port=9390, password=None, timeout=60)#
connect()#

Establish a connection to a remote server

disconnect()#

Close the SSL layer then disconnect from the remote server

finish_send()#

Indicate to the remote server you are done with sending data

read()#

Read data from the remote server

Returns:

data as utf-8 encoded string

Return type:

str

send(data)#

Send data to the connected remote server

Parameters:

data (Union[bytes, str]) – Data to be send to the server. Either utf-8 encoded string or bytes.

class gvm.connections.UnixSocketConnection#

UNIX-Socket class to connect, read, write from a daemon via direct communicating UNIX-Socket

Parameters:

  • path – Path to the socket. Default is “/run/gvmd/gvmd.sock”.

  • timeout – Timeout in seconds for the connection. Default is 60 seconds.

__init__(*, path='/run/gvmd/gvmd.sock', timeout=60)#
connect()#

Connect to the UNIX socket

disconnect()#

Disconnect and close the connection to the remote server

finish_send()#

Indicate to the remote server you are done with sending data

read()#

Read data from the remote server

Returns:

data as utf-8 encoded string

Return type:

str

send(data)#

Send data to the connected remote server

Parameters:

data (Union[bytes, str]) – Data to be send to the server. Either utf-8 encoded string or bytes.

class gvm.connections.DebugConnection#

Wrapper around a connection for debugging purposes

Allows to debug the connection flow including send and read data. Internally it uses the python logging framework to create debug messages. Please take a look at the logging tutorial for further details.

Usage example:

import logging

logging.basicConfig(level=logging.DEBUG)

socketconnection = UnixSocketConnection(path='/var/run/gvm.sock')
connection = DebugConnection(socketconnection)
gmp = Gmp(connection=connection)
Parameters:

connection – GvmConnection to observe

__init__(connection)#