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

Uploaded Python 3

File details

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

File metadata

  • Download URL: slips_sdk-0.1.7.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.7.tar.gz
Algorithm Hash digest
SHA256 1976fda3fd56e9f06deee6254a14fa71267682926fa126fab71145e682b0fade
MD5 2aee8fb17d1c6276714a7c94b295ae78
BLAKE2b-256 c9030c165c1cd4a79cf65206c392cabb12be058d0fe144669e23911244dd8442

See more details on using hashes here.

File details

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

File metadata

  • Download URL: slips_sdk-0.1.7-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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 a7e5c40224638c178fb50006bd1dad271e7accb19d38d608fb2b2e203ec14c78
MD5 c4c6cc8cac30756916d79c135496c2f9
BLAKE2b-256 65aed1275363282a216b1364a5b19347212e679b0a40abe5fc0145d2d390fba8

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