etc/snmpd.config

   1 # $FreeBSD$
   2 #
   3 # Example configuration file for bsnmpd(1).
   4 #
   5
   6 #
   7 # Set some common variables
   8 #
   9 location := "Room 200"
  10 contact := "sysmeister@example.com"
  11 system := 1     # FreeBSD
  12 traphost := localhost
  13 trapport := 162
  14
  15 #
  16 # Set the SNMP engine ID.
  17 #
  18 # The snmpEngineID object required from the SNMPv3 Framework. If not explicitly set via
  19 # this configuration file, an ID is assigned based on the value of the
  20 # kern.hostid variable
  21 # engine := 0x80:0x10:0x08:0x10:0x80:0x25
  22 # snmpEngineID = $(engine)
  23
  24 # Change this!
  25 read := "public"
  26 # Uncomment begemotSnmpdCommunityString.0.2 below that sets the community
  27 # string to enable write access.
  28 write := "geheim"
  29 trap := "mytrap"
  30
  31 #
  32 # Declarations for SNMP-USER-BASED-SM-MIB authentication and privacy options
  33 #
  34
  35 NoAuthProtocol          := 1.3.6.1.6.3.10.1.1.1
  36 HMACMD5AuthProtocol     := 1.3.6.1.6.3.10.1.1.2
  37 HMACSHAAuthProtocol     := 1.3.6.1.6.3.10.1.1.3
  38 NoPrivProtocol          := 1.3.6.1.6.3.10.1.2.1
  39 DESPrivProtocol         := 1.3.6.1.6.3.10.1.2.2
  40 AesCfb128Protocol       := 1.3.6.1.6.3.10.1.2.4
  41
  42 #
  43 # Enumerations from SNMP-FRAMEWORK-MIB
  44 #
  45
  46 # Security models
  47 securityModelAny        := 0
  48 securityModelSNMPv1     := 1
  49 securityModelSNMPv2c    := 2
  50 securityModelUSM        := 3
  51
  52 # Message Processing models
  53 MPmodelSNMPv1           := 0
  54 MPmodelSNMPv2c          := 1
  55 MPmodelSNMPv3           := 3
  56
  57 # Security levels
  58 noAuthNoPriv := 1
  59 authNoPriv := 2
  60 authPriv := 3
  61
  62
  63 # SNMPv3 USM User definition
  64 #
  65 # The localized hex password for a user may be obtained by setting SNMPUSER, SNMPPASSWD,
  66 # SNMPAUTH and SNMPPRIV environment variables to the desired parameters and invoking
  67 # 'bsnmpget -v 3 -D -K -o verbose' against the running bsnmpd(1). For other
  68 # usages refer to the bsnmpget(1) manual page. The following lines define a user "bsnmp"
  69 # with a private password "bsnmptest", localized for the above engine ID.
  70 #
  71 #user1 := "bsnmp"
  72 #user1passwd := 0x22:0x98:0x1a:0x6e:0x39:0x93:0x16:0x5e:0x6a:0x21:0x1b:0xd8:0xa9:0x81:0x31:0x05:0x16:0x33:0x38:0x60
  73
  74 #
  75 # Configuration
  76 #
  77 %snmpd
  78 begemotSnmpdDebugDumpPdus       = 2
  79 begemotSnmpdDebugSyslogPri      = 7
  80
  81 #
  82 # Set the read and write communities.
  83 #
  84 # The default value of the community strings is NULL (note, that this is
  85 # different from the empty string). This disables both read and write access.
  86 # To enable read access only the read community string must be set. Setting
  87 # the write community string enables both read and write access with that
  88 # string.
  89 #
  90 # Be sure to understand the security implications of SNMPv2 - the community
  91 # strings are readable on the wire!
  92 #
  93 begemotSnmpdCommunityString.0.1 = $(read)
  94 # begemotSnmpdCommunityString.0.2       = $(write)
  95 begemotSnmpdCommunityDisable    = 1
  96
  97 # open standard SNMP ports
  98 begemotSnmpdPortStatus.0.0.0.0.161 = 1
  99
 100 # open a unix domain socket
 101 begemotSnmpdLocalPortStatus."/var/run/snmpd.sock" = 1
 102 begemotSnmpdLocalPortType."/var/run/snmpd.sock" = 4
 103
 104 # send traps to the traphost
 105 begemotTrapSinkStatus.[$(traphost)].$(trapport) = 4
 106 begemotTrapSinkVersion.[$(traphost)].$(trapport) = 2
 107 begemotTrapSinkComm.[$(traphost)].$(trapport) = $(trap)
 108
 109 sysContact      = $(contact)
 110 sysLocation     = $(location)
 111 sysObjectId     = 1.3.6.1.4.1.12325.1.1.2.1.$(system)
 112
 113 snmpEnableAuthenTraps = 2
 114
 115 # Uncomment `begemotSnmpdModulePath.".." = ".."' entries below to enable
 116 # modules
 117
 118 #
 119 # Control configuration for the modules in the module specific sections, e.g.
 120 # the "usm" module (begemotSnmpdModulePath."usm") can be controlled in the
 121 # %usm specific section. You must uncomment the section specific header in
 122 # order to use the enclosed variables, e.g. `usmUserStatus.$(engine).$(user1)`
 123 # can only be used if %usm is uncommented.
 124 #
 125 # Modules are loaded in the order listed, so they must be before any
 126 # dependent modules, e.g. "mibII" vs "bridge".
 127 #
 128
 129 #
 130 # MIB-2 module
 131 #
 132 begemotSnmpdModulePath."mibII"  = "/usr/lib/snmp_mibII.so"
 133
 134 #
 135 # Bridge module
 136 #  This requires the mibII module.
 137 #
 138 #begemotSnmpdModulePath."bridge" = "/usr/lib/snmp_bridge.so"
 139
 140 #
 141 # Host resources module
 142 #  This requires the mibII module.
 143 #
 144 #begemotSnmpdModulePath."hostres" = "/usr/lib/snmp_hostres.so"
 145
 146 #
 147 # Netgraph module
 148 #
 149 #begemotSnmpdModulePath."netgraph" = "/usr/lib/snmp_netgraph.so"
 150
 151 #
 152 # pf(4) module
 153 #
 154 #begemotSnmpdModulePath."pf"    = "/usr/lib/snmp_pf.so"
 155
 156 #
 157 # SNMPv3 Notification Targets
 158 #
 159 # begemotSnmpdModulePath."target"       = "/usr/lib/snmp_target.so"
 160
 161 #
 162 # SNMPv3 User-based security module - must be loaded for SNMPv3 USM
 163 #
 164 #begemotSnmpdModulePath."usm"   = "/usr/lib/snmp_usm.so"
 165
 166 #
 167 # SNMPv3 View-based Access Control module
 168 #
 169 #begemotSnmpdModulePath."vacm"  = "/usr/lib/snmp_vacm.so"
 170
 171 #
 172 # Wireless module
 173 #  This requires the mibII module.
 174 #
 175 #begemotSnmpdModulePath."wlan" = "/usr/lib/snmp_wlan.so"
 176
 177 #
 178 # SNMPv3 USM User definition.
 179 #
 180
 181 #%usm
 182
 183 #
 184 # The following block creates a user with name "bsnmp" and sets privacy
 185 # and encryption options to SHA256 message digests and AES encryption
 186 # for this user.
 187 #
 188 # usmUserStatus.$(engine).$(user1) = 5
 189 # usmUserAuthProtocol.$(engine).$(user1) = $(HMACSHAAuthProtocol)
 190 # usmUserAuthKeyChange.$(engine).$(user1) = $(user1passwd)
 191 # usmUserPrivProtocol.$(engine).$(user1) = $(AesCfb128Protocol)
 192 # usmUserPrivKeyChange.$(engine).$(user1) = $(user1passwd)
 193 # usmUserStatus.$(engine).$(user1) = 1
 194 #
 195
 196 #
 197 # The following block creates a user with name "public" with no authentication
 198 # or encryption options.
 199 #
 200 # usmUserStatus.$(engine).$(read) = 5
 201 # usmUserAuthProtocol.$(engine).$(read) = $(NoAuthProtocol)
 202 # usmUserPrivProtocol.$(engine).$(read) = $(NoPrivProtocol)
 203 # usmUserStatus.$(engine).$(read) = 1
 204 #
 205
 206 #
 207 # Definition of view-based access control entries.
 208 #
 209 #%vacm
 210
 211 # Definition of a SNMPv1 group
 212 # vacmSecurityToGroupStatus.$(securityModelSNMPv1).$(read) = 4
 213 # vacmGroupName.$(securityModelSNMPv1).$(read) = $(read)
 214
 215 # Definition of SNMPv2 group
 216 # vacmSecurityToGroupStatus.$(securityModelSNMPv2c).$(write) = 4
 217 # vacmGroupName.$(securityModelSNMPv2c).$(write) = $(write)
 218
 219 # Definition of SNMPv3 group with users "bsnmp" and "public"
 220 # vacmSecurityToGroupStatus.$(securityModelUSM).$(user1) = 4
 221 # vacmGroupName.$(securityModelUSM).$(user1) = $(write)
 222 # vacmSecurityToGroupStatus.$(securityModelUSM).$(read) = 4
 223 # vacmGroupName.$(securityModelUSM).$(read) = $(write)
 224
 225 #
 226 # The OID of the .iso.org.dod.internet subtree
 227 #
 228 # internetoid := 1.3.6.1
 229 # internetoidlen := 4
 230
 231 #
 232 # Definitions of two views
 233 #
 234 # vacmViewTreeFamilyStatus."internet".$(internetoidlen).$(internetoid) = 4
 235 # vacmViewTreeFamilyStatus."restricted".$(internetoidlen).$(internetoid) = 4
 236
 237 #
 238 # Access control
 239 #
 240
 241 #
 242 # Read-only access for SNMPv1 users
 243 #
 244 # vacmAccessStatus.$(read)."".$(securityModelSNMPv1).$(noAuthNoPriv) = 4
 245 # vacmAccessReadViewName.$(read)."".$(securityModelSNMPv1).$(noAuthNoPriv) = "internet"
 246
 247 #
 248 # Read-write access for SNMPv2 users
 249 #
 250 # vacmAccessStatus.$(write)."".$(securityModelSNMPv2c).$(noAuthNoPriv) = 4
 251 # vacmAccessReadViewName.$(write)."".$(securityModelSNMPv2c).$(noAuthNoPriv) = "internet"
 252 # vacmAccessWriteViewName.$(write)."".$(securityModelSNMPv2c).$(noAuthNoPriv) = "internet"
 253
 254 #
 255 # Read-write-notify access for SNMPv3 USM users with noAuthNoPriv
 256 #
 257 # vacmAccessStatus.$(write)."".3.$(noAuthNoPriv) = 4
 258 # vacmAccessReadViewName.$(write)."".$(securityModelUSM).$(noAuthNoPriv) = "internet"
 259 # vacmAccessWriteViewName.$(write)."".$(securityModelUSM).$(noAuthNoPriv) = "internet"
 260 # vacmAccessNotifyViewName.$(write)."".$(securityModelUSM).$(noAuthNoPriv) = "internet"
 261
 262 #
 263 #Read-write-notify access to restricted for SNMPv3 USM users with authPriv
 264 #
 265 # vacmAccessStatus.$(write)."".$(securityModelUSM).$(authPriv) = 4
 266 # vacmAccessReadViewName.$(write)."".$(securityModelUSM).$(authPriv) = "restricted"
 267 # vacmAccessWriteViewName.$(write)."".$(securityModelUSM).$(authPriv) = "restricted"
 268 # vacmAccessNotifyViewName.$(write)."".$(securityModelUSM).$(authPriv) = "restricted"
 269
 270 #%target
 271 # Send notifications to target tag "test"
 272 # tag           := "test"
 273 # snmpNotifyRowStatus.$(tag) = 4
 274 # snmpNotifyTag.$(tag) = $(tag)
 275
 276 # tagremote             := "testremote"
 277 # snmpNotifyRowStatus.$(tagremote) = 4
 278 # snmpNotifyTag.$(tagremote) = $(tagremote)
 279
 280 #
 281 # Specify the target parameters for the notifications - send with the credentials
 282 # of user "bsnmp"
 283 #
 284 # snmpTargetParamsRowStatus.$(tag) = 5
 285 # snmpTargetParamsMPModel.$(tag) = $(MPmodelSNMPv3)
 286 # snmpTargetParamsSecurityModel.$(tag) = $(securityModelUSM)
 287 # snmpTargetParamsSecurityName.$(tag) = $(user1)
 288 # snmpTargetParamsSecurityLevel.$(tag) = $(authPriv)
 289 # snmpTargetParamsRowStatus.$(tag) = 1
 290
 291 #
 292 # Define the notifications' target address - port 162 on localhost
 293 #
 294 # snmpTargetAddrRowStatus.$(tag) = 5
 295 # snmpTargetAddrTAddress.$(tag) = 0x7f:0x0:0x0:0x1:0x0:0xa2
 296 # snmpTargetAddrTagList.$(tag) = "test notification"
 297 # snmpTargetAddrParams.$(tag) = $(tag)
 298 # snmpTargetAddrRowStatus.$(tag) = 1
 299
 300 #
 301 # Define the notifications' target address - port 162 on 10.0.0.1
 302 #
 303 # snmpTargetAddrRowStatus.$(tagremote) = 5
 304 # snmpTargetAddrTAddress.$(tagremote) = 0x0a:0x00:0x00:0x1:0x0:0xa2
 305 # snmpTargetAddrTagList.$(tagremote) = $(tagremote)
 306 # snmpTargetAddrParams.$(tagremote) = $(tag)
 307 # snmpTargetAddrRowStatus.$(tagremote) = 1
 308
 309 # Force a polling rate for the 64-bit interface counters in case
 310 # the automatic computation is wrong (which may be the case if an interface
 311 # announces the wrong bit rate via its MIB).
 312 #%mibII
 313 #begemotIfForcePoll = 2000
 314
 315 #%netgraph
 316 #begemotNgControlNodeName = "snmpd"