Skip to content

Feature/integrations pt3 connectors#195

Open
PaperMtn wants to merge 49 commits intogoogle:mainfrom
PaperMtn:feature/integrations-pt3-connectors
Open

Feature/integrations pt3 connectors#195
PaperMtn wants to merge 49 commits intogoogle:mainfrom
PaperMtn:feature/integrations-pt3-connectors

Conversation

@PaperMtn
Copy link
Contributor

@PaperMtn PaperMtn commented Mar 10, 2026

Implement All Integration Management Functions - Pt 3: Connectors

Summary

This PR Adds Integration Connectors capabilities to the SecOps SDK. It includes:

  • SDK modules
  • ChronicleClient methods
  • CLI commands
  • Unit tests
  • Full documentation.

New SDK Modules (src/secops/chronicle/integration/)

Module Description
connectors.py CRUD, test execution, and template fetching for integration connectors
connector_revisions.py List, create, delete, and rollback connector revisions
connector_context_properties.py CRUD and bulk-delete for connector context properties
connector_instances.py CRUD, on-demand execution, latest definition fetch, and log collection management for connector instances
connector_instance_logs.py List and get connector instance logs

CLI Commands (src/secops/cli/commands/integration/)

Added a complete secops integration CLI command tree with 21 subcommand modules, all registered via integration_client.py:

CLI Subcommand Operations
secops integration connectors list, get, create, update, delete, test, template
secops integration connector-revisions list, create, delete, rollback
secops integration connector-context-properties list, get, create, update, delete, delete-all
secops integration connector-instance-logs list, get
secops integration connector-instances list, get, create, update, delete, run-on-demand, get-latest-definition, set-logs-collection

Tests

Unit Tests - SDK Modules (tests/chronicle/integration/)

  • test_connectors.py, test_connector_revisions.py
  • test_connector_context_properties.py, test_connector_instance_logs.py, test_connector_instances.py

Documentation Updates

README.md

SDK usage examples for every new module, following the established format:

  • Connectors (CRUD, test, template)
  • Connector Revisions, Context Properties, Instance Logs, Instances

CLI.md

CLI usage documentation with bash examples for all integration subcommands, including workflow examples for revision-based safe updates.


ChronicleClient Updates

  • client.py - All new integration module functions added as ChronicleClient methods with full docstrings
  • __init__.py - All new functions exported in __all__ and publicly importable from secops.chronicle

API Version Support

All integration modules support both v1beta (default) and v1alpha via the api_version parameter

@PaperMtn PaperMtn requested a review from mihirvala08 as a code owner March 10, 2026 15:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant