DLI DIN4 - Page 31

30 CONTENTS
8.2.3.5 SNMPv2c settings
SNMPv2c TRAP and INFORM targets have the following parameters:
• server address (hostname or IP address of management station),
• community string (the shared secret for authentication to server),
• trap OID (string)
SNMP v2c TRAPs and INFORMs accept an snmp_trap_oid event property to override the trap OID; it must be
a string. They also accept the snmp_values event property as described above.
8.2.3.6 SNMPv3 settings
SNMPv3 TRAP and INFORM targets have the following parameters:
• server address (hostname or IP address of management station),
• security name (username to authenticate as),
• security engine ID (leave empty for default),
• context name (leave empty for default),
• context engine ID (leave empty for default),
• authentication protocol ("MD5" and "SHA" are supported, leave empty "" for no authentication),
• privacy protocol ("DES" and "AES" are supported, leave empty "" for no encryption),
• authentication passphrase (should be at least 8 characters long, or empty if no authentication),
• privacy passphrase (should be at least 8 characters long, or empty if no encryption),
• trap OID (string)
You can either disable authentication and encryption, enable only authentication, or enable both. An encrypted, but
not authenticated configuration is invalid.
SNMP v3 TRAPs and INFORMs accept an snmp_trap_oid event property to override the trap OID; it must be
a string. They also accept the snmp_values event property as described above.
8.2.4 WebHook notifications
Web hooks notifications send preconfigured POST HTTP requests to URLs.
• recipient URL — the URL to send a request to (must be an HTTP or HTTPS URL);
• content type — the type of content representation to use (must be "json" for JSON or "urlencoded" for URL-
encoded).
The request payload (content) is a key-value map with the following keys:
• type — the id of the event type;
• severity — the severity label for the event (one of the strings "emergency", "alert", "critical", "error",
"warning", "notice", "info" or "debug");
• message — the human-readable message of the event type;
If present, the properties event property is used to populate the payload with additional items; for instance,
an action properties={time=os.time()} will result in a time key being added. Non-string values will be
JSON-encoded (regardless of the content type).
If present, the headers event property is used to add HTTP headers to the request being sent.
If present, the message_short event property is used for the message; otherwise, message is used.
DLI DIN4 User’s Guide: 20170809T111540Z