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
 126 #
 127 # Bridge module
 128 #  This requires the mibII module.
 129 #
 130 #begemotSnmpdModulePath."bridge" = "/usr/lib/snmp_bridge.so"
 131
 132 #
 133 # Host resources module
 134 #  This requires the mibII module.
 135 #
 136 #begemotSnmpdModulePath."hostres" = "/usr/lib/snmp_hostres.so"
 137
 138 #
 139 # MIB-2 module
 140 #
 141 begemotSnmpdModulePath."mibII"  = "/usr/lib/snmp_mibII.so"
 142
 143 #
 144 # Netgraph module
 145 #
 146 #begemotSnmpdModulePath."netgraph" = "/usr/lib/snmp_netgraph.so"
 147
 148 #
 149 # pf(4) module
 150 #
 151 #begemotSnmpdModulePath."pf"    = "/usr/lib/snmp_pf.so"
 152
 153 #
 154 # SNMPv3 Notification Targets
 155 #
 156 # begemotSnmpdModulePath."target"       = "/usr/lib/snmp_target.so"
 157
 158 #
 159 # SNMPv3 User-based security module - must be loaded for SNMPv3 USM
 160 #
 161 #begemotSnmpdModulePath."usm"   = "/usr/lib/snmp_usm.so"
 162
 163 #
 164 # SNMPv3 View-based Access Control module
 165 #
 166 #begemotSnmpdModulePath."vacm"  = "/usr/lib/snmp_vacm.so"
 167
 168 #
 169 # Wireless module
 170 #  This requires the mibII module.
 171 #
 172 #begemotSnmpdModulePath."wlan" = "/usr/lib/snmp_wlan.so"
 173
 174 #
 175 # SNMPv3 USM User definition.
 176 #
 177
 178 #%usm
 179
 180 #
 181 # The following block creates a user with name "bsnmp" and sets privacy
 182 # and encryption options to SHA256 message digests and AES encryption
 183 # for this user.
 184 #
 185 # usmUserStatus.$(engine).$(user1) = 5
 186 # usmUserAuthProtocol.$(engine).$(user1) = $(HMACSHAAuthProtocol)
 187 # usmUserAuthKeyChange.$(engine).$(user1) = $(user1passwd)
 188 # usmUserPrivProtocol.$(engine).$(user1) = $(AesCfb128Protocol)
 189 # usmUserPrivKeyChange.$(engine).$(user1) = $(user1passwd)
 190 # usmUserStatus.$(engine).$(user1) = 1
 191 #
 192
 193 #
 194 # The following block creates a user with name "public" with no authentication
 195 # or encryption options.
 196 #
 197 # usmUserStatus.$(engine).$(read) = 5
 198 # usmUserAuthProtocol.$(engine).$(read) = $(NoAuthProtocol)
 199 # usmUserPrivProtocol.$(engine).$(read) = $(NoPrivProtocol)
 200 # usmUserStatus.$(engine).$(read) = 1
 201 #
 202
 203 #
 204 # Definition of view-based access control entries.
 205 #
 206 #%vacm
 207
 208 # Definition of a SNMPv1 group
 209 # vacmSecurityToGroupStatus.$(securityModelSNMPv1).$(read) = 4
 210 # vacmGroupName.$(securityModelSNMPv1).$(read) = $(read)
 211
 212 # Definition of SNMPv2 group
 213 # vacmSecurityToGroupStatus.$(securityModelSNMPv2c).$(write) = 4
 214 # vacmGroupName.$(securityModelSNMPv2c).$(write) = $(write)
 215
 216 # Definition of SNMPv3 group with users "bsnmp" and "public"
 217 # vacmSecurityToGroupStatus.$(securityModelUSM).$(user1) = 4
 218 # vacmGroupName.$(securityModelUSM).$(user1) = $(write)
 219 # vacmSecurityToGroupStatus.$(securityModelUSM).$(read) = 4
 220 # vacmGroupName.$(securityModelUSM).$(read) = $(write)
 221
 222 #
 223 # The OID of the .iso.org.dod.internet subtree
 224 #
 225 # internetoid := 1.3.6.1
 226 # internetoidlen := 4
 227
 228 #
 229 # Definitions of two views
 230 #
 231 # vacmViewTreeFamilyStatus."internet".$(internetoidlen).$(internetoid) = 4
 232 # vacmViewTreeFamilyStatus."restricted".$(internetoidlen).$(internetoid) = 4
 233
 234 #
 235 # Access control
 236 #
 237
 238 #
 239 # Read-only access for SNMPv1 users
 240 #
 241 # vacmAccessStatus.$(read)."".$(securityModelSNMPv1).$(noAuthNoPriv) = 4
 242 # vacmAccessReadViewName.$(read)."".$(securityModelSNMPv1).$(noAuthNoPriv) = "internet"
 243
 244 #
 245 # Read-write access for SNMPv2 users
 246 #
 247 # vacmAccessStatus.$(write)."".$(securityModelSNMPv2c).$(noAuthNoPriv) = 4
 248 # vacmAccessReadViewName.$(write)."".$(securityModelSNMPv2c).$(noAuthNoPriv) = "internet"
 249 # vacmAccessWriteViewName.$(write)."".$(securityModelSNMPv2c).$(noAuthNoPriv) = "internet"
 250
 251 #
 252 # Read-write-notify access for SNMPv3 USM users with noAuthNoPriv
 253 #
 254 # vacmAccessStatus.$(write)."".3.$(noAuthNoPriv) = 4
 255 # vacmAccessReadViewName.$(write)."".$(securityModelUSM).$(noAuthNoPriv) = "internet"
 256 # vacmAccessWriteViewName.$(write)."".$(securityModelUSM).$(noAuthNoPriv) = "internet"
 257 # vacmAccessNotifyViewName.$(write)."".$(securityModelUSM).$(noAuthNoPriv) = "internet"
 258
 259 #
 260 #Read-write-notify access to restricted for SNMPv3 USM users with authPriv
 261 #
 262 # vacmAccessStatus.$(write)."".$(securityModelUSM).$(authPriv) = 4
 263 # vacmAccessReadViewName.$(write)."".$(securityModelUSM).$(authPriv) = "restricted"
 264 # vacmAccessWriteViewName.$(write)."".$(securityModelUSM).$(authPriv) = "restricted"
 265 # vacmAccessNotifyViewName.$(write)."".$(securityModelUSM).$(authPriv) = "restricted"
 266
 267 #%target
 268 # Send notifications to target tag "test"
 269 # tag           := "test"
 270 # snmpNotifyRowStatus.$(tag) = 4
 271 # snmpNotifyTag.$(tag) = $(tag)
 272
 273 # tagremote             := "testremote"
 274 # snmpNotifyRowStatus.$(tagremote) = 4
 275 # snmpNotifyTag.$(tagremote) = $(tagremote)
 276
 277 #
 278 # Specify the target parameters for the notifications - send with the credentials
 279 # of user "bsnmp"
 280 #
 281 # snmpTargetParamsRowStatus.$(tag) = 5
 282 # snmpTargetParamsMPModel.$(tag) = $(MPmodelSNMPv3)
 283 # snmpTargetParamsSecurityModel.$(tag) = $(securityModelUSM)
 284 # snmpTargetParamsSecurityName.$(tag) = $(user1)
 285 # snmpTargetParamsSecurityLevel.$(tag) = $(authPriv)
 286 # snmpTargetParamsRowStatus.$(tag) = 1
 287
 288 #
 289 # Define the notifications' target address - port 162 on localhost
 290 #
 291 # snmpTargetAddrRowStatus.$(tag) = 5
 292 # snmpTargetAddrTAddress.$(tag) = 0x7f:0x0:0x0:0x1:0x0:0xa2
 293 # snmpTargetAddrTagList.$(tag) = "test notification"
 294 # snmpTargetAddrParams.$(tag) = $(tag)
 295 # snmpTargetAddrRowStatus.$(tag) = 1
 296
 297 #
 298 # Define the notifications' target address - port 162 on 10.0.0.1
 299 #
 300 # snmpTargetAddrRowStatus.$(tagremote) = 5
 301 # snmpTargetAddrTAddress.$(tagremote) = 0x0a:0x00:0x00:0x1:0x0:0xa2
 302 # snmpTargetAddrTagList.$(tagremote) = $(tagremote)
 303 # snmpTargetAddrParams.$(tagremote) = $(tag)
 304 # snmpTargetAddrRowStatus.$(tagremote) = 1
 305
 306 # Force a polling rate for the 64-bit interface counters in case
 307 # the automatic computation is wrong (which may be the case if an interface
 308 # announces the wrong bit rate via its MIB).
 309 #%mibII
 310 #begemotIfForcePoll = 2000
 311
 312 #%netgraph
 313 #begemotNgControlNodeName = "snmpd"