User notifications (PSN)
The User notifications (PSN) module acts as the gateway between the Notification Client (psntfclient) and the Notification Service, and enables users to receive, acknowledge, and act on notifications from their web browser.
When a web notification is triggered, the user is prompted to log into Bravura Security Fabric and then the web browser will open at the page of the User notifications (PSN) module. Users can also access this page, if they have notifications, from a link on the main menu.
Enabling / disabling the User notifications (PSN) module
The User notifications (PSN) module is enabled by default.
To disable the User notifications (PSN) module:
Click Manage the system > Modules> User notification.
Turn off PSN ENABLED to disable the module.
Click Update to commit your changes.
Disabling the User notifications (PSN) module disables all web notifications. It does not affect batch notifications.
Configuring notification events
If you are using a web notification to enforce compliance with an Acceptable use policy configure event options, listed below, which trigger external programs. See Event actions for more information about configuring event actions.
Control what happens after user declines AUP
You can use a plug-in to control what should happen after a user declines an acceptable use policy.
The plugin is set by the AUP PLUGIN field (Manage the system > Modules> User notifications (PSN)).
The plugin runs when users accept or decline an acceptable use policy, and returns the action to perform if declined (continue to sign in or logout).
There are no shipped plugins for use with this plugin point. See below for more information on writing a custom plugin.
Requirements
Configure a web notification for AUP (see example).
Set the Plugin to run to determine compliance to Query USERSTAT tag.
On the Configure notification plugins page, select External option for Non-compliant users will be directed to this URL : and set its value to PSNAUP in order to get the Accept / Decline button.
Enable Acceptable use policy .
Enter the name of the plugin in the AUP PLUGIN field (Manage the system > Modules> User notifications (PSN)).
See Writing plugins for general requirements.
Execution points
This plugin is executed once when a user accepts or declines an acceptable use policy
Input
The following is a sample of input:
"" "" = {
"notifyId" = "AUP"
"buttonName" = "SUBMIT-NOTIF-AUP-DCLN"
"viewer" "user" = {
"id" = "User1"
"name" = "User 1"
}
}Output
The following is a sample of output:
"output" "None" = {
"declineAction" = "1"
"retval" = "0"
"errmsg" = “<your error message if needed>”Where declineAction is used to specify the action to perform when declining:
"0" (default action, stay on AUP Accept/Decline page)
"1" (return to previous page, which is AUP list page
"2" (logout user)
Modify notifications and redirect users
You can use a plugin to modify the order of notifications and redirect users as they navigate and act on notifications.
When the User notifications (PSN) module is enabled and the plugin is set, and a user logs into Bravura Security Fabric :
The plugin presents a list of notifications in order of priority.
After the user acts on a notification (clicks Accept or Decline), the plugin directs the user to the next notification in the list.
When there are no more notifications left, the user is directed to the Front-end .
The plugin is set by the PSN MODIFY ORDER AND REDIRECTION PLUGIN field (Manage the system > Modules> User notifications (PSN) )
There are no shipped plugins for use with this plugin point. See below for more information on writing a custom plugin.
Requirements
The plugin must return notifications not only in order but without any gaps in numbers. If there are 5 notifications and you want to show them all, then they will have to be numbered 1, 2, 3, 4, 5. If say they were numbered 1, 2, 3, 4, 6 then the last one will be hidden.
Notifications can be hidden by:
Setting their priorities to "0" or any number behind the real sequence; for example if you have 10 notifications: 1 through to 10, you can hide notifications by setting the priority to 12, 100 or 9999.
Removing particular KVGroups from output altogether. Ensure that you update priorities of all notifications "behind" the deleted one.
See Writing plugins for general requirements.
Execution points
This plugin is executed once when a user logs into Bravura Security Fabric.
Input
The following is a sample of input:
# KVGROUP-V1.0
"" "" = {
"notification" "" = {
"id" = "AUP1"
"desc" = "AUP1"
"severity" = "F"
"maxrem" = "-1"
"infomsg" = "AUP1"
"link" = "PSNAUP"
"status" = "R"
"nreminders" = "0"
}
"notification" "" = {
"id" = "AUP2"
"desc" = "AUP2"
"severity" = "F"
"maxrem" = "-1"
"infomsg" = "AUP2"
"link" = "PSNAUP"
"status" = "R"
"nreminders" = "0"
}
"notification" "" = {
"id" = "AUP3"
"desc" = "AUP3"
"severity" = "F"
"maxrem" = "-1"
"infomsg" = "AUP3"
"link" = "PSNAUP"
"status" = "R"
"nreminders" = "0"
}
"notification" "" = {
"id" = "AUP4"
"desc" = "AUP4"
"severity" = "I"
"maxrem" = "-1"
"infomsg" = "AUP4"
"link" = "PSNAUP"
"status" = "R"
"nreminders" = "0"
}
} Output
The following is an example of the possible output, where "AUP2" is hidden:
# KVGROUP-V1.0
"" "" = {
retval = "0"
"notification" "1" = {
"id" = "AUP1"
"desc" = "AUP1"
"severity" = "F"
"maxrem" = "-1"
"infomsg" = "AUP1"
"link" = "PSNAUP"
"status" = "R"
"nreminders" = "0"
}
"notification" "3" = {
"id" = "AUP3"
"desc" = "AUP3"
"severity" = "F"
"maxrem" = "-1"
"infomsg" = "AUP3"
"link" = "PSNAUP"
"status" = "R"
"nreminders" = "0"
}
"notification" "2" = {
"id" = "AUP4"
"desc" = "AUP4"
"severity" = "I"
"maxrem" = "-1"
"infomsg" = "AUP4"
"link" = "PSNAUP"
"status" = "R"
"nreminders" = "0"
}
} Note that:
Output has to contain a "retval" KV-pair.
KVGroup key has to be "notification" precisely and cannot be changed.
KVGroup names have embedded integers, representing the order in which plugin has organized the notices. Starting from 0: "0" is the first notice, "1" is the second, and so on.
.