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