feat: add SNMP provider for receiving and processing SNMP traps (#2112)

[MAVRICK-1]

Closes #2112

📑 Description

This PR adds a new SNMP provider that enables Keep to receive and process SNMP traps from network devices, converting them into actionable Keep alerts.

Key Features Implemented:

• Support for SNMPv1, SNMPv2c, and SNMPv3 protocols
• Authentication and encryption for SNMPv3 (MD5/SHA auth, DES/AES privacy)
• Automatic severity mapping for standard SNMP traps
• Configurable listening address and port
• Rich alert context with system information and trap variables
• Comprehensive error handling and validation
• Added pysnmp-lextudio dependency for SNMP protocol support
• Complete documentation with usage examples

The provider automatically maps standard SNMP traps (coldStart, warmStart, linkDown, linkUp, authenticationFailure, etc.) to appropriate alert severities
and extracts meaningful information like system name, uptime, and interface details.

✅ Checks

• My pull request adheres to the code style of this project
• My code requires changes to the documentation
• I have updated the documentation as required
• All the tests have passed

ℹ Additional Information

Dependencies Added:

• pysnmp-lextudio = "^6.3.0" - Modern SNMP library for Python with asyncio support

Configuration Example:

# Basic SNMPv1/v2c setup
authentication:
  listen_address: "0.0.0.0"
  listen_port: 162
  community_string: "public"

# Advanced SNMPv3 setup
authentication:
  listen_address: "0.0.0.0"
  listen_port: 162
  community_string: "public"
  security_name: "snmpuser"
  auth_protocol: "SHA"
  auth_key: "authpassword123"
  priv_protocol: "AES"
  priv_key: "privpassword123"

Testing:

The provider has been tested with various SNMP trap types and includes comprehensive error handling for production use. Test scripts are provided in the
codebase for validation.

Breaking Changes:

None - this is a new provider addition that doesn't affect existing functionality.

Files Added:

• keep/providers/snmp_provider/snmp_provider.py - Main provider implementation
• keep/providers/snmp_provider/init.py - Package initialization
• keep/providers/snmp_provider/README.md - Comprehensive documentation

/claim #2112

[vercel]

@MAVRICK-1 is attempting to deploy a commit to the KeepHQ Team on Vercel.

A member of the Team first needs to authorize it.

[CLAassistant]

All committers have signed the CLA.

[cursor]

Bug: SNMPv3 Protocol Validation and Key Handling

The SNMP provider has two validation issues:

1. SNMPv3 auth_protocol and priv_protocol validation is case-sensitive, but the underlying setup code is case-insensitive, causing valid lowercase inputs to be rejected.
2. It fails to validate that priv_key is provided when priv_protocol is configured for SNMPv3, which can lead to runtime errors during engine setup.

keep/providers/snmp_provider/snmp_provider.py#L194-L203

keep/keep/providers/snmp_provider/snmp_provider.py

Lines 194 to 203 in 892f83d

	# Validate SNMPv3 configuration if provided
	if self.authentication_config.security_name:
	if not self.authentication_config.auth_protocol:
	raise ValueError("SNMPv3 security name provided but auth protocol is missing")
	if not self.authentication_config.auth_key:
	raise ValueError("SNMPv3 security name provided but auth key is missing")
	if self.authentication_config.auth_protocol not in ["MD5", "SHA"]:
	raise ValueError(f"Invalid auth protocol: {self.authentication_config.auth_protocol}. Must be MD5 or SHA")
	if self.authentication_config.priv_protocol and self.authentication_config.priv_protocol not in ["DES", "AES"]:
	raise ValueError(f"Invalid privacy protocol: {self.authentication_config.priv_protocol}. Must be DES or AES")

Fix in Cursor • Fix in Web

---

Was this report helpful? Give feedback by reacting with 👍 or 👎

[shahargl]

hey! thanks for opening this PR.

have you tested it? can you share a video of this working?

[MAVRICK-1]

Screencast.from.2025-07-23.18-20-20.mp4

@shahargl

[shahargl]

@MAVRICK-1 closing as its not ready to merge. you can see other PR's about new providers to understand whats need to be done.