Introduction

You can set up an alert service so that when a new device is registered a message is sent out to the system administrators, the support team, and/or the user.

This alert may be triggered during processing of the task "System health check", and will occur when a certificate is within the warning period (as specified in the task parameter "certificateWarnDays");

Once the alert is triggered, notification of the detected event may be sent to specified users and groups.

The alert can be found by navigating to "Administration | Alerts", then scrolling down to the alert "Certificate is about to expire";

Editing the Alert

The alert can be edited by left clicking on the context menu of the alert and selecting "Edit";

A new window will now open titled "Alert - Edit";






This checkbox is ticked if the alert is to be enabled.

Enter the name to be assigned to the alert within the management console.

Enter a description of what the alert will do.

When the alert is triggered, and when a message is sent, this property will specify who was the sender of the notification.


This section allows you to specify which users are to be sent the notifications.



If this checkbox is ticked then a copy of the notification is also emailed to the user that was the subject of the logged event.

We can use the condition builder (via the pencil icon "") to specify what conditions determine if a carbon copy is sent.



If this checkbox is ticked then the alert will send a message using the specified delivery channel.

The "Email" and "SMS" checkboxes can be used to specify which of these two delivery channels are available for use for notification sending.



Additional recipients of the notification may be added here.

Email priority settings can be set either to "High", "Normal" or "Low".

The supplied message subject will be added to the subject header of the notification messages sent to the users.

We use this parameter to specify what message is sent as a notification when the alert is triggered, and may include the following wildcards;

  • [[loginName]] : User's login name
  • [[domainName]] : Domain's name
  • [[applicationName]] : The name of the application
  • [[tokenSerial]] : Token's name
  • [[agentName]] : Agent's name
  • [[serverName]] : The name of the DualShield server
  • [[clientIp]] : The IP address of the requesting client
  • [[logDate]] : The time when this event happened
  • [[eventCode]] : The code of the event





This flag is used to indicate if tasks are to be run when the alert is triggered.

We use this field to specify which tasks are run when the alert is triggered.

The alert is disabled by default, but can be enabled by ticking the checkbox "Enabled";

Specifying Alert Recipients

When the alert is triggered you have the option to send a message to specified recipients using the "Recipient Users" and "Recipient Groups" parameters.

  • You can specify who the alert notifications are sent to by supplying either Recipient Users, Recipient Groups, or both.

    The buttons and can be used to add users or groups t the list of recipients for the alert notifications;

    After clicking on a window titled "Add User" will open;

    At the "Domain" prompt specify the domain of the user, then at the "User" prompt type in the users' name then click , and the specified user will be added to the list of recipients that the notification will be sent to;

    The same process can be used with groups to send the notification to all members of the selected group (or groups).

    You might want to tick "Send a carbon copy to the initiating user" if you want the user to be notified as well. 

    Finally, click "Save" to save this new alert

Sending Notifications

Provided the alert is enabled, the send message is selected, and one or both delivery channels have been enabled, then when a alert is triggered, message notifications will be sent to the selected users (or groups of users)

The default message sent for this alert is as follows;

Message

Hi, administrator,

  Your DualShil certficae sabouo pire, please renew is soo ase.

  Origal message:
        [[desription]]
Regards,
DuaShield

  • When the alert is triggered, notifications can be sent to the specified user via email or SMS.

    In order to send notifications you will first need to tick the "Send Message" box;

    Once messages are enabled you will need to specify which (or both) of the available delivery channels can be used to send the notifications;

    After selecting the delivery channel you can the add additional recipients, specify the message priority and subject, and possibly customise the message sent.

    The default message includes wildcards ((separated by "[[" and "]]", and additional wildcards may be used from the following list;

    • [[loginName]] : User's login name
    • [[domainName]] : Domain's name
    • [[applicationName]] : The name of the application
    • [[tokenSerial]] : Token's name
    • [[agentName]] : Agent's name
    • [[serverName]] : The name of the DualShield server
    • [[clientIp]] : The IP address of the requesting client
    • [[logDate]] : The time when this event happened
    • [[eventCode]] : The code of the event

Adding task execution to the alert

After the alert is triggered you have the additional option to cause one of the existing tasks to be run.

To add task execution to the alert you need to first tick the checkbox prompted "Execute Task", then select what task (or tasks) are to be executed using theicon;

  • No labels