Vision Audit+ / Administration Guide
Permissions and security
This chapter decides who may revert, restore, delete and validate, and explains the AF permissions behind the toolbar.
Overview
This chapter decides who may revert, restore, delete and validate, and explains the AF permissions behind the toolbar.
Action permissions
Set these on the Permissions page of the Configuration Utility or in the Configuration view.
| Setting | Options (default in bold) |
|---|---|
| Allow Revert (Configuration view: Revert Display) | PI Vision Admins / Display Owner / Anyone with Write Access |
| Allow Restore (Restore Display) | PI Vision Admins / Display Owner / Anyone |
| Permanent Delete (Permanently Delete Displays) | Disabled / PI Vision Admins / Display Owner |
| Empty Recycle Bin | Disabled / PI Vision Admins |
| Validate (Display Validation page, Permissions; Configuration view Validate Display) | Admins / Owner / Write (anyone with write access) |
"Display Owner" means the PI Vision owner of the display; PI Vision administrators always qualify. "Write access" means the user can edit the display in PI Vision. The full mapping of each action to its check is in Permissions.
AF permissions
The toolbar works with the user's own identity. Each action (snapshot, revert, restore, validation change, health scan, Display Usage search) is a request that the toolbar writes to the AF database and the service carries out. AF security therefore decides what a user can do at all, before the Vision Audit+ permissions apply. The required permissions per user group are listed in Create the AF database in the Installation Guide.
Comments on history entries are AF annotations. The Comments box appears only when the user has Annotate permission on the history event frame. Set it on the DisplayHistory event frame template and its event frames to control who may comment. Comments cannot be edited or deleted in the toolbar.
Bypass-resistant validation
The service changes the validation state of a display after it has checked the user's request. For an audit trail that users cannot bypass, do not give users Write Data on the display elements under SoftwareAthlete\VisionAudit+\Displays in AF. Give it on the event frames only, so users can create requests but cannot change a display's state directly.
Without Write Data on the display elements, users cannot turn auditing or health monitoring on or off for a single display. Use Track all displays and the All displays monitoring mode instead, or let an administrator enroll displays.
The service also checks every validated display: if it changes outside the workflow, for example through a script or directly in SQL, the service returns it to Draft and records a De-Validated entry.
