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

Uploaded Python 3

File details

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

File metadata

  • Download URL: slips_sdk-0.1.4.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.4.tar.gz
Algorithm Hash digest
SHA256 ea47dee5dc55c20e1dfecfc46bb415a8fb6cb40500357168d8c28dac47c4d554
MD5 d0dadf2fb73d977a6a97591d6e372234
BLAKE2b-256 080beeaf2cde205ab2f70777876300b0fa8aa9d5c4583153e7d3d7749027e76b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: slips_sdk-0.1.4-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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 b52f8ce34b10881a33bd1a55f34c425df9f48cc4cd9e132d057b8ca62a997c1c
MD5 96ab2a46a28c84e28fc5c56c392eee6d
BLAKE2b-256 1825f544949587c5589cd29a2b613c876d189e176da3db920279b14e67eb2b60

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