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.11.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.11-py3-none-any.whl (52.1 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: slips_sdk-0.1.11.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.11.tar.gz
Algorithm Hash digest
SHA256 0f108e4f10610c69d70a214854d9f6c19d952e602225f9f4850499679e257f3b
MD5 87256cfb87a0260cf7f48db3fce05b0d
BLAKE2b-256 bff6c409ce3a5aee56630afa8e3f8e2347dc5c2354680361577cfaf5b9a32b31

See more details on using hashes here.

File details

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

File metadata

  • Download URL: slips_sdk-0.1.11-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.11-py3-none-any.whl
Algorithm Hash digest
SHA256 95f682a2363b921811a560d4b252c7796905a6ac983e1e810917709d9ed0b490
MD5 aade2db6d50d0f49347889065fde6918
BLAKE2b-256 041497ad7e72f654d20ca2c807a8f7bdd9041b14610319c1bc99b07ef70761ff

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