Tufin Securetrack

This connector integrates Tufin SecureTrack with Turbine to get IP rules and get Topology image.

Prerequisites

The Tufin SecureTrack asset requires a base url, username and password.

Capabilities

This connector provides the following capabilities:

Get IP rules

Get Topology Image

Notes

Tufin SecureTrack API documentation: https://forum.tufin.com/support/kc/rest-api/R21-3/securetrack/apidoc/

Configurations

HTTP Basic Authentication

Authenticate using username and password.

Configuration Parameters

Parameter	Type	Required
url	string	Required
username	string	Required
password	string	Required
verify_ssl	boolean	Optional
http_proxy	string	Optional

Actions

Get IP Rules

Get Applicable Rules for IP from SecureTrack Policy Browser.

Endpoint

URL: securetrack/api/rule_search/

Method: GET

Input

Argument Name	Type	Required	Description
parameters.ip_address	string	Required	Parameters for the Get IP Rules action

Input Example

{"parameters":{"ip_address":"0.0.0.0"}}

Output

Parameter	Type	Description
status_code	number	HTTP status code of the response
reason	string	Response reason phrase
rules	array	Output field: rules
rules.21	object	Output field: rules.21
[email protected]	string	Type of the resource
rules.21.id	number	Unique identifier
rules.21.cp_uid	string	Unique identifier
rules.21.uid	string	Unique identifier
rules.21.order	number	Output field: rules.21.order
rules.21.binding	object	Output field: rules.21.binding
rules.21.binding.default	boolean	Output field: rules.21.binding.default
rules.21.binding.policy	object	Output field: rules.21.binding.policy
[email protected]	string	Type of the resource
rules.21.binding.policy.id	number	Unique identifier
rules.21.binding.policy.name	string	Name of the resource
rules.21.binding.policy.installable_targets	string	Output field: rules.21.binding.policy.installable_targets
rules.21.binding.rule_count	number	Count value
rules.21.binding.security_rule_count	number	Count value
rules.21.binding.uid	string	Unique identifier
rules.21.acceleration_breaker	boolean	Output field: rules.21.acceleration_breaker
rules.21.action	string	Output field: rules.21.action
rules.21.application	object	Output field: rules.21.application
rules.21.application.id	number	Unique identifier
rules.21.application.display_name	string	Name of the resource
rules.21.application.name	string	Name of the resource

Output Example

{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"rules":[{}]}}

Get Topology Image

Get Image of Network Topology Between Two Endpoints.

Endpoint

URL: securetrack/api/topology/path_image

Method: GET

Input

Argument Name	Type	Required	Description
parameters.src	string	Required	Parameters for the Get Topology Image action
parameters.dst	string	Required	Parameters for the Get Topology Image action
parameters.service	string	Required	Parameters for the Get Topology Image action
parameters.sourceDomainIdTag	number	Optional	Parameters for the Get Topology Image action
parameters.displayIncompletePaths	boolean	Optional	Parameters for the Get Topology Image action
parameters.displayBlockedStatus	boolean	Optional	Parameters for the Get Topology Image action
parameters.context	number	Optional	Parameters for the Get Topology Image action
parameters.simulateNat	boolean	Optional	Parameters for the Get Topology Image action
parameters.lastInstall	boolean	Optional	Parameters for the Get Topology Image action

Input Example

{"parameters":{"src":"10.10.10.1","dst":"10.10.10.1","service":"any","sourceDomainIdTag":1,"displayIncompletePaths":false,"displayBlockedStatus":false,"context":1,"simulateNat":false,"lastInstall":false}}

Output

Parameter	Type	Description
status_code	number	HTTP status code of the response
reason	string	Response reason phrase
file	object	File
file.file_name	string	Name of the resource
file.file	string	Output field: file.file

Output Example

{"file":{"file_name":"Example Name","file":"string"}}

Response Headers

Header	Description	Example
Content-Type	The media type of the resource	application/json
Date	The date and time at which the message was originated	Thu, 01 Jan 2024 00:00:00 GMT