Adding SNMP traps to SNMP devices or entities - Industrial IoT 5.0.2.0 | BACnet | Modbus | OPC Client | SNMP Manager

Industrial IoT Plugin Guide 5.0.2.0

Applies to
Industrial IoT 5.0.2.0 | BACnet | Modbus | OPC Client | SNMP Manager
Last updated
2023-03-20
Content type
Guides > Plugin and extension guides
Language
English
Product
Industrial IoT
Version
5.0

To have Security Center events or alarms triggered by SNMP traps on a device, you must add SNMP traps to SNMP devices and device types.

Before you begin

What you should know

To add all the traps related to an SNMP device, import the Management Information Base (MIB) files provided by the SNMP device manufacturer. MIB files are organized in a hierarchy. All elements of this hierarchy must be present for the import to succeed.
There are four MIB files that are included in your plugin installation:
  • IF-MIB.mib
  • SNMP-FRAMEWORK-MIB.mib
  • SNMPv2-MIB.mib
  • SNMPv2-SMI.mib
They are found in the folder C:\Program Files (x86)\Security Center Plugins\IndustrialIoT\Protocols\Snmp\Mib\Snmp.BaseMibFiles. You do not need to include them explicitly. They are implicitly included. However, your device might require other base MIB files that are not provided with the device. You can typically find these base MIB files on the manufacturer's web site.
IMPORTANT: Beware of the following:
  • The only type of traps that the plugin supports is NOTIFICATION_TYPE.
  • Only MIB files for SNMPv2 and SNMPv3 are accepted. MIB files for SNMPv1 would not work.

Procedure

To add SNMP traps to SNMP devices or entities:

  1. From the Config Tool home page, open the Plugins task.
  2. Select an SNMP device from the entity browser and click the Properties tab.
  3. In the Events section, click Import SNMP traps from MIB files.
  4. In the dialog box that opens, click and select the MIB files that you want to import.
    Ensure the following:
    • At least one of the MIB files contains a NOTIFICATION_TYPE.
    • All dependent MIB files published by the manufacturer are included.
    NOTE: The Import button remains disabled if no object identifier (OID) of NOTIFICATION_TYPE traps can be constructed from the included MIB files. The field SNMP events found indicates the number of fully constructed OID.
  5. Click Import.
    The imported SNMP traps are listed in the Events section.

To manually add an SNMP trap to a device:

  1. From the Config Tool home page, open the Plugins task.
  2. Select an SNMP device from the entity browser and click the Properties tab.
  3. In the Events section, click Add an event ().
    The Add an event dialog box opens.
  4. Enter the trap information:
    Name
    A name to identify the trap.
    OID
    The object identifier of the property you would like to add a trap to. This is provided by the manufacturer.
  5. If the SNMP trap has arguments, click Add an argument () and enter the following in the dialog box that opens:
    Dialog box for adding an SNMP event argument.
    Name
    A name to identify the argument.
    OID
    The object identifier of the argument. This is provided by the manufacturer.
    Value type
    The data type of the value identified by the OID. For more information, see Data types used by the SNMP plugin.
  6. Click Add.
    The argument is listed in the Arguments list of the Add an event dialog box.
    Dialog box for adding an SNMP event argument.
  7. Click Add.
    The SNMP trap is listed in the Events section of the Properties page of the device.
  8. Click Apply.