|PyPI version shields.io| |PyPI pyversions|
Zanshin CLI
===========
This Python package provides a command-line utility to interact with the
`API of the Zanshin SaaS
service <https://api.zanshin.tenchisecurity.com>`__ from `Tenchi
Security <https://www.tenchisecurity.com>`__.
Is it based on the Zanshin Python SDK available on
`Github <https://github.com/tenchi-security/zanshin-sdk-python>`__ and
`PyPI <https://pypi.python.org/pypi/zanshinsdk/>`__.
If you are a Zanshin customer and have any questions regarding the use
of the service, its API or this command-line utility, please get in
touch via e-mail at support {at} tenchisecurity {dot} com or via the
support widget on the `Zanshin
Portal <https://zanshin.tenchisecurity.com>`__.
Installation
------------
We recommend the CLI is installed using
`pipx <https://pypa.github.io/pipx/installation/>`__, using the command:
.. code:: shell
pipx install zanshincli
When a new version is available, you can upgrade it with:
.. code:: shell
pipx upgrade zanshincli
Configuration File
------------------
The way the SDK and CLI handles credentials is by using a configuration
file in the format created by the Python
`RawConfigParser <https://docs.python.org/3/library/configparser.html#configparser.RawConfigParser>`__
class.
The file is located at ``~/.tenchi/config``, where ``~`` is the `current
user's home
directory <https://docs.python.org/3/library/pathlib.html#pathlib.Path.home>`__.
Each section is treated as a configuration profile, and the SDK and CLI
will look for a section called ``default`` if another is not explicitly
selected.
These are the supported options:
- ``api_key`` (required) which contains the Zanshin API key obtained at
the `Zanshin web
portal <https://zanshin.tenchisecurity.com/my-profile>`__.
- ``user_agent`` (optional) allows you to override the default
user-agent header used by the SDK when making API requests.
- ``api_url`` (optional) directs the SDK and CLI to use a different API
endpoint than the default
(`https://api.zanshin.tenchisecurity.com <https://api.zanshin.tenchisecurity.com>`__).
You can populate the file with the ``zanshin init`` command of the CLI
tool. This is what a minimal configuration file would look like:
.. code:: ini
[default]
api_key = abcdefghijklmnopqrstuvxyz
Using the CLI Utility
---------------------
This package installs a command-line utility called ``zanshin`` built
with the great `Typer <https://typer.tiangolo.com/>`__ package.
You can obtain help by using the ``--help`` option.
Keep in mind that when options are present that expect multiple values,
these need to be provided as multiple options. For example if you wanted
to list an organization's alerts filtering by the OPEN and RISK_ACCEPTED
states, this is the command you would use:
.. code:: shell
$ zanshin organization alerts d48edaa6-871a-4082-a196-4daab372d4a1 --state OPEN --state RISK_ACCEPTED
Command Reference
-----------------
``zanshin``
===========
Command-line utility to interact with the Zanshin SaaS service offered
by Tenchi Security
(`https://tenchisecurity.com <https://tenchisecurity.com>`__), go to
`https://github.com/tenchi-security/zanshin-cli <https://github.com/tenchi-security/zanshin-cli>`__
for license, source code and documentation
**Usage**:
.. code:: console
$ zanshin [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--profile TEXT``: Configuration file section to read API keyand
configuration from [default: default]
- ``--format [json|table|csv|html]``: Output format to use for list
operations [default: json]
- ``--verbose / --no-verbose``: Print more information to stderr
[default: True]
- ``--debug / --no-debug``: Enable debug logging in the SDK [default:
False]
- ``--install-completion``: Install completion for the current shell.
- ``--show-completion``: Show completion for the current shell, to copy
it or customize the installation.
- ``--help``: Show this message and exit.
**Commands**:
- ``account``: Operations on user the API key owner has...
- ``alert``: Operations on alerts the API key owner has...
- ``init``: Update settings on configuration file.
- ``organization``: Operations on organizations the API key owner...
- ``summary``: Operations on summaries the API key owner has...
- ``version``: Display the program and Python versions in...
``zanshin account``
-------------------
Operations on user the API key owner has direct access to
**Usage**:
.. code:: console
$ zanshin account [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--help``: Show this message and exit.
**Commands**:
- ``api_key``: Operations on API keys from account the API...
- ``invites``: Operations on invites from account the API...
- ``me``: Returns the details of the user account that...
``zanshin account api_key``
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Operations on API keys from account the API key owner has direct access
to
**Usage**:
.. code:: console
$ zanshin account api_key [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--help``: Show this message and exit.
**Commands**:
- ``create``: Creates a new API key for the current logged...
- ``delete``: Deletes a given API key by its id, it will...
- ``list``: Iterates over the API keys of current logged...
``zanshin account api_key create``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Creates a new API key for the current logged user, API Keys can be used
to interact with the zanshin api directly a behalf of that user.
**Usage**:
.. code:: console
$ zanshin account api_key create [OPTIONS] NAME
**Arguments**:
- ``NAME``: Name of the new API key [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin account api_key delete``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Deletes a given API key by its id, it will only work if the informed ID
belongs to the current logged user.
**Usage**:
.. code:: console
$ zanshin account api_key delete [OPTIONS] API_KEY_ID
**Arguments**:
- ``API_KEY_ID``: UUID of the invite to delete [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin account api_key list``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Iterates over the API keys of current logged user.
**Usage**:
.. code:: console
$ zanshin account api_key list [OPTIONS]
**Options**:
- ``--help``: Show this message and exit.
``zanshin account invites``
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Operations on invites from account the API key owner has direct access
to
**Usage**:
.. code:: console
$ zanshin account invites [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--help``: Show this message and exit.
**Commands**:
- ``accept``: Accepts an invitation with the informed ID,...
- ``get``: Gets a specific invitation details, it only...
- ``list``: Iterates over the invites of current logged...
``zanshin account invites accept``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Accepts an invitation with the informed ID, it only works if the user
accepting the invitation is the user that received the invitation.
**Usage**:
.. code:: console
$ zanshin account invites accept [OPTIONS] INVITE_ID
**Arguments**:
- ``INVITE_ID``: UUID of the invite [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin account invites get``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Gets a specific invitation details, it only works if the invitation was
made for the current logged user.
**Usage**:
.. code:: console
$ zanshin account invites get [OPTIONS] INVITE_ID
**Arguments**:
- ``INVITE_ID``: UUID of the invite [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin account invites list``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Iterates over the invites of current logged user.
**Usage**:
.. code:: console
$ zanshin account invites list [OPTIONS]
**Options**:
- ``--help``: Show this message and exit.
``zanshin account me``
~~~~~~~~~~~~~~~~~~~~~~
Returns the details of the user account that owns the API key used by
this Connection instance as per
**Usage**:
.. code:: console
$ zanshin account me [OPTIONS]
**Options**:
- ``--help``: Show this message and exit.
``zanshin alert``
-----------------
Operations on alerts the API key owner has direct access to
**Usage**:
.. code:: console
$ zanshin alert [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--help``: Show this message and exit.
**Commands**:
- ``get``: Returns details about a specified alert
- ``list``: List alerts from a given organization, with...
- ``list_following``: List following alerts from a given...
- ``list_grouped``: List grouped alerts from a given...
- ``list_grouped_following``: List grouped following alerts from a
given...
- ``list_history``: List alerts from a given organization, with...
- ``list_history_following``: List alerts from a given organization,
with...
- ``update``: Updates the alert.
``zanshin alert get``
~~~~~~~~~~~~~~~~~~~~~
Returns details about a specified alert
**Usage**:
.. code:: console
$ zanshin alert get [OPTIONS] ALERT_ID
**Arguments**:
- ``ALERT_ID``: UUID of the alert to look up [required]
**Options**:
- ``--list-history / --no-list-history``: History of this alert.
[default: False]
- ``--list-comments / --no-list-comments``: Comments of this alert.
[default: False]
- ``--help``: Show this message and exit.
``zanshin alert list``
~~~~~~~~~~~~~~~~~~~~~~
List alerts from a given organization, with optional filters by scan
target, state or severity.
**Usage**:
.. code:: console
$ zanshin alert list [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--scan-target-id UUID``: Only list alerts from the specifiedscan
targets.
- ``--states [OPEN|ACTIVE|IN_PROGRESS|RISK_ACCEPTED|MITIGATING_CONTROL|FALSE_POSITIVE|CLOSED]``:
Only list alerts in the specified states. [default: OPEN,
IN_PROGRESS, RISK_ACCEPTED, MITIGATING_CONTROL, FALSE_POSITIVE]
- ``--severity [CRITICAL|HIGH|MEDIUM|LOW|INFO]``: Only list alerts with
the specifiedseverities [default: CRITICAL, HIGH, MEDIUM, LOW, INFO]
- ``--language [pt-BR|en-US]``: Show alert titles in the specified
language [default: en-US]
- ``--created-at-start TEXT``: Date created starts at (format
YYYY-MM-DDTHH:MM:SS)
- ``--created-at-end TEXT``: Date created ends at (format
YYYY-MM-DDTHH:MM:SS)
- ``--updated-at-start TEXT``: Date updated starts at (format
YYYY-MM-DDTHH:MM:SS)
- ``--updated-at-end TEXT``: Date updated ends at (format
YYYY-MM-DDTHH:MM:SS)
- ``--search TEXT``: Text to search for in the alerts [default: ]
- ``--sort [asc|desc]``: Sort order [default: desc]
- ``--order [scanTargetId|resource|rule|severity|state|createdAt|updatedAt]``:
Field to sort results on [default: severity]
- ``--help``: Show this message and exit.
``zanshin alert list_following``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
List following alerts from a given organization, with optional filters
by following ids, state or severity.
**Usage**:
.. code:: console
$ zanshin alert list_following [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--following-ids UUID``: Only list alerts from the specified scan
targets.
- ``--states [OPEN|ACTIVE|IN_PROGRESS|RISK_ACCEPTED|MITIGATING_CONTROL|FALSE_POSITIVE|CLOSED]``:
Only list alerts in the specified states. [default: OPEN,
IN_PROGRESS, RISK_ACCEPTED, MITIGATING_CONTROL, FALSE_POSITIVE]
- ``--severity [CRITICAL|HIGH|MEDIUM|LOW|INFO]``: Only list alerts with
the specified severities [default: CRITICAL, HIGH, MEDIUM, LOW, INFO]
- ``--created-at-start TEXT``: Date created starts at (format
YYYY-MM-DDTHH:MM:SS)
- ``--created-at-end TEXT``: Date created ends at (format
YYYY-MM-DDTHH:MM:SS)
- ``--updated-at-start TEXT``: Date updated starts at (format
YYYY-MM-DDTHH:MM:SS)
- ``--updated-at-end TEXT``: Date updated ends at (format
YYYY-MM-DDTHH:MM:SS)
- ``--search TEXT``: Text to search for in the alerts [default: ]
- ``--sort [asc|desc]``: Sort order [default: desc]
- ``--order [scanTargetId|resource|rule|severity|state|createdAt|updatedAt]``:
Field to sort results on [default: severity]
- ``--help``: Show this message and exit.
``zanshin alert list_grouped``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
List grouped alerts from a given organization, with optional filters by
scan target, state or severity.
**Usage**:
.. code:: console
$ zanshin alert list_grouped [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--scan-target-id UUID``: Only list alerts from the specifiedscan
targets.
- ``--state [OPEN|ACTIVE|IN_PROGRESS|RISK_ACCEPTED|MITIGATING_CONTROL|FALSE_POSITIVE|CLOSED]``:
Only list alerts in the specified states. [default: OPEN,
IN_PROGRESS, RISK_ACCEPTED, MITIGATING_CONTROL, FALSE_POSITIVE]
- ``--severity [CRITICAL|HIGH|MEDIUM|LOW|INFO]``: Only list alerts with
the specifiedseverities [default: CRITICAL, HIGH, MEDIUM, LOW, INFO]
- ``--help``: Show this message and exit.
``zanshin alert list_grouped_following``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
List grouped following alerts from a given organization, with optional
filters by scan target, state or severity.
**Usage**:
.. code:: console
$ zanshin alert list_grouped_following [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--following-ids UUID``: Only list alerts from thespecified scan
targets.
- ``--state [OPEN|ACTIVE|IN_PROGRESS|RISK_ACCEPTED|MITIGATING_CONTROL|FALSE_POSITIVE|CLOSED]``:
Only list alerts in the specified states. [default: OPEN,
IN_PROGRESS, RISK_ACCEPTED, MITIGATING_CONTROL, FALSE_POSITIVE]
- ``--severity [CRITICAL|HIGH|MEDIUM|LOW|INFO]``: Only list alerts with
the specified severities [default: CRITICAL, HIGH, MEDIUM, LOW, INFO]
- ``--help``: Show this message and exit.
``zanshin alert list_history``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
List alerts from a given organization, with optional filters by scan
target, state or severity.
**Usage**:
.. code:: console
$ zanshin alert list_history [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--scan-target-id UUID``: Only list alerts from the specifiedscan
targets.
- ``--cursor TEXT``: Cursor.
- ``--persist / --no-persist``: Persist. [default: False]
- ``--help``: Show this message and exit.
``zanshin alert list_history_following``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
List alerts from a given organization, with optional filters by scan
target, state or severity.
**Usage**:
.. code:: console
$ zanshin alert list_history_following [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--following-ids UUID``: Only list alerts from the specifiedscan
targets.
- ``--cursor TEXT``: Cursor.
- ``--persist / --no-persist``: Persist. [default: False]
- ``--help``: Show this message and exit.
``zanshin alert update``
~~~~~~~~~~~~~~~~~~~~~~~~
Updates the alert.
**Usage**:
.. code:: console
$ zanshin alert update [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID ALERT_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization that owns the alert
[required]
- ``SCAN_TARGET_ID``: UUID of the scan target associated with the alert
[required]
- ``ALERT_ID``: UUID of the alert [required]
**Options**:
- ``--state [OPEN|IN_PROGRESS|RISK_ACCEPTED|MITIGATING_CONTROL|FALSE_POSITIVE]``:
New alert state
- ``--labels TEXT``: Custom label(s) for the alert
- ``--comment TEXT``: A comment when closing the alert with
RISK_ACCEPTED, FALSE_POSITIVE, MITIGATING_CONTROL
- ``--help``: Show this message and exit.
``zanshin init``
----------------
Update settings on configuration file.
**Usage**:
.. code:: console
$ zanshin init [OPTIONS]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization``
------------------------
Operations on organizations the API key owner has direct access to
**Usage**:
.. code:: console
$ zanshin organization [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--help``: Show this message and exit.
**Commands**:
- ``follower``: Operations on followers of organization the...
- ``following``: Operations on following of organization the...
- ``get``: Gets an organization given its ID.
- ``list``: Lists the organizations this user has direct...
- ``member``: Operations on members of organization the API...
- ``scan_target``: Operations on scan targets from organizations...
- ``update``: Gets an organization given its ID.
``zanshin organization follower``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Operations on followers of organization the API key owner has direct
access to
**Usage**:
.. code:: console
$ zanshin organization follower [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--help``: Show this message and exit.
**Commands**:
- ``list``: Lists the followers of organization this user...
- ``request``: Operations on follower requests of...
- ``stop``: Stops one organization follower of another.
``zanshin organization follower list``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Lists the followers of organization this user has direct access to.
**Usage**:
.. code:: console
$ zanshin organization follower list [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization follower request``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Operations on follower requests of organization the API key owner has
directaccess to
**Usage**:
.. code:: console
$ zanshin organization follower request [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--help``: Show this message and exit.
**Commands**:
- ``create``: Create organization follower request.
- ``delete``: Delete organization follower request.
- ``get``: Get organization follower request.
- ``list``: Lists the follower requests of organization...
``zanshin organization follower request create``
''''''''''''''''''''''''''''''''''''''''''''''''
Create organization follower request.
**Usage**:
.. code:: console
$ zanshin organization follower request create [OPTIONS] ORGANIZATION_ID TOKEN
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``TOKEN``: Token of the follower request [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization follower request delete``
''''''''''''''''''''''''''''''''''''''''''''''''
Delete organization follower request.
**Usage**:
.. code:: console
$ zanshin organization follower request delete [OPTIONS] ORGANIZATION_ID TOKEN
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``TOKEN``: Token of the follower request [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization follower request get``
'''''''''''''''''''''''''''''''''''''''''''''
Get organization follower request.
**Usage**:
.. code:: console
$ zanshin organization follower request get [OPTIONS] ORGANIZATION_ID TOKEN
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``TOKEN``: Token of the follower request [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization follower request list``
''''''''''''''''''''''''''''''''''''''''''''''
Lists the follower requests of organization this user has direct access
to.
**Usage**:
.. code:: console
$ zanshin organization follower request list [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization follower stop``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Stops one organization follower of another.
**Usage**:
.. code:: console
$ zanshin organization follower stop [OPTIONS] ORGANIZATION_ID ORGANIZATION_FOLLOWER_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``ORGANIZATION_FOLLOWER_ID``: UUID of the organization follower
[required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization following``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Operations on following of organization the API key owner has direct
access to
**Usage**:
.. code:: console
$ zanshin organization following [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--help``: Show this message and exit.
**Commands**:
- ``list``: Lists the following of organization this user...
- ``request``: Operations on following requests of...
- ``stop``: Stops one organization following of another.
``zanshin organization following list``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Lists the following of organization this user has direct access to.
**Usage**:
.. code:: console
$ zanshin organization following list [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization following request``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Operations on following requests of organization the API key owner
hasdirect access to
**Usage**:
.. code:: console
$ zanshin organization following request [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--help``: Show this message and exit.
**Commands**:
- ``accept``: Accepts a request to follow another...
- ``decline``: Declines a request to follow another...
- ``get``: Returns a request received by an organization...
- ``list``: Lists the following requests of organization...
``zanshin organization following request accept``
'''''''''''''''''''''''''''''''''''''''''''''''''
Accepts a request to follow another organization.
**Usage**:
.. code:: console
$ zanshin organization following request accept [OPTIONS] ORGANIZATION_ID FOLLOWING_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``FOLLOWING_ID``: UUID of the following request [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization following request decline``
''''''''''''''''''''''''''''''''''''''''''''''''''
Declines a request to follow another organization.
**Usage**:
.. code:: console
$ zanshin organization following request decline [OPTIONS] ORGANIZATION_ID FOLLOWING_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``FOLLOWING_ID``: UUID of the following request [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization following request get``
''''''''''''''''''''''''''''''''''''''''''''''
Returns a request received by an organization to follow another.
**Usage**:
.. code:: console
$ zanshin organization following request get [OPTIONS] ORGANIZATION_ID FOLLOWING_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``FOLLOWING_ID``: UUID of the following request [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization following request list``
'''''''''''''''''''''''''''''''''''''''''''''''
Lists the following requests of organization this user has direct access
to.
**Usage**:
.. code:: console
$ zanshin organization following request list [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization following stop``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Stops one organization following of another.
**Usage**:
.. code:: console
$ zanshin organization following stop [OPTIONS] ORGANIZATION_ID ORGANIZATION_FOLLOWING_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``ORGANIZATION_FOLLOWING_ID``: UUID of the organization following
[required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization get``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Gets an organization given its ID.
**Usage**:
.. code:: console
$ zanshin organization get [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization list``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Lists the organizations this user has direct access to as a member.
**Usage**:
.. code:: console
$ zanshin organization list [OPTIONS]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization member``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Operations on members of organization the API key owner has direct
access to
**Usage**:
.. code:: console
$ zanshin organization member [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--help``: Show this message and exit.
**Commands**:
- ``delete``: Delete organization member.
- ``get``: Get organization member.
- ``invite``: Operations on member invites of organization...
- ``list``: Lists the members of organization this user...
- ``update``: Update organization member.
``zanshin organization member delete``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Delete organization member.
**Usage**:
.. code:: console
$ zanshin organization member delete [OPTIONS] ORGANIZATION_ID ORGANIZATION_MEMBER_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``ORGANIZATION_MEMBER_ID``: UUID of the organization member
[required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization member get``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Get organization member.
**Usage**:
.. code:: console
$ zanshin organization member get [OPTIONS] ORGANIZATION_ID ORGANIZATION_MEMBER_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``ORGANIZATION_MEMBER_ID``: UUID of the organization member
[required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization member invite``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Operations on member invites of organization the API key owner has
directaccess to
**Usage**:
.. code:: console
$ zanshin organization member invite [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--help``: Show this message and exit.
**Commands**:
- ``create``: Create organization member invite.
- ``delete``: Delete organization member invite.
- ``get``: Get organization member invite.
- ``list``: Lists the member invites of organization this...
- ``resend``: Resend organization member invitation.
``zanshin organization member invite create``
'''''''''''''''''''''''''''''''''''''''''''''
Create organization member invite.
**Usage**:
.. code:: console
$ zanshin organization member invite create [OPTIONS] ORGANIZATION_ID ORGANIZATION_MEMBER_INVITE_EMAIL
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``ORGANIZATION_MEMBER_INVITE_EMAIL``: E-mail of the organization
member [required]
**Options**:
- ``--organization-member-invite-role [ADMIN]``: Role of the
organization member [default: ADMIN]
- ``--help``: Show this message and exit.
``zanshin organization member invite delete``
'''''''''''''''''''''''''''''''''''''''''''''
Delete organization member invite.
**Usage**:
.. code:: console
$ zanshin organization member invite delete [OPTIONS] ORGANIZATION_ID ORGANIZATION_MEMBER_INVITE_EMAIL
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``ORGANIZATION_MEMBER_INVITE_EMAIL``: E-mail of the organization
member [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization member invite get``
''''''''''''''''''''''''''''''''''''''''''
Get organization member invite.
**Usage**:
.. code:: console
$ zanshin organization member invite get [OPTIONS] ORGANIZATION_ID ORGANIZATION_MEMBER_INVITE_EMAIL
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``ORGANIZATION_MEMBER_INVITE_EMAIL``: E-mail of the organization
member invite [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization member invite list``
'''''''''''''''''''''''''''''''''''''''''''
Lists the member invites of organization this user has direct access to.
**Usage**:
.. code:: console
$ zanshin organization member invite list [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization member invite resend``
'''''''''''''''''''''''''''''''''''''''''''''
Resend organization member invitation.
**Usage**:
.. code:: console
$ zanshin organization member invite resend [OPTIONS] ORGANIZATION_ID ORGANIZATION_MEMBER_INVITE_EMAIL
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``ORGANIZATION_MEMBER_INVITE_EMAIL``: E-mail of the organization
member [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization member list``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Lists the members of organization this user has direct access to.
**Usage**:
.. code:: console
$ zanshin organization member list [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization member update``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Update organization member.
**Usage**:
.. code:: console
$ zanshin organization member update [OPTIONS] ORGANIZATION_ID ORGANIZATION_MEMBER_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``ORGANIZATION_MEMBER_ID``: UUID of the organization member
[required]
**Options**:
- ``--role [ADMIN]``: Role of the organization member [default: ADMIN]
- ``--help``: Show this message and exit.
``zanshin organization scan_target``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Operations on scan targets from organizations the API key owner has
direct access to
**Usage**:
.. code:: console
$ zanshin organization scan_target [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--help``: Show this message and exit.
**Commands**:
- ``check``: Check scan target.
- ``create``: Create a new scan target in organization.
- ``delete``: Delete scan target of organization.
- ``get``: Get scan target of organization.
- ``list``: Lists the scan targets of organization this...
- ``onboard_aws``: Create a new scan target in organization and...
- ``onboard_aws_organization``: For each of selected accounts in AWS...
- ``scan``: Operations on scan targets from organizations...
- ``update``: Update scan target of organization.
``zanshin organization scan_target check``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Check scan target.
**Usage**:
.. code:: console
$ zanshin organization scan_target check [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``SCAN_TARGET_ID``: UUID of the scan target [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization scan_target create``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create a new scan target in organization.
**Usage**:
.. code:: console
$ zanshin organization scan_target create [OPTIONS] ORGANIZATION_ID KIND:[AWS|GCP|AZURE|HUAWEI|DOMAIN|ORACLE] NAME CREDENTIAL [SCHEDULE]:[1h|6h|12h|24h|7d]
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``KIND:[AWS|GCP|AZURE|HUAWEI|DOMAIN|ORACLE]``: kind of the scan
target [required]
- ``NAME``: name of the scan target [required]
- ``CREDENTIAL``: credential of the scan target [required]
- ``[SCHEDULE]:[1h|6h|12h|24h|7d]``: schedule of the scan target
[default: 24h]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization scan_target delete``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Delete scan target of organization.
**Usage**:
.. code:: console
$ zanshin organization scan_target delete [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``SCAN_TARGET_ID``: UUID of the scan target [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization scan_target get``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Get scan target of organization.
**Usage**:
.. code:: console
$ zanshin organization scan_target get [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``SCAN_TARGET_ID``: UUID of the scan target [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization scan_target list``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Lists the scan targets of organization this user has direct access to.
**Usage**:
.. code:: console
$ zanshin organization scan_target list [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization scan_target onboard_aws``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create a new scan target in organization and perform onboard. Requires
boto3 and correct AWS IAM Privileges. Checkout the required AWS IAM
privileges here
`https://github.com/tenchi-security/zanshin-sdk-python/blob/main/zanshinsdk/docs/README.md <https://github.com/tenchi-security/zanshin-sdk-python/blob/main/zanshinsdk/docs/README.md>`__
**Usage**:
.. code:: console
$ zanshin organization scan_target onboard_aws [OPTIONS] REGION ORGANIZATION_ID NAME CREDENTIAL [SCHEDULE]:[1h|6h|12h|24h|7d]
**Arguments**:
- ``REGION``: AWS Region to deploy CloudFormation [required]
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``NAME``: name of the scan target [required]
- ``CREDENTIAL``: credential of the scan target [required]
- ``[SCHEDULE]:[1h|6h|12h|24h|7d]``: schedule of the scan target
[default: 24h]
**Options**:
- ``--boto3-profile TEXT``: Boto3 profile name to use for Onboard AWS
Account
- ``--help``: Show this message and exit.
``zanshin organization scan_target onboard_aws_organization``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
For each of selected accounts in AWS Organization, creates a new Scan
Target in informed zanshin organization and performs onboarding.
Requires boto3 and correct AWS IAM Privileges. Checkout the required AWS
IAM privileges at
`https://github.com/tenchi-security/zanshin-cli/blob/main/zanshincli/docs/README.md <https://github.com/tenchi-security/zanshin-cli/blob/main/zanshincli/docs/README.md>`__
**Usage**:
.. code:: console
$ zanshin organization scan_target onboard_aws_organization [OPTIONS] REGION ORGANIZATION_ID [SCHEDULE]:[1h|6h|12h|24h|7d]
**Arguments**:
- ``REGION``: AWS Region to deploy CloudFormation [required]
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``[SCHEDULE]:[1h|6h|12h|24h|7d]``: schedule of the scan target
[default: 24h]
**Options**:
- ``--target-accounts [ALL|MASTER|MEMBERS|NONE]``: choose which
accounts to onboard
- ``--exclude-account TEXT``: ID, Name, E-mail or ARN of AWS Account
not to be onboarded
- ``--boto3-profile TEXT``: Boto3 profile name to use for Onboard AWS
Account
- ``--aws-role-name TEXT``: Name of AWS role that allow access from
Management Account to Member accounts [default:
OrganizationAccountAccessRole]
- ``--help``: Show this message and exit.
``zanshin organization scan_target scan``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Operations on scan targets from organizations the API key owner has
direct access to
**Usage**:
.. code:: console
$ zanshin organization scan_target scan [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--help``: Show this message and exit.
**Commands**:
- ``get``: Get scan of scan target.
- ``list``: Lists the scan target scans of organization...
- ``start``: Starts a scan on the specified scan target.
- ``stop``: Stop a scan on the specified scan target.
``zanshin organization scan_target scan get``
'''''''''''''''''''''''''''''''''''''''''''''
Get scan of scan target.
**Usage**:
.. code:: console
$ zanshin organization scan_target scan get [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID SCAN_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``SCAN_TARGET_ID``: UUID of the scan target [required]
- ``SCAN_ID``: UUID of the scan [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization scan_target scan list``
''''''''''''''''''''''''''''''''''''''''''''''
Lists the scan target scans of organization this user has direct access
to.
**Usage**:
.. code:: console
$ zanshin organization scan_target scan list [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``SCAN_TARGET_ID``: UUID of the scan target [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization scan_target scan start``
'''''''''''''''''''''''''''''''''''''''''''''''
Starts a scan on the specified scan target.
**Usage**:
.. code:: console
$ zanshin organization scan_target scan start [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``SCAN_TARGET_ID``: UUID of the scan target [required]
**Options**:
- ``--force / --no-force``: Whether to force running a scan target that
has state INVALID_CREDENTIAL or NEW [default: False]
- ``--help``: Show this message and exit.
``zanshin organization scan_target scan stop``
''''''''''''''''''''''''''''''''''''''''''''''
Stop a scan on the specified scan target.
**Usage**:
.. code:: console
$ zanshin organization scan_target scan stop [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``SCAN_TARGET_ID``: UUID of the scan target [required]
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization scan_target update``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Update scan target of organization.
**Usage**:
.. code:: console
$ zanshin organization scan_target update [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID [NAME] [SCHEDULE]:[1h|6h|12h|24h|7d]
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``SCAN_TARGET_ID``: UUID of the scan target [required]
- ``[NAME]``: name of the scan target
- ``[SCHEDULE]:[1h|6h|12h|24h|7d]``: schedule of the scan target
**Options**:
- ``--help``: Show this message and exit.
``zanshin organization update``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Gets an organization given its ID.
**Usage**:
.. code:: console
$ zanshin organization update [OPTIONS] ORGANIZATION_ID [NAME] [PICTURE] [EMAIL]
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
- ``[NAME]``: Name of the organization
- ``[PICTURE]``: Picture of the organization
- ``[EMAIL]``: Contact e-mail of the organization
**Options**:
- ``--help``: Show this message and exit.
``zanshin summary``
-------------------
Operations on summaries the API key owner has direct access to
**Usage**:
.. code:: console
$ zanshin summary [OPTIONS] COMMAND [ARGS]...
**Options**:
- ``--help``: Show this message and exit.
**Commands**:
- ``alert``: Gets a summary of the current state of alerts...
- ``alert_following``: Gets a summary of the current state of alerts...
- ``scan``: Returns summaries of scan results over a...
- ``scan_following``: Returns summaries of scan results over a...
``zanshin summary alert``
~~~~~~~~~~~~~~~~~~~~~~~~~
Gets a summary of the current state of alerts for an organization, both
in total and broken down by scan target.
**Usage**:
.. code:: console
$ zanshin summary alert [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--scan-target-id UUID``: Only summarize alerts from the
specifiedscan targets, defaults to all.
- ``--help``: Show this message and exit.
``zanshin summary alert_following``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Gets a summary of the current state of alerts for followed
organizations.
**Usage**:
.. code:: console
$ zanshin summary alert_following [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--following-ids UUID``: Only summarize alerts from thespecified
following, defaults toall.
- ``--help``: Show this message and exit.
``zanshin summary scan``
~~~~~~~~~~~~~~~~~~~~~~~~
Returns summaries of scan results over a period of time, summarizing
number of alerts that changed states.
**Usage**:
.. code:: console
$ zanshin summary scan [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--scan-target-ids UUID``: Only summarize alerts from the
specifiedscan targets, defaults to all.
- ``--days INTEGER``: Number of days to go back in time in historical
search [default: 7]
- ``--help``: Show this message and exit.
``zanshin summary scan_following``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Returns summaries of scan results over a period of time, summarizing
number of alerts that changed states.
**Usage**:
.. code:: console
$ zanshin summary scan_following [OPTIONS] ORGANIZATION_ID
**Arguments**:
- ``ORGANIZATION_ID``: UUID of the organization [required]
**Options**:
- ``--following-ids UUID``: Only summarize alerts from thespecified
following, defaults toall.
- ``--days INTEGER``: Number of days to go back in time in
historicalsearch [default: 7]
- ``--help``: Show this message and exit.
``zanshin version``
-------------------
Display the program and Python versions in use.
**Usage**:
.. code:: console
$ zanshin version [OPTIONS]
**Options**:
- ``--help``: Show this message and exit.
.. |PyPI version shields.io| image:: https://img.shields.io/pypi/v/zanshincli.svg
:target: https://pypi.python.org/pypi/zanshincli/
.. |PyPI pyversions| image:: https://img.shields.io/pypi/pyversions/zanshincli.svg
:target: https://pypi.python.org/pypi/zanshincli/
Raw data
{
"_id": null,
"home_page": "https://github.com/tenchi-security/zanshin-cli",
"name": "zanshincli",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Tenchi Security",
"author_email": "contact@tenchisecurity.com",
"download_url": "https://files.pythonhosted.org/packages/2a/6b/534814a5844024f4857f8f3b1affc2e9401f8d0d7359cbd6d8e7c9ec5fa2/zanshincli-1.5.1.tar.gz",
"platform": "any",
"description": "|PyPI version shields.io| |PyPI pyversions|\n\nZanshin CLI\n===========\n\nThis Python package provides a command-line utility to interact with the\n`API of the Zanshin SaaS\nservice <https://api.zanshin.tenchisecurity.com>`__ from `Tenchi\nSecurity <https://www.tenchisecurity.com>`__.\n\nIs it based on the Zanshin Python SDK available on\n`Github <https://github.com/tenchi-security/zanshin-sdk-python>`__ and\n`PyPI <https://pypi.python.org/pypi/zanshinsdk/>`__.\n\nIf you are a Zanshin customer and have any questions regarding the use\nof the service, its API or this command-line utility, please get in\ntouch via e-mail at support {at} tenchisecurity {dot} com or via the\nsupport widget on the `Zanshin\nPortal <https://zanshin.tenchisecurity.com>`__.\n\nInstallation\n------------\n\nWe recommend the CLI is installed using\n`pipx <https://pypa.github.io/pipx/installation/>`__, using the command:\n\n.. code:: shell\n\n pipx install zanshincli\n\nWhen a new version is available, you can upgrade it with:\n\n.. code:: shell\n\n pipx upgrade zanshincli\n\nConfiguration File\n------------------\n\nThe way the SDK and CLI handles credentials is by using a configuration\nfile in the format created by the Python\n`RawConfigParser <https://docs.python.org/3/library/configparser.html#configparser.RawConfigParser>`__\nclass.\n\nThe file is located at ``~/.tenchi/config``, where ``~`` is the `current\nuser's home\ndirectory <https://docs.python.org/3/library/pathlib.html#pathlib.Path.home>`__.\n\nEach section is treated as a configuration profile, and the SDK and CLI\nwill look for a section called ``default`` if another is not explicitly\nselected.\n\nThese are the supported options:\n\n- ``api_key`` (required) which contains the Zanshin API key obtained at\n the `Zanshin web\n portal <https://zanshin.tenchisecurity.com/my-profile>`__.\n- ``user_agent`` (optional) allows you to override the default\n user-agent header used by the SDK when making API requests.\n- ``api_url`` (optional) directs the SDK and CLI to use a different API\n endpoint than the default\n (`https://api.zanshin.tenchisecurity.com <https://api.zanshin.tenchisecurity.com>`__).\n\nYou can populate the file with the ``zanshin init`` command of the CLI\ntool. This is what a minimal configuration file would look like:\n\n.. code:: ini\n\n [default]\n api_key = abcdefghijklmnopqrstuvxyz\n\nUsing the CLI Utility\n---------------------\n\nThis package installs a command-line utility called ``zanshin`` built\nwith the great `Typer <https://typer.tiangolo.com/>`__ package.\n\nYou can obtain help by using the ``--help`` option.\n\nKeep in mind that when options are present that expect multiple values,\nthese need to be provided as multiple options. For example if you wanted\nto list an organization's alerts filtering by the OPEN and RISK_ACCEPTED\nstates, this is the command you would use:\n\n.. code:: shell\n\n $ zanshin organization alerts d48edaa6-871a-4082-a196-4daab372d4a1 --state OPEN --state RISK_ACCEPTED\n\nCommand Reference\n-----------------\n\n``zanshin``\n===========\n\nCommand-line utility to interact with the Zanshin SaaS service offered\nby Tenchi Security\n(`https://tenchisecurity.com <https://tenchisecurity.com>`__), go to\n`https://github.com/tenchi-security/zanshin-cli <https://github.com/tenchi-security/zanshin-cli>`__\nfor license, source code and documentation\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--profile TEXT``: Configuration file section to read API keyand\n configuration from [default: default]\n- ``--format [json|table|csv|html]``: Output format to use for list\n operations [default: json]\n- ``--verbose / --no-verbose``: Print more information to stderr\n [default: True]\n- ``--debug / --no-debug``: Enable debug logging in the SDK [default:\n False]\n- ``--install-completion``: Install completion for the current shell.\n- ``--show-completion``: Show completion for the current shell, to copy\n it or customize the installation.\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``account``: Operations on user the API key owner has...\n- ``alert``: Operations on alerts the API key owner has...\n- ``init``: Update settings on configuration file.\n- ``organization``: Operations on organizations the API key owner...\n- ``summary``: Operations on summaries the API key owner has...\n- ``version``: Display the program and Python versions in...\n\n``zanshin account``\n-------------------\n\nOperations on user the API key owner has direct access to\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin account [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``api_key``: Operations on API keys from account the API...\n- ``invites``: Operations on invites from account the API...\n- ``me``: Returns the details of the user account that...\n\n``zanshin account api_key``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nOperations on API keys from account the API key owner has direct access\nto\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin account api_key [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``create``: Creates a new API key for the current logged...\n- ``delete``: Deletes a given API key by its id, it will...\n- ``list``: Iterates over the API keys of current logged...\n\n``zanshin account api_key create``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nCreates a new API key for the current logged user, API Keys can be used\nto interact with the zanshin api directly a behalf of that user.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin account api_key create [OPTIONS] NAME\n\n**Arguments**:\n\n- ``NAME``: Name of the new API key [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin account api_key delete``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nDeletes a given API key by its id, it will only work if the informed ID\nbelongs to the current logged user.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin account api_key delete [OPTIONS] API_KEY_ID\n\n**Arguments**:\n\n- ``API_KEY_ID``: UUID of the invite to delete [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin account api_key list``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nIterates over the API keys of current logged user.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin account api_key list [OPTIONS]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin account invites``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nOperations on invites from account the API key owner has direct access\nto\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin account invites [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``accept``: Accepts an invitation with the informed ID,...\n- ``get``: Gets a specific invitation details, it only...\n- ``list``: Iterates over the invites of current logged...\n\n``zanshin account invites accept``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nAccepts an invitation with the informed ID, it only works if the user\naccepting the invitation is the user that received the invitation.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin account invites accept [OPTIONS] INVITE_ID\n\n**Arguments**:\n\n- ``INVITE_ID``: UUID of the invite [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin account invites get``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nGets a specific invitation details, it only works if the invitation was\nmade for the current logged user.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin account invites get [OPTIONS] INVITE_ID\n\n**Arguments**:\n\n- ``INVITE_ID``: UUID of the invite [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin account invites list``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nIterates over the invites of current logged user.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin account invites list [OPTIONS]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin account me``\n~~~~~~~~~~~~~~~~~~~~~~\n\nReturns the details of the user account that owns the API key used by\nthis Connection instance as per\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin account me [OPTIONS]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin alert``\n-----------------\n\nOperations on alerts the API key owner has direct access to\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin alert [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``get``: Returns details about a specified alert\n- ``list``: List alerts from a given organization, with...\n- ``list_following``: List following alerts from a given...\n- ``list_grouped``: List grouped alerts from a given...\n- ``list_grouped_following``: List grouped following alerts from a\n given...\n- ``list_history``: List alerts from a given organization, with...\n- ``list_history_following``: List alerts from a given organization,\n with...\n- ``update``: Updates the alert.\n\n``zanshin alert get``\n~~~~~~~~~~~~~~~~~~~~~\n\nReturns details about a specified alert\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin alert get [OPTIONS] ALERT_ID\n\n**Arguments**:\n\n- ``ALERT_ID``: UUID of the alert to look up [required]\n\n**Options**:\n\n- ``--list-history / --no-list-history``: History of this alert.\n [default: False]\n- ``--list-comments / --no-list-comments``: Comments of this alert.\n [default: False]\n- ``--help``: Show this message and exit.\n\n``zanshin alert list``\n~~~~~~~~~~~~~~~~~~~~~~\n\nList alerts from a given organization, with optional filters by scan\ntarget, state or severity.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin alert list [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--scan-target-id UUID``: Only list alerts from the specifiedscan\n targets.\n- ``--states [OPEN|ACTIVE|IN_PROGRESS|RISK_ACCEPTED|MITIGATING_CONTROL|FALSE_POSITIVE|CLOSED]``:\n Only list alerts in the specified states. [default: OPEN,\n IN_PROGRESS, RISK_ACCEPTED, MITIGATING_CONTROL, FALSE_POSITIVE]\n- ``--severity [CRITICAL|HIGH|MEDIUM|LOW|INFO]``: Only list alerts with\n the specifiedseverities [default: CRITICAL, HIGH, MEDIUM, LOW, INFO]\n- ``--language [pt-BR|en-US]``: Show alert titles in the specified\n language [default: en-US]\n- ``--created-at-start TEXT``: Date created starts at (format\n YYYY-MM-DDTHH:MM:SS)\n- ``--created-at-end TEXT``: Date created ends at (format\n YYYY-MM-DDTHH:MM:SS)\n- ``--updated-at-start TEXT``: Date updated starts at (format\n YYYY-MM-DDTHH:MM:SS)\n- ``--updated-at-end TEXT``: Date updated ends at (format\n YYYY-MM-DDTHH:MM:SS)\n- ``--search TEXT``: Text to search for in the alerts [default: ]\n- ``--sort [asc|desc]``: Sort order [default: desc]\n- ``--order [scanTargetId|resource|rule|severity|state|createdAt|updatedAt]``:\n Field to sort results on [default: severity]\n- ``--help``: Show this message and exit.\n\n``zanshin alert list_following``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nList following alerts from a given organization, with optional filters\nby following ids, state or severity.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin alert list_following [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--following-ids UUID``: Only list alerts from the specified scan\n targets.\n- ``--states [OPEN|ACTIVE|IN_PROGRESS|RISK_ACCEPTED|MITIGATING_CONTROL|FALSE_POSITIVE|CLOSED]``:\n Only list alerts in the specified states. [default: OPEN,\n IN_PROGRESS, RISK_ACCEPTED, MITIGATING_CONTROL, FALSE_POSITIVE]\n- ``--severity [CRITICAL|HIGH|MEDIUM|LOW|INFO]``: Only list alerts with\n the specified severities [default: CRITICAL, HIGH, MEDIUM, LOW, INFO]\n- ``--created-at-start TEXT``: Date created starts at (format\n YYYY-MM-DDTHH:MM:SS)\n- ``--created-at-end TEXT``: Date created ends at (format\n YYYY-MM-DDTHH:MM:SS)\n- ``--updated-at-start TEXT``: Date updated starts at (format\n YYYY-MM-DDTHH:MM:SS)\n- ``--updated-at-end TEXT``: Date updated ends at (format\n YYYY-MM-DDTHH:MM:SS)\n- ``--search TEXT``: Text to search for in the alerts [default: ]\n- ``--sort [asc|desc]``: Sort order [default: desc]\n- ``--order [scanTargetId|resource|rule|severity|state|createdAt|updatedAt]``:\n Field to sort results on [default: severity]\n- ``--help``: Show this message and exit.\n\n``zanshin alert list_grouped``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nList grouped alerts from a given organization, with optional filters by\nscan target, state or severity.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin alert list_grouped [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--scan-target-id UUID``: Only list alerts from the specifiedscan\n targets.\n- ``--state [OPEN|ACTIVE|IN_PROGRESS|RISK_ACCEPTED|MITIGATING_CONTROL|FALSE_POSITIVE|CLOSED]``:\n Only list alerts in the specified states. [default: OPEN,\n IN_PROGRESS, RISK_ACCEPTED, MITIGATING_CONTROL, FALSE_POSITIVE]\n- ``--severity [CRITICAL|HIGH|MEDIUM|LOW|INFO]``: Only list alerts with\n the specifiedseverities [default: CRITICAL, HIGH, MEDIUM, LOW, INFO]\n- ``--help``: Show this message and exit.\n\n``zanshin alert list_grouped_following``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nList grouped following alerts from a given organization, with optional\nfilters by scan target, state or severity.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin alert list_grouped_following [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--following-ids UUID``: Only list alerts from thespecified scan\n targets.\n- ``--state [OPEN|ACTIVE|IN_PROGRESS|RISK_ACCEPTED|MITIGATING_CONTROL|FALSE_POSITIVE|CLOSED]``:\n Only list alerts in the specified states. [default: OPEN,\n IN_PROGRESS, RISK_ACCEPTED, MITIGATING_CONTROL, FALSE_POSITIVE]\n- ``--severity [CRITICAL|HIGH|MEDIUM|LOW|INFO]``: Only list alerts with\n the specified severities [default: CRITICAL, HIGH, MEDIUM, LOW, INFO]\n- ``--help``: Show this message and exit.\n\n``zanshin alert list_history``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nList alerts from a given organization, with optional filters by scan\ntarget, state or severity.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin alert list_history [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--scan-target-id UUID``: Only list alerts from the specifiedscan\n targets.\n- ``--cursor TEXT``: Cursor.\n- ``--persist / --no-persist``: Persist. [default: False]\n- ``--help``: Show this message and exit.\n\n``zanshin alert list_history_following``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nList alerts from a given organization, with optional filters by scan\ntarget, state or severity.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin alert list_history_following [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--following-ids UUID``: Only list alerts from the specifiedscan\n targets.\n- ``--cursor TEXT``: Cursor.\n- ``--persist / --no-persist``: Persist. [default: False]\n- ``--help``: Show this message and exit.\n\n``zanshin alert update``\n~~~~~~~~~~~~~~~~~~~~~~~~\n\nUpdates the alert.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin alert update [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID ALERT_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization that owns the alert\n [required]\n- ``SCAN_TARGET_ID``: UUID of the scan target associated with the alert\n [required]\n- ``ALERT_ID``: UUID of the alert [required]\n\n**Options**:\n\n- ``--state [OPEN|IN_PROGRESS|RISK_ACCEPTED|MITIGATING_CONTROL|FALSE_POSITIVE]``:\n New alert state\n- ``--labels TEXT``: Custom label(s) for the alert\n- ``--comment TEXT``: A comment when closing the alert with\n RISK_ACCEPTED, FALSE_POSITIVE, MITIGATING_CONTROL\n- ``--help``: Show this message and exit.\n\n``zanshin init``\n----------------\n\nUpdate settings on configuration file.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin init [OPTIONS]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization``\n------------------------\n\nOperations on organizations the API key owner has direct access to\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``follower``: Operations on followers of organization the...\n- ``following``: Operations on following of organization the...\n- ``get``: Gets an organization given its ID.\n- ``list``: Lists the organizations this user has direct...\n- ``member``: Operations on members of organization the API...\n- ``scan_target``: Operations on scan targets from organizations...\n- ``update``: Gets an organization given its ID.\n\n``zanshin organization follower``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nOperations on followers of organization the API key owner has direct\naccess to\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization follower [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``list``: Lists the followers of organization this user...\n- ``request``: Operations on follower requests of...\n- ``stop``: Stops one organization follower of another.\n\n``zanshin organization follower list``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nLists the followers of organization this user has direct access to.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization follower list [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization follower request``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nOperations on follower requests of organization the API key owner has\ndirectaccess to\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization follower request [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``create``: Create organization follower request.\n- ``delete``: Delete organization follower request.\n- ``get``: Get organization follower request.\n- ``list``: Lists the follower requests of organization...\n\n``zanshin organization follower request create``\n''''''''''''''''''''''''''''''''''''''''''''''''\n\nCreate organization follower request.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization follower request create [OPTIONS] ORGANIZATION_ID TOKEN\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``TOKEN``: Token of the follower request [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization follower request delete``\n''''''''''''''''''''''''''''''''''''''''''''''''\n\nDelete organization follower request.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization follower request delete [OPTIONS] ORGANIZATION_ID TOKEN\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``TOKEN``: Token of the follower request [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization follower request get``\n'''''''''''''''''''''''''''''''''''''''''''''\n\nGet organization follower request.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization follower request get [OPTIONS] ORGANIZATION_ID TOKEN\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``TOKEN``: Token of the follower request [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization follower request list``\n''''''''''''''''''''''''''''''''''''''''''''''\n\nLists the follower requests of organization this user has direct access\nto.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization follower request list [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization follower stop``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nStops one organization follower of another.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization follower stop [OPTIONS] ORGANIZATION_ID ORGANIZATION_FOLLOWER_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``ORGANIZATION_FOLLOWER_ID``: UUID of the organization follower\n [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization following``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nOperations on following of organization the API key owner has direct\naccess to\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization following [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``list``: Lists the following of organization this user...\n- ``request``: Operations on following requests of...\n- ``stop``: Stops one organization following of another.\n\n``zanshin organization following list``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nLists the following of organization this user has direct access to.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization following list [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization following request``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nOperations on following requests of organization the API key owner\nhasdirect access to\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization following request [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``accept``: Accepts a request to follow another...\n- ``decline``: Declines a request to follow another...\n- ``get``: Returns a request received by an organization...\n- ``list``: Lists the following requests of organization...\n\n``zanshin organization following request accept``\n'''''''''''''''''''''''''''''''''''''''''''''''''\n\nAccepts a request to follow another organization.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization following request accept [OPTIONS] ORGANIZATION_ID FOLLOWING_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``FOLLOWING_ID``: UUID of the following request [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization following request decline``\n''''''''''''''''''''''''''''''''''''''''''''''''''\n\nDeclines a request to follow another organization.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization following request decline [OPTIONS] ORGANIZATION_ID FOLLOWING_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``FOLLOWING_ID``: UUID of the following request [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization following request get``\n''''''''''''''''''''''''''''''''''''''''''''''\n\nReturns a request received by an organization to follow another.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization following request get [OPTIONS] ORGANIZATION_ID FOLLOWING_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``FOLLOWING_ID``: UUID of the following request [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization following request list``\n'''''''''''''''''''''''''''''''''''''''''''''''\n\nLists the following requests of organization this user has direct access\nto.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization following request list [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization following stop``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nStops one organization following of another.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization following stop [OPTIONS] ORGANIZATION_ID ORGANIZATION_FOLLOWING_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``ORGANIZATION_FOLLOWING_ID``: UUID of the organization following\n [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization get``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nGets an organization given its ID.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization get [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization list``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nLists the organizations this user has direct access to as a member.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization list [OPTIONS]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization member``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nOperations on members of organization the API key owner has direct\naccess to\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization member [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``delete``: Delete organization member.\n- ``get``: Get organization member.\n- ``invite``: Operations on member invites of organization...\n- ``list``: Lists the members of organization this user...\n- ``update``: Update organization member.\n\n``zanshin organization member delete``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nDelete organization member.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization member delete [OPTIONS] ORGANIZATION_ID ORGANIZATION_MEMBER_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``ORGANIZATION_MEMBER_ID``: UUID of the organization member\n [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization member get``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nGet organization member.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization member get [OPTIONS] ORGANIZATION_ID ORGANIZATION_MEMBER_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``ORGANIZATION_MEMBER_ID``: UUID of the organization member\n [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization member invite``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nOperations on member invites of organization the API key owner has\ndirectaccess to\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization member invite [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``create``: Create organization member invite.\n- ``delete``: Delete organization member invite.\n- ``get``: Get organization member invite.\n- ``list``: Lists the member invites of organization this...\n- ``resend``: Resend organization member invitation.\n\n``zanshin organization member invite create``\n'''''''''''''''''''''''''''''''''''''''''''''\n\nCreate organization member invite.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization member invite create [OPTIONS] ORGANIZATION_ID ORGANIZATION_MEMBER_INVITE_EMAIL\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``ORGANIZATION_MEMBER_INVITE_EMAIL``: E-mail of the organization\n member [required]\n\n**Options**:\n\n- ``--organization-member-invite-role [ADMIN]``: Role of the\n organization member [default: ADMIN]\n- ``--help``: Show this message and exit.\n\n``zanshin organization member invite delete``\n'''''''''''''''''''''''''''''''''''''''''''''\n\nDelete organization member invite.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization member invite delete [OPTIONS] ORGANIZATION_ID ORGANIZATION_MEMBER_INVITE_EMAIL\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``ORGANIZATION_MEMBER_INVITE_EMAIL``: E-mail of the organization\n member [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization member invite get``\n''''''''''''''''''''''''''''''''''''''''''\n\nGet organization member invite.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization member invite get [OPTIONS] ORGANIZATION_ID ORGANIZATION_MEMBER_INVITE_EMAIL\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``ORGANIZATION_MEMBER_INVITE_EMAIL``: E-mail of the organization\n member invite [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization member invite list``\n'''''''''''''''''''''''''''''''''''''''''''\n\nLists the member invites of organization this user has direct access to.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization member invite list [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization member invite resend``\n'''''''''''''''''''''''''''''''''''''''''''''\n\nResend organization member invitation.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization member invite resend [OPTIONS] ORGANIZATION_ID ORGANIZATION_MEMBER_INVITE_EMAIL\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``ORGANIZATION_MEMBER_INVITE_EMAIL``: E-mail of the organization\n member [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization member list``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nLists the members of organization this user has direct access to.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization member list [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization member update``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nUpdate organization member.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization member update [OPTIONS] ORGANIZATION_ID ORGANIZATION_MEMBER_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``ORGANIZATION_MEMBER_ID``: UUID of the organization member\n [required]\n\n**Options**:\n\n- ``--role [ADMIN]``: Role of the organization member [default: ADMIN]\n- ``--help``: Show this message and exit.\n\n``zanshin organization scan_target``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nOperations on scan targets from organizations the API key owner has\ndirect access to\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization scan_target [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``check``: Check scan target.\n- ``create``: Create a new scan target in organization.\n- ``delete``: Delete scan target of organization.\n- ``get``: Get scan target of organization.\n- ``list``: Lists the scan targets of organization this...\n- ``onboard_aws``: Create a new scan target in organization and...\n- ``onboard_aws_organization``: For each of selected accounts in AWS...\n- ``scan``: Operations on scan targets from organizations...\n- ``update``: Update scan target of organization.\n\n``zanshin organization scan_target check``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nCheck scan target.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization scan_target check [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``SCAN_TARGET_ID``: UUID of the scan target [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization scan_target create``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nCreate a new scan target in organization.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization scan_target create [OPTIONS] ORGANIZATION_ID KIND:[AWS|GCP|AZURE|HUAWEI|DOMAIN|ORACLE] NAME CREDENTIAL [SCHEDULE]:[1h|6h|12h|24h|7d]\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``KIND:[AWS|GCP|AZURE|HUAWEI|DOMAIN|ORACLE]``: kind of the scan\n target [required]\n- ``NAME``: name of the scan target [required]\n- ``CREDENTIAL``: credential of the scan target [required]\n- ``[SCHEDULE]:[1h|6h|12h|24h|7d]``: schedule of the scan target\n [default: 24h]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization scan_target delete``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nDelete scan target of organization.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization scan_target delete [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``SCAN_TARGET_ID``: UUID of the scan target [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization scan_target get``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nGet scan target of organization.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization scan_target get [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``SCAN_TARGET_ID``: UUID of the scan target [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization scan_target list``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nLists the scan targets of organization this user has direct access to.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization scan_target list [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization scan_target onboard_aws``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nCreate a new scan target in organization and perform onboard. Requires\nboto3 and correct AWS IAM Privileges. Checkout the required AWS IAM\nprivileges here\n`https://github.com/tenchi-security/zanshin-sdk-python/blob/main/zanshinsdk/docs/README.md <https://github.com/tenchi-security/zanshin-sdk-python/blob/main/zanshinsdk/docs/README.md>`__\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization scan_target onboard_aws [OPTIONS] REGION ORGANIZATION_ID NAME CREDENTIAL [SCHEDULE]:[1h|6h|12h|24h|7d]\n\n**Arguments**:\n\n- ``REGION``: AWS Region to deploy CloudFormation [required]\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``NAME``: name of the scan target [required]\n- ``CREDENTIAL``: credential of the scan target [required]\n- ``[SCHEDULE]:[1h|6h|12h|24h|7d]``: schedule of the scan target\n [default: 24h]\n\n**Options**:\n\n- ``--boto3-profile TEXT``: Boto3 profile name to use for Onboard AWS\n Account\n- ``--help``: Show this message and exit.\n\n``zanshin organization scan_target onboard_aws_organization``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nFor each of selected accounts in AWS Organization, creates a new Scan\nTarget in informed zanshin organization and performs onboarding.\nRequires boto3 and correct AWS IAM Privileges. Checkout the required AWS\nIAM privileges at\n`https://github.com/tenchi-security/zanshin-cli/blob/main/zanshincli/docs/README.md <https://github.com/tenchi-security/zanshin-cli/blob/main/zanshincli/docs/README.md>`__\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization scan_target onboard_aws_organization [OPTIONS] REGION ORGANIZATION_ID [SCHEDULE]:[1h|6h|12h|24h|7d]\n\n**Arguments**:\n\n- ``REGION``: AWS Region to deploy CloudFormation [required]\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``[SCHEDULE]:[1h|6h|12h|24h|7d]``: schedule of the scan target\n [default: 24h]\n\n**Options**:\n\n- ``--target-accounts [ALL|MASTER|MEMBERS|NONE]``: choose which\n accounts to onboard\n- ``--exclude-account TEXT``: ID, Name, E-mail or ARN of AWS Account\n not to be onboarded\n- ``--boto3-profile TEXT``: Boto3 profile name to use for Onboard AWS\n Account\n- ``--aws-role-name TEXT``: Name of AWS role that allow access from\n Management Account to Member accounts [default:\n OrganizationAccountAccessRole]\n- ``--help``: Show this message and exit.\n\n``zanshin organization scan_target scan``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nOperations on scan targets from organizations the API key owner has\ndirect access to\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization scan_target scan [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``get``: Get scan of scan target.\n- ``list``: Lists the scan target scans of organization...\n- ``start``: Starts a scan on the specified scan target.\n- ``stop``: Stop a scan on the specified scan target.\n\n``zanshin organization scan_target scan get``\n'''''''''''''''''''''''''''''''''''''''''''''\n\nGet scan of scan target.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization scan_target scan get [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID SCAN_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``SCAN_TARGET_ID``: UUID of the scan target [required]\n- ``SCAN_ID``: UUID of the scan [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization scan_target scan list``\n''''''''''''''''''''''''''''''''''''''''''''''\n\nLists the scan target scans of organization this user has direct access\nto.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization scan_target scan list [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``SCAN_TARGET_ID``: UUID of the scan target [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization scan_target scan start``\n'''''''''''''''''''''''''''''''''''''''''''''''\n\nStarts a scan on the specified scan target.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization scan_target scan start [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``SCAN_TARGET_ID``: UUID of the scan target [required]\n\n**Options**:\n\n- ``--force / --no-force``: Whether to force running a scan target that\n has state INVALID_CREDENTIAL or NEW [default: False]\n- ``--help``: Show this message and exit.\n\n``zanshin organization scan_target scan stop``\n''''''''''''''''''''''''''''''''''''''''''''''\n\nStop a scan on the specified scan target.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization scan_target scan stop [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``SCAN_TARGET_ID``: UUID of the scan target [required]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization scan_target update``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nUpdate scan target of organization.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization scan_target update [OPTIONS] ORGANIZATION_ID SCAN_TARGET_ID [NAME] [SCHEDULE]:[1h|6h|12h|24h|7d]\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``SCAN_TARGET_ID``: UUID of the scan target [required]\n- ``[NAME]``: name of the scan target\n- ``[SCHEDULE]:[1h|6h|12h|24h|7d]``: schedule of the scan target\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin organization update``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nGets an organization given its ID.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin organization update [OPTIONS] ORGANIZATION_ID [NAME] [PICTURE] [EMAIL]\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n- ``[NAME]``: Name of the organization\n- ``[PICTURE]``: Picture of the organization\n- ``[EMAIL]``: Contact e-mail of the organization\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n``zanshin summary``\n-------------------\n\nOperations on summaries the API key owner has direct access to\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin summary [OPTIONS] COMMAND [ARGS]...\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n**Commands**:\n\n- ``alert``: Gets a summary of the current state of alerts...\n- ``alert_following``: Gets a summary of the current state of alerts...\n- ``scan``: Returns summaries of scan results over a...\n- ``scan_following``: Returns summaries of scan results over a...\n\n``zanshin summary alert``\n~~~~~~~~~~~~~~~~~~~~~~~~~\n\nGets a summary of the current state of alerts for an organization, both\nin total and broken down by scan target.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin summary alert [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--scan-target-id UUID``: Only summarize alerts from the\n specifiedscan targets, defaults to all.\n- ``--help``: Show this message and exit.\n\n``zanshin summary alert_following``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nGets a summary of the current state of alerts for followed\norganizations.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin summary alert_following [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--following-ids UUID``: Only summarize alerts from thespecified\n following, defaults toall.\n- ``--help``: Show this message and exit.\n\n``zanshin summary scan``\n~~~~~~~~~~~~~~~~~~~~~~~~\n\nReturns summaries of scan results over a period of time, summarizing\nnumber of alerts that changed states.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin summary scan [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--scan-target-ids UUID``: Only summarize alerts from the\n specifiedscan targets, defaults to all.\n- ``--days INTEGER``: Number of days to go back in time in historical\n search [default: 7]\n- ``--help``: Show this message and exit.\n\n``zanshin summary scan_following``\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nReturns summaries of scan results over a period of time, summarizing\nnumber of alerts that changed states.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin summary scan_following [OPTIONS] ORGANIZATION_ID\n\n**Arguments**:\n\n- ``ORGANIZATION_ID``: UUID of the organization [required]\n\n**Options**:\n\n- ``--following-ids UUID``: Only summarize alerts from thespecified\n following, defaults toall.\n- ``--days INTEGER``: Number of days to go back in time in\n historicalsearch [default: 7]\n- ``--help``: Show this message and exit.\n\n``zanshin version``\n-------------------\n\nDisplay the program and Python versions in use.\n\n**Usage**:\n\n.. code:: console\n\n $ zanshin version [OPTIONS]\n\n**Options**:\n\n- ``--help``: Show this message and exit.\n\n.. |PyPI version shields.io| image:: https://img.shields.io/pypi/v/zanshincli.svg\n :target: https://pypi.python.org/pypi/zanshincli/\n.. |PyPI pyversions| image:: https://img.shields.io/pypi/pyversions/zanshincli.svg\n :target: https://pypi.python.org/pypi/zanshincli/\n",
"bugtrack_url": null,
"license": "Apache Software License",
"summary": "Python command line utility to the Tenchi Security Zanshin API v1",
"version": "1.5.1",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "ba75a90fc43c1615d6abccf2eb27b718",
"sha256": "586656897ba64c3803f434169641472489b267a5157b0e28e0292659a146b1a6"
},
"downloads": -1,
"filename": "zanshincli-1.5.1.tar.gz",
"has_sig": false,
"md5_digest": "ba75a90fc43c1615d6abccf2eb27b718",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 35787,
"upload_time": "2022-12-09T12:38:24",
"upload_time_iso_8601": "2022-12-09T12:38:24.985199Z",
"url": "https://files.pythonhosted.org/packages/2a/6b/534814a5844024f4857f8f3b1affc2e9401f8d0d7359cbd6d8e7c9ec5fa2/zanshincli-1.5.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-09 12:38:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "tenchi-security",
"github_project": "zanshin-cli",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [
{
"name": "pytest",
"specs": []
},
{
"name": "moto",
"specs": [
[
"~=",
"3.1.16"
]
]
}
],
"lcname": "zanshincli"
}
JSON
