Greenbone
17 min
the greenbone connector facilitates the integration of greenbone's vulnerability management capabilities into the swimlane platform, enabling automated vulnerability reporting and management greenbone is a leading provider of vulnerability management solutions that enable organizations to identify, assess, and mitigate security risks the greenbone connector for swimlane turbine allows users to automate the retrieval of detailed vulnerability reports and available report formats, enhancing their security posture by integrating with greenbone's comprehensive scanning tools this integration streamlines the vulnerability management process, providing actionable insights and facilitating informed decision making for security teams by leveraging the greenbone connector, users can efficiently manage security assessments, compare reports for delta analysis, and customize report outputs to align with their specific security requirements supported version the greenbone connector supports the following versions of the greenbone gmp v22 4 gmp v22 5 gmp v22 6 gmp v22 7 additional documents greenbone documentation https //greenbone github io/python gvm/index html prerequisites to effectively utilize the greenbone connector for swimlane, ensure you have the following prerequisites custom asset configuration for connecting to a greenbone tls server with these parameters hostname the address of the greenbone server port the port number for the greenbone server connection user your greenbone user account name base64 ca file a base64 encoded certificate authority file for secure communication password the password associated with your greenbone user account authentication methods greenbone tls connection method setup instructions obtain tls certificates and keys contact your greenbone administrator to obtain the required tls certificates and keys you will need ca (certificate authority) file client certificate file private key file convert files to base64 convert each certificate/key file to base64 encoding use the following command for each file base64 i \<filename> o \<filename> b64 example base64 i ca pem o ca pem b64 base64 i client crt o client crt b64 base64 i client key o client key b64 configure asset navigate to the greenbone connector asset configuration fill in the following required fields hostname ip address or fqdn of your greenbone server port tls port (typically 9392) user username for greenbone authentication ca file paste the base64 encoded ca file content password password for the greenbone user account capabilities this greenbone connector provides the following capabilities get report formats get report get report formats request a list of report formats click here https //greenbone github io/python gvm/api/gmpv225 html?utm source=chatgpt com#gvm protocols gmp gmpv225 get report formats get report request a single report click here https //greenbone github io/python gvm/api/gmpv225 html?utm source=chatgpt com#gvm protocols gmp gmpv225 get report configurations greenbone tls connection this asset is used to connect to a greenbone tls server configuration parameters parameter description type required hostname the hostname of the target host string required port the port of the target host string required user the user of the greenbone server string required base64 certfile the base64 encoded certfile of the greenbone server string optional base64 cafile the base64 encoded cafile of the greenbone server string required base64 keyfile the base64 encoded keyfile of the greenbone server string optional password the password of the greenbone server string required timeout the timeout of the greenbone server string optional actions get report retrieves a detailed report from greenbone using the specified report id endpoint method get input argument name type required description report id string required uuid of an existing report filter string string optional filter term to use to filter results in the report filter id string optional uuid of filter to use to filter results in the report delta report id string optional uuid of an existing report to compare report to report format id string optional uuid of report format to use ignore pagination boolean optional whether to ignore the filter terms “first” and “rows” details boolean optional request additional report information details defaults to true output parameter type description get reports response object output field get reports response @status string status value @status text string status value report object output field report @id string unique identifier @format id string unique identifier @extension string output field @extension @content type string type of the resource owner object output field owner name string name of the resource name string name of the resource comment object output field comment creation time string time value modification time string time value writable string output field writable in use string output field in use task object output field task @id string unique identifier name string name of the resource report format object output field report format @id string unique identifier name string name of the resource filters object output field filters @id string unique identifier term string output field term example \[ { "get reports response" { "@status" "200", "@status text" "ok", "report" {}, "filters" {}, "sort" {}, "reports" {}, "report count" {} } } ] get report formats retrieve a list of available report formats from greenbone, enabling selection for data export endpoint method get input argument name type required description filter string string optional filter term to use for the query filter id string optional uuid of an existing filter to use for the query trash boolean optional whether to get the trashcan report formats instead alerts boolean optional whether to include alerts that use the report format params boolean optional whether to include report format parameters details boolean optional include report format file, signature and parameters output parameter type description get report formats response object output field get report formats response @status string status value @status text string status value report format array output field report format filters object output field filters @id string unique identifier term string output field term keywords object output field keywords keyword array output field keyword column string output field column relation string output field relation value string value for the parameter sort object output field sort field object output field field order string output field order #text string output field #text report formats object output field report formats @start string output field @start @max string output field @max report format count object count value filtered string output field filtered page string output field page #text string output field #text example \[ { "get report formats response" { "@status" "200", "@status text" "ok", "report format" \[], "filters" {}, "sort" {}, "report formats" {}, "report format count" {} } } ]