Skip to main content

SDK for interacting with slips IDS components

Project description

slips-sdk

PyPI version Python Version License

Description: SDK for interacting with slips IDS components
Python Requires: >=3.10
Operating System: Ubuntu 22.04


Installation

Install the SDK via pip:

sudo pip install slips-sdk
sudo slips-setup

Quick Start

from slips.slips_manager import SlipsManager

# Initialize the SLIPS manager
slips = SlipsManager()

# Get SLIPS version
print(slips.get_version())

# Start SLIPS with a pcap file and verbose output
slips.start(file="test.pcap", verbose=1, debug=1, output_dir="~/output")

Usage

SlipsManager

Manages the SLIPS binary via subprocess calls.

Key Methods:

  • start(file=None, interface=None, output_dir=None, verbose=0, debug=0, blocking=False, daemon=False, save=False, growing=False, pcap_filter=None)
    Start SLIPS with various options.

  • stop_daemon()
    Stop SLIPS daemon.

  • kill_all_redis()
    Kill all unused Redis servers started by SLIPS.

  • get_version()
    Returns the SLIPS version string.

  • clear_cache()
    Clear SLIPS cache database.

Example:

from slips.slips_manager import SlipsManager

slips = SlipsManager()
print(slips.get_version())
slips.start(file="capture.pcap", verbose=2)

Configuration Management Classes

Located in slips.config module, these classes manage SLIPS configuration files and credentials.

  • IDSConfig
  • IrisConfig
  • WardenConfig
  • WhitelistConfig
  • VTAPIKeyManager
  • SlackBotTokenManager
  • TIFeedManager
  • SSLFeedManager
  • RiskIQCredentialsManager
  • JA3FeedManager
  • LogstashConfigManager
  • RedisConfManager

Example:

from slips.config import IDSConfig, VTAPIKeyManager

ids_config = IDSConfig()
print(ids_config.get_verbose())
ids_config.set_verbose(3)

vt_manager = VTAPIKeyManager()
vt_manager.set_key("your_api_key")
print(vt_manager.get_key())

ZeekScriptManager

Manages Zeek script files.

Example:

from slips.zeek_script_manager import ZeekScriptManager

manager = ZeekScriptManager()
print(manager.list_scripts())
manager.upload_script("/path/to/script.zeek")
content = manager.read_script("script.zeek")
print(content)

DatasetManager

Manages datasets in a structured folder.

Example:

from slips.dataset_manager import DatasetManager

dataset_mgr = DatasetManager()
print(dataset_mgr.list_items())
dataset_mgr.upload("/path/to/data.pcap")
metadata = dataset_mgr.get_metadata("data.pcap")
print(metadata)

Documentation

For detailed API documentation, please refer to the source code in the slips/ directory or the official documentation website (if available).


License

slips‑sdk is licensed under the GNU Affero General Public License v3.0.
See the LICENSE file for details.

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

slips_sdk-0.1.3.tar.gz (51.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

slips_sdk-0.1.3-py3-none-any.whl (52.1 MB view details)

Uploaded Python 3

File details

Details for the file slips_sdk-0.1.3.tar.gz.

File metadata

  • Download URL: slips_sdk-0.1.3.tar.gz
  • Upload date:
  • Size: 51.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.12

File hashes

Hashes for slips_sdk-0.1.3.tar.gz
Algorithm Hash digest
SHA256 dbbefe74f40c594b97ce0d4c6934e704e2d4e501e40d57ee399ef39da4b9de3b
MD5 779bfdc395ed06011dd710e9382bf096
BLAKE2b-256 d6cde42f92c50a7cb0237f4ad0c11777ca833672ae0168e5b06a1e1342c801d8

See more details on using hashes here.

File details

Details for the file slips_sdk-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: slips_sdk-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 52.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.12

File hashes

Hashes for slips_sdk-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 1c2210cd42278aa636c76e3d25edf6160f6cbbf607bd2a0fc13cdbbf1288e484
MD5 f34e88f49e95a8be3bce7b2034d1fbb7
BLAKE2b-256 b9294bb39b458990f0813e16ce876b33fe1cb524f14c6605e51382ccd6240526

See more details on using hashes here.

Supported by

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