Skip to main content

A cli tool for use with Trend Micro products.

Project description


This package provides a command line tool for use with Trend Micro Cloud One suite of products, including

  • Deep Security (on premises and DSaaS)
  • Smart Check
  • Cloud Conformity (coming)
  • Network Security (coming)

This package currently supports Python versions:

  • 3.6.x and greater
  • 3.7.x and greater
  • 3.8.x and greater

Note: All replys from the server are in JSON. Therefore jq is a good companion program to pipe the output to. For most distros, you can install jq with yum install jq or apt-get install jq


The easiest way to install thus is to use pip in a pip in a virtualenv:

$ pip3 install thus --user

or, if you are not installing in a virtualenv, to install globally:

$ sudo pip3 install thus

or for your user:

$ pip3 install --user thus

If you have the thus installed and want to upgrade to the latest version you can run::

$ pip3 install --upgrade thus

Command Completion -- HIGHLY recommended

Not sure what shell you have? Run echo $SHELL if the result is /bin/bash you have bash. If it comes back /bin/zsh you have zsh. ###bash To enable tab completion for bash, execute


If you used --user when installing thus, the standard location for is in ~/.local/bin/ If you did not use --user when installing thus, the standard location for is in /usr/bin/ To enable this everytime, add the source command to the full path to to your ~/.bashrc file.


Locate your file. If you used --user then installing thus, the standard location for is in ~/.local/bin/ If you did not use --user when installing thus, the standard location for is in /usr/bin/

Edit the ~/.zshrc file. Add the following lines to the top of the file. It must be before any call to autoload $fpath=$fpath:~/.local/bin/

Restart your terminal for changes to take effect.

Getting Started

Before using thus, you need to provide credentials and hostnames of your services. You do this by creating a config file. The file should be placed in ~/.thus/credentials

DSMapikey = F16564D5-492A-F167-5472-2CEDA60E12D7:GDwCvBV2kV7FjSVuYJXdEqeeeu0WKlls3/sqwu+HEXM=
SCUser: administrator
SCPassword: MySuperPassword   

This creates a default profile that has both Deep Security and Smart Check credentials. You can add additional profiles for more servers.

Next, we need a config file to tell the thus, when using profile default what settings we want to use. The file should nbe placed in ~/.thus/config

DSMhost =
DSMverifyssl = False
SCHost =
SCverifyssl = False

Note The /api at the end of the URL is required.

Now when default profile is used for Smart Check, it will connect to using the usernameadministrator and password MySuperPassword


Get a list of computers from Deep Security:

thus deepsecurity computers list

Get a list of computers from Deep Security with only two expand values:

thus deepsecurity computers list expand=interfaces,webreputation

Get a list of polices from Deep Security:

thus deepsecurity policies list

Get a list of scans from Smart Check

thus smartcheck scans list

Getting Help

Use github issues for logging bugs and feature requests.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cloudonecli-0.0.11.tar.gz (11.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page