Fortinet Document Library

Version:


Table of Contents

1.0.0
Copy Link

About the connector

Tor is a free software used for enabling anonymous communication.

This document provides information about the Tor connector, which facilitates automated interactions with a Tor server using FortiSOAR™ playbooks. Add the Tor connector as a step in FortiSOAR™ playbooks and perform automated operations, such as checking if the IP address or addresses that you have specified are a TOR exit node.

Version information

Connector Version: 1.0.0

FortiSOAR™ Version Tested on: 4.11.0-1161

Authored By: Fortinet

Certified: Yes

Installing the connector

All connectors provided by FortiSOAR™ are delivered using a FortiSOAR™ repository. Therefore, you must set up your FortiSOAR™ repository and use the yum command to install connectors:

yum install cyops-connector-tor

For the detailed procedure to install a connector, click here.

Prerequisites to configuring the connector

  • You must have the Tor database on your local instance to which you will connect and perform the automated operations.
  • To access the FortiSOAR™ UI, ensure that port 443 is open through the firewall for the FortiSOAR™ instance.

Configuring the connector

For the procedure to configure a connector, click here.

Configuration parameters

You do not need to configure any parameters for this connector. 

Actions supported by the connector

The following automated operations can be included in playbooks, and you can also use the annotations to access operations from FortiSOAR™ release 4.10.0 onwards:

Function Description Annotation and Category
Check Tor Exit Node Checks if the IP address or addresses that you have specified are a Tor exit node. lookup_ip
Miscellaneous

operation: Check Tor Exit Node

Input parameters

Parameter Description
IP or list of IP's IP address or a list of IP addresses that you want to check whether they are specified as a Tor exit node.
You can enter multiple IP addresses using a comma separator.
For example, xx.xx.xx.1, xx.xx.xx.2, xx.xx.xx.3

Output

The JSON output displays the status of the Check Tor Exit Node operation and details such as whether the IP addresses that you have specified are a Tor exit node.

Following image displays a sample output:

Included playbooks

The Sample - Tor - 1.0.0 playbook collection comes bundled with the Tor connector. This playbook contains steps using which you can perform all supported actions. You can see the bundled playbooks in the Automation > Playbooks section in FortiSOAR™ after importing the Tor connector.

  • Check IP For Tor Exit Node

Note: If you are planning to use any of the sample playbooks in your environment, ensure that you clone those playbooks and move them to a different collection since the sample playbook collection gets deleted during connector upgrade and delete.

 

About the connector

Tor is a free software used for enabling anonymous communication.

This document provides information about the Tor connector, which facilitates automated interactions with a Tor server using FortiSOAR™ playbooks. Add the Tor connector as a step in FortiSOAR™ playbooks and perform automated operations, such as checking if the IP address or addresses that you have specified are a TOR exit node.

Version information

Connector Version: 1.0.0

FortiSOAR™ Version Tested on: 4.11.0-1161

Authored By: Fortinet

Certified: Yes

Installing the connector

All connectors provided by FortiSOAR™ are delivered using a FortiSOAR™ repository. Therefore, you must set up your FortiSOAR™ repository and use the yum command to install connectors:

yum install cyops-connector-tor

For the detailed procedure to install a connector, click here.

Prerequisites to configuring the connector

Configuring the connector

For the procedure to configure a connector, click here.

Configuration parameters

You do not need to configure any parameters for this connector. 

Actions supported by the connector

The following automated operations can be included in playbooks, and you can also use the annotations to access operations from FortiSOAR™ release 4.10.0 onwards:

Function Description Annotation and Category
Check Tor Exit Node Checks if the IP address or addresses that you have specified are a Tor exit node. lookup_ip
Miscellaneous

operation: Check Tor Exit Node

Input parameters

Parameter Description
IP or list of IP's IP address or a list of IP addresses that you want to check whether they are specified as a Tor exit node.
You can enter multiple IP addresses using a comma separator.
For example, xx.xx.xx.1, xx.xx.xx.2, xx.xx.xx.3

Output

The JSON output displays the status of the Check Tor Exit Node operation and details such as whether the IP addresses that you have specified are a Tor exit node.

Following image displays a sample output:

Included playbooks

The Sample - Tor - 1.0.0 playbook collection comes bundled with the Tor connector. This playbook contains steps using which you can perform all supported actions. You can see the bundled playbooks in the Automation > Playbooks section in FortiSOAR™ after importing the Tor connector.

Note: If you are planning to use any of the sample playbooks in your environment, ensure that you clone those playbooks and move them to a different collection since the sample playbook collection gets deleted during connector upgrade and delete.