diff --git a/changelogs/fragments/t9416_vyos_snmp_server_fixes.yml b/changelogs/fragments/t9416_vyos_snmp_server_fixes.yml
new file mode 100644
index 00000000..668f8d27
--- /dev/null
+++ b/changelogs/fragments/t9416_vyos_snmp_server_fixes.yml
@@ -0,0 +1,22 @@
+---
+bugfixes:
+ - vyos_snmp_server - a trap target's community and port are rendered, as separate commands;
+ before, they were silently dropped (T9415).
+ - vyos_snmp_server - SNMPv3 trap-target port, protocol, type and user render with the trap
+ target's address; before, they rendered an invalid "service snmp v3 trap-target port X" (T9416).
+ - vyos_snmp_server - SNMPv3 trap-target authentication and privacy are rendered; before, they
+ were silently dropped.
+ - vyos_snmp_server - SNMPv3 trap-target port, protocol, type and user are read back as their
+ values; before, a device with an SNMPv3 trap-target port made the module fail.
+minor_changes:
+ - vyos_snmp_server - new option snmp_v3.trap_targets.user.
+ - vyos_snmp_server - new option trap_targets, a list of SNMPv2c trap targets (address, community,
+ port); VyOS allows more than one, trap_target only allowed one (T9436).
+deprecated_features:
+ - vyos_snmp_server - the trap_target option is deprecated since 7.0.0 in favour of trap_targets,
+ and will be removed in version 8.0.0. It keeps working throughout 7.x, as a list of one trap
+ target, and is mutually exclusive with trap_targets.
+breaking_changes:
+ - vyos_snmp_server - the module's output (gathered, parsed, before and after) reports SNMPv2c trap
+ targets as the list trap_targets instead of the single trap_target, so that more than one trap
+ target on the device can be represented.
diff --git a/docs/vyos.vyos.vyos_snmp_server_module.rst b/docs/vyos.vyos.vyos_snmp_server_module.rst
index 1fe0b10c..a8176517 100644
--- a/docs/vyos.vyos.vyos_snmp_server_module.rst
+++ b/docs/vyos.vyos.vyos_snmp_server_module.rst
@@ -1,2043 +1,2135 @@
.. _vyos.vyos.vyos_snmp_server_module:
**************************
vyos.vyos.vyos_snmp_server
**************************
**Manages snmp_server resource module**
Version added: 1.0.0
.. contents::
:local:
:depth: 1
Synopsis
--------
- This module manages the snmp server attributes of Vyos network devices
Parameters
----------
.. raw:: html
| Parameter |
Choices/Defaults |
Comments |
|
config
dictionary
|
|
SNMP server configuration.
|
|
communities
list
/ elements=dictionary
|
|
Community name configuration.
|
|
|
authorization_type
string
|
|
Authorization type (rw or ro)
|
|
|
clients
list
/ elements=string
|
|
IP address of SNMP client allowed to contact system
|
|
|
name
string
|
|
Community name
|
|
|
networks
list
/ elements=string
|
|
Subnet of SNMP client(s) allowed to contact system
|
|
contact
string
|
|
Person to contact about the system.
|
|
description
string
|
|
Description information
|
|
listen_addresses
list
/ elements=dictionary
|
|
IP address to listen for incoming SNMP requests
|
|
|
address
string
|
|
IP address to listen for incoming SNMP requests.
|
|
|
port
integer
|
|
Port for SNMP service
|
|
location
string
|
|
Location information
|
|
smux_peer
string
|
|
Register a subtree for SMUX-based processing.
|
|
snmp_v3
dictionary
|
|
Simple Network Management Protocol (SNMP) v3
|
|
|
engine_id
string
|
|
Specifies the EngineID as a hex value
|
|
|
groups
list
/ elements=dictionary
|
|
Specifies the group with name groupname
|
|
|
|
group
string
|
|
Specifies the group with name groupname
|
|
|
|
mode
string
|
|
Defines the read/write access
|
|
|
|
seclevel
string
|
|
Defines security level
|
|
|
|
view
string
|
|
Defines the name of view
|
|
|
trap_targets
list
/ elements=dictionary
|
|
Defines SNMP target for inform or traps for IP
|
|
|
|
address
string
|
|
IP/IPv6 address of trap target
|
|
|
|
authentication
dictionary
|
|
Defines the authentication
|
|
|
|
|
encrypted_key
string
|
|
Defines the encrypted password for authentication
|
|
|
|
|
plaintext_key
string
|
|
Defines the clear text password for authentication
|
|
|
|
|
type
string
|
|
Defines the protocol using for authentication
|
|
|
|
port
integer
|
|
Specifies the TCP/UDP port of a destination for SNMP traps/informs.
|
|
|
|
privacy
dictionary
|
|
Defines the privacy
|
|
|
|
|
encrypted_key
string
|
|
Defines the encrypted password for privacy
|
|
|
|
|
plaintext_key
string
|
|
Defines the clear text password for privacy
|
|
|
|
|
type
string
|
|
Defines the protocol using for privacy
|
|
|
|
protocol
string
|
|
Defines protocol for notification between TCP and UDP
|
|
|
|
type
string
|
|
Specifies the type of notification between inform and trap
|
+
+ |
+ |
+ |
+
+
+ user
+
+
+ string
+
+ |
+
+ |
+
+ Defines the username of the SNMPv3 user for this trap target.
+ |
+
|
|
users
list
/ elements=dictionary
|
|
Defines username for authentication
|
|
|
|
authentication
dictionary
|
|
Defines the authentication
|
|
|
|
|
encrypted_key
string
|
|
Defines the encrypted password for authentication
|
|
|
|
|
plaintext_key
string
|
|
Defines the clear text password for authentication
|
|
|
|
|
type
string
|
|
Defines the protocol using for authentication
|
|
|
|
group
string
|
|
Specifies group for user name
|
|
|
|
mode
string
|
|
Specifies the mode for access rights of user, read only or write
|
|
|
|
privacy
dictionary
|
|
Defines the privacy
|
|
|
|
|
encrypted_key
string
|
|
Defines the encrypted password for privacy
|
|
|
|
|
plaintext_key
string
|
|
Defines the clear text password for privacy
|
|
|
|
|
type
string
|
|
Defines the protocol using for privacy
|
|
|
|
tsm_key
string
|
|
Specifies finger print or file name of TSM certificate.
|
|
|
|
user
string
|
|
Specifies the user with name username
|
|
|
views
list
/ elements=dictionary
|
|
Specifies the view with name viewname
|
|
|
|
exclude
string
|
|
Exclude is optional argument.
|
|
|
|
mask
string
|
|
Defines a bit-mask that is indicating which subidentifiers of the associated subtree OID should be regarded as significant.
|
|
|
|
oid
string
|
|
Specify oid
|
|
|
|
view
string
|
|
view name
|
|
trap_source
string
|
|
SNMP trap source address
|
|
trap_target
dictionary
|
|
+
+ One SNMPv2c trap target.
+ Deprecated since 7.0.0, use trap_targets, which allows more than one trap target. This option will be removed in version 8.0.0. Mutually exclusive with trap_targets.
+ |
+
+
+ |
+ |
+
+
+ address
+
+
+ string
+
+ |
+
+ |
Address of trap target
|
+
+
+ |
+ |
+
+
+ community
+
+
+ string
+
+ |
+
+ |
+
+ Community used when sending trap information
+ |
+
+
+ |
+ |
+
+
+ port
+
+
+ integer
+
+ |
+
+ |
+
+ Destination port used for trap notification
+ |
+
+
+
+ |
+
+
+ trap_targets
+
+
+ list
+ / elements=dictionary
+
+ |
+
+ |
+
+ SNMPv2c trap targets.
+ Mutually exclusive with trap_target.
+ |
|
|
address
string
+ / required
|
|
Address of trap target
|
|
|
community
string
|
|
Community used when sending trap information
|
|
|
port
integer
|
|
Destination port used for trap notification
|
|
running_config
string
|
|
The state the configuration should be left in.
The states replaced and overridden have identical behaviour for this module.
Please refer to examples for more details.
|
|
state
string
|
Choices:
merged ←
- replaced
- overridden
- deleted
- gathered
- parsed
- rendered
|
The state the configuration should be left in
|