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

Uploaded Python 3

File details

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

File metadata

  • Download URL: slips_sdk-0.1.12.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.12.tar.gz
Algorithm Hash digest
SHA256 77db9473157913c30710c7a0aaf3cee5f92e17f092238618e2673acf8da303f2
MD5 410e06adaa3e1d68681c3e0165a09c5f
BLAKE2b-256 ce777bf04b3e557553a00b6c56e73dd43b32ab5582db32deb0fb50fe3fa7ab70

See more details on using hashes here.

File details

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

File metadata

  • Download URL: slips_sdk-0.1.12-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.12-py3-none-any.whl
Algorithm Hash digest
SHA256 0ea3d912f982bc8c57cac4869c6fa54d37f07810f642659f2a250fbdc4aed08c
MD5 b75c2fa3274d3c7644fe1b3b8a68078f
BLAKE2b-256 3ae9c6117ac234d1ea1309c833e2926c3799ef4ab7ba3d3e45befcf181b96876

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