Pytos is the Tufin Orchestration Suite (TOS) Software Development Kit (SDK) for Python, which allows Python developers to make use of the services provided by SecureTrack, SecureChange and SecureApp.

• Get security rules or ACLs from firewalls
• Get network objects and services from firewalls
• Get security groups from cloud platforms
• Get routing tables and interfaces from routers and firewalls
• Manage security zones
• Submit and manage access requests to update firewall policies
• Manage application connectivity

Install the package by running the following command (it is recommended that you upgrade pip first):

# pip install pytos

The package can be tested in all supported Python versions using tox . The tested Python version must be installed including tox :

$ tox -e py34

You can also run individual tests with your default Python version by running nosetests command directly:

$ nosetests -v tests/securetrack_test/test_secure_track_helper_unittest.py:TestGeneralSettings

Connect to SecureTrack with valid username and password:

from pytos.securetrack.helpers import Secure_Track_Helper
st_helper = Secure_Track_Helper("127.0.0.1", ("username", "password"))

Connect to SecureChange with valid username and password:

from pytos.securechange.helpers import Secure_Change_Helper
sc_helper = Secure_Change_Helper("127.0.0.1", ("username", "password"))

Connect to SecureApp with valid username and password:

from pytos.secureapp.helpers import Secure_App_Helper
sa_helper = Secure_App_Helper("127.0.0.1", ("username", "password"))

To use the pytos logging mechanism perform the following steps:

The following table defines the log levels and messages, in decreasing order of severity.

Create an ini like configuration file with the following sections:

[common]
log_file_path = /var/log/pytos/

[log_levels]
common = WARNING
helpers = WARNING
reports = WARNING
requests = WARNING
mail = WARNING
sql = WARNING
xml = WARNING
web = WARNING
third_party = WARNING

In your code call the following methods:

import logging
from pytos.common.logging.Defines import COMMON_LOGGER_NAME
from pytos.common.logging.Logger import setup_loggers
from pytos.common.functions.Config import Secure_Config_Parser

conf = Secure_Config_Parser(config_file_path="/ini/like/configuration/path/pytos.conf")
logger = logging.getLogger(COMMON_LOGGER_NAME)
setup_loggers(conf.dict("log_levels"), log_to_stdout=True)
logger.info("Hello world")

For tracking bugs and new feature requests please use GitHub issues. Please also use these community resources for getting help:

• Join the Tufin Developer Community
• If you think you found a bug, please submit an issue