Tripwire Enterprise

the tripwire enterprise connector integrates with swimlane to get reports , policies , tasks , rules , elements and system information from tripwire prerequisites the tripwire enterprise connector requires a url running the application, an username , and a password capabilities this plugin provides the following capabilities create execute task requests create policies run create tasks delete user get elements get execute task request by id get latest policy test results get latest task run contexts get log messages get nodes get policies get policy test results get reports get rules get settings licenses and so on asset setup the connector requires a username and password to get the access token to interact with actions configurations http basic authentication authenticates using username and password configuration parameters parameter description type required url a url to the target host string required username username string required password password string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions create execute task requests request to run a task endpoint url /api/v1/tasks/executetaskrequests method post input argument name type required description completiontime string optional time value creationtime string optional time value id string optional unique identifier requestdata object required response data taskid string required unique identifier status string optional status value statusmessage object optional status value output parameter type description status code number http status code of the response reason string response reason phrase creationtime string time value id string unique identifier requestdata object response data taskid string unique identifier status string status value statusmessage array status value file name string name of the resource file string output field file example \[ { "status code" 202, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "transfer encoding" "chunked", "date" "tue, 05 sep 2023 09 16 52 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" { "creationtime" "2023 09 05t09 16 52 746z", "id" "44", "requestdata" {}, "status" "pending", "statusmessage" \[] } } ] create policies run allows evaluation of policy test criteria against previously harvested element versions for a specified set of policies and nodes endpoint url /api/v1/policies/run method post input argument name type required description nodes array optional parameter for create policies run policies array required parameter for create policies run output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 204, "response headers" { "connection" "keep alive", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "text/html", "csrftoken" "{\\"pagetokens\\" {\\"/api/v1/policies/run\\" \\"gnkd 4j9f 67l4 xh8k x6o2 rz4h 1kya jxh3\\"} ", "date" "mon, 04 sep 2023 09 57 52 gmt", "keep alive" "timeout=60", "server" "tripwire enterprise", "strict transport security" "max age=31622400; includesubdomains", "x content type options" "nosniff", "x frame options" "sameorigin", "x xss protection" "1; mode=block" }, "reason" "ok", "json body" {} } ] create tasks creates a new task in the root task group endpoint url /api/v1/tasks method post input argument name type required description actionids array optional unique identifier additionalemailaddresses array optional parameter for create tasks archiveauditevents boolean optional parameter for create tasks archivelogsexceeding number optional parameter for create tasks archivelogsolderthan number optional parameter for create tasks archivereports boolean optional parameter for create tasks compactversionsexceeding number optional parameter for create tasks compactversionsolderthan number optional parameter for create tasks description string optional parameter for create tasks emailserver string required parameter for create tasks enabled boolean optional parameter for create tasks id string optional unique identifier ignoreemptyreports boolean optional parameter for create tasks lastduration number optional parameter for create tasks laststart string optional parameter for create tasks name string required name of the resource newbaselinesonly boolean optional parameter for create tasks checknodeconnectiononly boolean optional parameter for create tasks offboardingonly boolean optional parameter for create tasks unlicenseduration number optional parameter for create tasks unlicensedurationunit string optional parameter for create tasks deleteduration number optional parameter for create tasks deletedurationunit string optional parameter for create tasks nextstart string optional parameter for create tasks nodeid string optional unique identifier output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "connection" "keep alive", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "text/html", "csrftoken" "{\\"pagetokens\\" {\\"/api/v1/policies/run\\" \\"gnkd 4j9f 67l4 xh8k x6o2 rz4h 1kya jxh3\\"} ", "date" "mon, 04 sep 2023 09 57 52 gmt", "keep alive" "timeout=60", "server" "tripwire enterprise", "strict transport security" "max age=31622400; includesubdomains", "x content type options" "nosniff", "x frame options" "sameorigin", "x xss protection" "1; mode=block" }, "reason" "ok", "json body" {} } ] delete user removes a user from the system endpoint url /api/v1/users/{{rkuserid}} method delete input argument name type required description rkuserid string required unique identifier output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 204, "response headers" { "connection" "keep alive", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "date" "mon, 04 sep 2023 06 27 12 gmt", "keep alive" "timeout=60", "server" "tripwire enterprise", "strict transport security" "max age=31622400; includesubdomains", "transfer encoding" "chunked", "x content type options" "nosniff", "x frame options" "sameorigin", "x xss protection" "1; mode=block" }, "reason" "user deleted correctly", "json body" {} } ] get elements returns a list of all elements or those that match the provided criteria endpoint url /api/v1/elements method get input argument name type required description baselineversionid array optional unique identifier description array optional parameter for get elements id array optional unique identifier inscope boolean optional parameter for get elements isrestorable boolean optional parameter for get elements lastsuccessdate array optional whether the operation was successful lastversionchangeseverity array optional parameter for get elements lastversionchangetype array optional type of the resource lastversionid array optional unique identifier lastversiontime array optional time value name array optional name of the resource nodeid array optional unique identifier pagelimit string optional parameter for get elements pagestart string optional parameter for get elements previousid string optional unique identifier sub description array optional parameter for get elements ruleid array optional unique identifier output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "content length" "1602", "date" "tue, 05 sep 2023 10 38 44 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" \[ {} ] } ] get execute task request by id returns the details of a single task execution request endpoint url /api/v1/tasks/executetaskrequests/{{requestid}} method get input argument name type required description requestid string required unique identifier output parameter type description status code number http status code of the response reason string response reason phrase completiontime string time value creationtime string time value id string unique identifier requestdata object response data taskid string unique identifier status string status value statusmessage array status value file name string name of the resource file string output field file example \[ { "status code" 200, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "transfer encoding" "chunked", "date" "tue, 05 sep 2023 10 48 00 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" { "completiontime" "2023 09 04t11 59 29 272z", "creationtime" "2023 09 04t11 59 29 064z", "id" "36", "requestdata" {}, "status" "completed", "statusmessage" \[] } } ] get latest policy test results returns a list of only those policy test results that are the latest result for a given policy test and node combination, or of those, the results that match the filter criteria endpoint url /api/v1/policytestresults/latest method get input argument name type required description id string optional unique identifier creationtime array optional time value creationtimerange string optional parameter for get latest policy test results elementid array optional unique identifier elementname array optional name of the resource elementversionid array optional unique identifier nodeid array optional unique identifier nodelabel array optional parameter for get latest policy test results pagelimit string optional parameter for get latest policy test results pagestart string optional parameter for get latest policy test results previousids string optional unique identifier policytestid array optional unique identifier policytestname array optional name of the resource state array optional parameter for get latest policy test results output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "content length" "2", "date" "tue, 05 sep 2023 10 51 11 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" \[] } ] get latest task run contexts returns a list of the latest task run status record for each rule based task endpoint url /api/v1/tasks/runcontexts/latest method get input argument name type required description endtime array optional time value endtimerange string optional parameter for get latest task run contexts haserrors string optional error message if any id array optional unique identifier pagelimit string optional parameter for get latest task run contexts previousid string optional unique identifier runtype string optional type of the resource starttime array optional time value stoptype string optional type of the resource taskid array optional unique identifier output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "content length" "522", "date" "tue, 05 sep 2023 11 02 12 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" \[ {} ] } ] get log messages list all log manager messages or those that match the filter criteria endpoint url /api/v1/logmessages method get input argument name type required description id array optional unique identifier level array optional parameter for get log messages message array optional response message object array optional parameter for get log messages pagelimit string optional parameter for get log messages pagestart string optional parameter for get log messages sub message array optional response message time array optional time value timerange string optional parameter for get log messages type array optional type of the resource username array optional name of the resource output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "content length" "571", "date" "tue, 05 sep 2023 11 04 59 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" \[ {} ] } ] get nodes returns a list of all nodes or those that match the provided filter criteria endpoint url /api/v1/nodes method get input argument name type required description agentversion array optional parameter for get nodes auditenabled boolean optional parameter for get nodes description array optional parameter for get nodes commonagentcapabilities array optional parameter for get nodes commonagentosname array optional name of the resource commonagentosversion array optional parameter for get nodes commonagentversion array optional parameter for get nodes commonagentuuid array optional unique identifier customproperty array optional parameter for get nodes elementcount array optional count value eventgeneratorenabled boolean optional parameter for get nodes eventgeneratorinstalled boolean optional parameter for get nodes hasfailures boolean optional parameter for get nodes ic name array optional name of the resource id array optional unique identifier importedtime array optional time value importedtimerange string optional parameter for get nodes ipaddress array optional parameter for get nodes isdisabled boolean optional parameter for get nodes issocksproxy boolean optional parameter for get nodes issslsupported boolean optional parameter for get nodes lastcheck array optional parameter for get nodes lastregistration array optional parameter for get nodes licensedfeature array optional parameter for get nodes macaddress array optional parameter for get nodes output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "content length" "1373", "date" "tue, 05 sep 2023 11 07 58 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" \[ {} ] } ] get policies returns a list of all policies or those that match the provided filter criteria endpoint url /api/v1/policies method get input argument name type required description description array optional parameter for get policies id array optional unique identifier importedtime array optional time value modifiedtime array optional time value name array optional name of the resource nodescope array optional parameter for get policies pagelimit string optional parameter for get policies pagestart string optional parameter for get policies purgedataolderthandays array optional response data purgeolddata boolean optional response data trackingid array optional unique identifier sub description array optional parameter for get policies output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "content length" "6708", "date" "tue, 05 sep 2023 11 10 08 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" \[ {} ] } ] get policy test results returns a list of all policy test results or those that match the provided filter criteria endpoint url /api/v1/policytestresults method get input argument name type required description id string optional unique identifier creationtime array optional time value creationtimerange string optional parameter for get policy test results elementid array optional unique identifier elementname array optional name of the resource elementversionid array optional unique identifier nodeid array optional unique identifier nodelabel array optional parameter for get policy test results pagelimit string optional parameter for get policy test results pagestart string optional parameter for get policy test results previousids string optional unique identifier policytestid array optional unique identifier policytestname array optional name of the resource state array optional parameter for get policy test results output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "connection" "keep alive", "content length" "2", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "date" "mon, 04 sep 2023 10 00 43 gmt", "keep alive" "timeout=60", "server" "tripwire enterprise", "strict transport security" "max age=31622400; includesubdomains", "x content type options" "nosniff", "x frame options" "sameorigin", "x xss protection" "1; mode=block" }, "reason" "ok", "json body" \[] } ] get reports returns a list of all reports or those that match the filter criteria endpoint url /api/v1/reports method get input argument name type required description description array optional parameter for get reports id array optional unique identifier name array optional name of the resource type array optional type of the resource sub description array optional parameter for get reports output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "content length" "5100", "date" "tue, 05 sep 2023 11 19 00 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" \[ {} ] } ] get rules returns a list of all rules or those that match the provided filter criteria endpoint url /api/v1/rules method get input argument name type required description description array optional parameter for get rules elementname array optional name of the resource id array optional unique identifier importedtime array optional time value importedtimerange string optional parameter for get rules isrealtime boolean optional time value modifiedtime array optional time value name array optional name of the resource oid array optional unique identifier pagelimit string optional parameter for get rules pagestart string optional parameter for get rules severity array optional parameter for get rules sub description array optional parameter for get rules timeoutmillis array optional parameter for get rules trackingid array optional unique identifier type array optional type of the resource output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "content length" "1417", "date" "tue, 05 sep 2023 11 27 23 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" \[ {} ] } ] get settings licenses returns a list of all licensed features in te including the feature consumption endpoint url /api/v1/settings/licenses method get output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "transfer encoding" "chunked", "date" "tue, 05 sep 2023 11 28 58 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" \[ {} ] } ] get status returns a te status details object with the identifying information for the te system that the api client is connecting to endpoint url /api/v1/status method get output parameter type description status code number http status code of the response reason string response reason phrase apiversion string output field apiversion hostname string name of the resource interfaces array output field interfaces inetaddresses array output field inetaddresses macaddress string output field macaddress serveraddress string output field serveraddress teuuid string unique identifier teversion string output field teversion example \[ { "status code" 200, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "transfer encoding" "chunked", "date" "tue, 05 sep 2023 06 47 07 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" { "apiversion" "1 34 0 b1 34 0 r20221024183502 c6559b8 b5", "hostname" "win 6v8oe7d4sj6", "interfaces" \[], "serveraddress" "192 168 1 180", "teuuid" " 3f57fe4c 18a432d7f8d 7fff", "teversion" "9 0 0 b9 0 0 r20221124164642 2e02d3f b17" } } ] get task run contexts returns a list of task run status records endpoint url /api/v1/tasks/runcontexts method get input argument name type required description endtime array optional time value endtimerange string optional parameter for get task run contexts haserrors string optional error message if any id array optional unique identifier pagelimit string optional parameter for get task run contexts previousid string optional unique identifier runtype string optional type of the resource starttime array optional time value stoptype string optional type of the resource taskid array optional unique identifier output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "content length" "522", "date" "tue, 05 sep 2023 11 31 56 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" \[ {} ] } ] get tasks returns a list of all tasks, or only those tasks that match the provided filter criteria search filters are supported for all fields except schedule endpoint url /api/v1/tasks method get input argument name type required description actionids array optional unique identifier additionalemailaddresses array optional parameter for get tasks archiveauditevents boolean optional parameter for get tasks archivelogsexceeding array optional parameter for get tasks archivelogsolderthan array optional parameter for get tasks archivereports boolean optional parameter for get tasks compactversionsexceeding array optional parameter for get tasks compactversionsolderthan array optional parameter for get tasks description array optional parameter for get tasks emailserver array optional parameter for get tasks enabled boolean optional parameter for get tasks id array optional unique identifier ignoreemptyreports boolean optional parameter for get tasks lastduration array optional parameter for get tasks laststart array optional parameter for get tasks name array optional name of the resource newbaselinesonly boolean optional parameter for get tasks checknodeconnectiononly boolean optional parameter for get tasks offboardingonly boolean optional parameter for get tasks nextstart array optional parameter for get tasks nodeid array optional unique identifier pagelimit string optional parameter for get tasks pagestart string optional parameter for get tasks reportformat array optional parameter for get tasks reportid array optional unique identifier output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "content length" "1052", "date" "tue, 05 sep 2023 12 27 42 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" \[ {}, {} ] } ] get users returns a list of all users or those that match the filter criteria endpoint url /api/v1/users method get input argument name type required description builtin boolean optional parameter for get users description array optional parameter for get users email array optional parameter for get users id array optional unique identifier lastlogin array optional parameter for get users lastlogout array optional parameter for get users name array optional name of the resource roleid array optional unique identifier sub description array optional parameter for get users output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "strict transport security" "max age=31622400; includesubdomains", "x frame options" "sameorigin", "x xss protection" "1; mode=block", "x content type options" "nosniff", "content security policy" "default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors ' ", "content type" "application/json", "transfer encoding" "chunked", "date" "tue, 05 sep 2023 12 32 33 gmt", "keep alive" "timeout=60", "connection" "keep alive", "server" "tripwire enterprise" }, "reason" "", "json body" \[ {} ] } ] response headers header description example connection http response header connection keep alive content length the length of the response body in bytes 522 content security policy http response header content security policy default src https data 'self' 'unsafe inline' 'unsafe eval'; frame ancestors 'self' content type the media type of the resource application/json csrftoken http response header csrftoken {"pagetokens" {"/api/v1/policies/run" "gnkd 4j9f 67l4 xh8k x6o2 rz4h 1kya jxh3"}} date the date and time at which the message was originated tue, 05 sep 2023 09 16 52 gmt keep alive http response header keep alive timeout=60 server information about the software used by the origin server tripwire enterprise strict transport security http response header strict transport security max age=31622400; includesubdomains transfer encoding http response header transfer encoding chunked x content type options http response header x content type options nosniff x frame options http response header x frame options sameorigin x xss protection http response header x xss protection 1; mode=block notes this plugin was last tested against product version v1