Ansible Collection - sva.sentinelone

Description

This is the unofficial SentinelOne Collection provided by SVA

This collection is a community project and is neither provided nor supported by SentinelOne itself.

It provides several modules which helps to configure and manage SentinelOne Management Consoles.

Included content

• Modules:

  • sentinelone_config_overrides
  • sentinelone_download_agent
  • sentinelone_filters
  • sentinelone_groups
  • sentinelone_sites
  • sentinelone_upgrade_policies
  • sentinelone_path_exclusions
  • sentinelone_policies

• Roles:

  • install_agent

Requirements

Ansible

• ansible >= 7 or ansible-core >= 2.14 (Lower versions may work but they have not been tested)

Python

• Python >= 3.9 (Ansible control node requirement)

External

This collection needs the following Python modules:

• deepdiff >= 5.6.0 (Lower versions may work but they have not been tested)

Tested with Ansible and the following Python versions

Tested Ansible versions:

• 2.14
• 2.15
• 2.16

Tested Python versions:

• 3.9
• 3.10
• 3.11

Using this collection

Installing the collection from Ansible Galaxy

Before using this collection, you need to install it with the Ansible Galaxy command-line tool:

ansible-galaxy collection install sva.sentinelone

You can also include it in a requirements.yml file and install it with ansible-galaxy collection install -r requirements.yml, using the format:

---
collections:
  - name: sva.sentinelone

Note that if you install the collection from Ansible Galaxy, it will not be upgraded automatically when you upgrade the ansible package. To upgrade the collection to the latest available version, run the following command:

ansible-galaxy collection install sva.sentinelone --upgrade

You can also install a specific version of the collection, for example, if you need to downgrade when something is broken in the latest version (please report an issue in this repository). Use the following syntax to install version 1.0.0:

ansible-galaxy collection install sva.sentinelone:==1.0.0

See Ansible Using collections for more details.

Documentation

User documentation

The module documentation can be found here.

Changelog

v1.1.1: Bugfix release. Changed privilege escalation behaviour

v1.1.0: Added new sentinelone_download_agent module and install_agent role

v1.0.3: Increased request timeout and implemented error handling for requests that timed out

v1.0.2: Added detailed error message to module output if an API call fails

v1.0.1: Bugfix release

v1.0.0: Initial release

Detailed Changelog can be found at CHANGELOG

Todo (help is welcome)

• Make the modules usable on account scope
• Unit tests needs to be written

Licensing

The SVA SentinelOne collection is licensed under the GNU General Public License v3.0+. See LICENSE for the full license text.