- 8 minutes to read

Permission Set for Log Views

The Log View permission set decides which Log Views the members of a Role can open, and what they may do with the Log Events inside: read context, read or download the message body, see it transformed, resend it, or repair it. Set it well and business users solve their own problems without ever seeing data they shouldn't.

  • ✅ Granular, role-based access control for Log Views
  • ✅ Self-service options for business users, within limits you set
  • ✅ View, download, transform, resend, and repair messages
  • ✅ Global defaults with per-Log View overrides

This page is for administrators. How end-users search and work with a Log View is covered in Getting Started with Log.

Understanding the Log View Permission Set

The Access permission is the gate: without it, a Role sees no Log Views at all. Each other right has a global value and a value per Log View; Inherited on a Log View takes the global value.

flowchart LR G["fa:fa-globe Global permissions<br/>Access + defaults"] -->|"Allow or Deny"| A["fa:fa-search Access<br/>per Log View"] G -.->|"Inherit, Allow, or Deny"| C["fa:fa-key View Context"] G -.->|"Inherit, Allow, or Deny"| B["fa:fa-download View Body"] G -.->|"Inherit, Allow, or Deny"| T["fa:fa-file-alt View Transformed"] G -.->|"Inherit, Allow, or Deny"| R["fa:fa-repeat Resend"] G -.->|"Inherit, Allow, or Deny"| P["fa:fa-magic Repair"] style G fill:#2678BD,color:#fff style A fill:#E47528,color:#fff style C fill:#3F827B,color:#fff style B fill:#3F827B,color:#fff style T fill:#3F827B,color:#fff style R fill:#9E59BB,color:#fff style P fill:#9E59BB,color:#fff

Blue = global permissions, orange = access to the Log View, teal = read rights, purple = rights that send data out again (also switched by System Parameters).

Permission What it unlocks Also depends on
Access The Log View is listed and can be searched Global Access set to Allow
View Context The Context Values tab ProtectedContextValues masks named values
View Body View message body and Download; without it, nothing can be downloaded -
View Transformed The message rendered with a Stylesheet, also in BPM and C4 Dynamic diagrams A Stylesheet on the Message Type
Resend Resend of the original body AllowResubmit = true
Repair Repair and resubmit of an edited body Resend = Allow, AllowResubmit and AllowRepair = true

Role editor Log Permissions tab with Access, View Context, View Body, View Transformed, Resend, and Repair columns for global and per-Log View rights (7.10)
The Log Permissions (10) tab of the Finance example Role: Global permissions on top (Access on the Log Views row, default rights on the Permissions row), one row per assigned Log View below, each set to Allow, Deny, or Inherited.

Global Permissions

The global Access permission, on the Log Views row under Global permissions, controls whether a user can use the Log functionality at all. It must be set to Allow for users to see any Log Views. The Permissions row sets the global value of every other right; a Log View that says Inherited uses it.

Log Permissions tab with Global permissions, Access set to Allow, and the filterable Log Views list with per-view rights (7.10)
The Log Permissions tab: global Access and default rights on top, the assigned Log Views below with a filter box, Include deleted, and Edit to add or remove views.

Access Log

To use Nodinite Log Views, a User must belong to a Role with Allow in the Access column of the Log Views row under Global permissions.

Global Access set to Allow on the Log Views row, and the Set permit list with Allow and Deny on one Log View (7.10)
1: the global Access right on the Log Views row. 2: the Access right on one Log View, picked from the Set permit list.

  1. The Role is set to Allow access to the Log Views under Global permissions.
  2. The Role can have different Access rights to individual Log Views.
    • Allow – the Log View is visible and accessible to the end-user.
    • Deny – the Log View is NOT visible or accessible to the end-user.

Note

If a User is a member of any Role where access to the Log is denied (Deny), the user is blocked from accessing ALL Log Views.

You can also add a Role to a Log View from the Log View itself, in the Roles section of Add or manage Log View. The DefaultRolesInViews System Parameter pre-selects Roles on every new Log View.

Log View Permissions

The following permissions can be set individually for each Log View. You can also set them from the Log View side, on its Roles section:

View Context

View Context lets members of the Role open the Context Values tab of a Log Event.

Context Values tab of a Log Event in a Log View
Context values hold the message's metadata, such as file names, queue names, and correlation IDs.

  • Inherited – Context data is visible if the global setting is Allow; otherwise, it is not.
  • Allow – Context data is visible and accessible.
  • Deny – Context data is NOT visible or accessible.

Without View Context, Nodinite doesn't even load the context values for the user, so they can't be read from the page either.

To protect sensitive context data further, Nodinite can mask values for everyone; see ProtectedContextValues. Built-in detail fields on the Additional Field Values tab are shown, hidden, or masked with HideAdditionalFieldValuesInLogViews, and HideSearchFieldValuesInLogViews hides Search Field values that aren't part of the Log View.

Access to a Log View through a Role gives the Log View, not every value of every Search Field: users see only the values of the Search Fields the Log View includes. A field the Log View doesn't include isn't even listed for them; see Which Search Field Values a Log View Shows.

A user in the Role Contoso Warehouse Staff opens the event details and Customer ID is not listed at all, animated walkthrough (7.12)
Animated walkthrough: a member of the Role sees only the fields the Log View includes.

View Body

View Body lets members of the Role open the message Body in Log Views.

Log Event Action menu with View message body highlighted
The View message body item in a Log Event's Action menu.

The permission also allows Download of the body: single or multiple Log Events, the original bytes, or, from Nodinite 7.11, Download converted to another character encoding. New 7.11 See Download.

Log Event Action menu with the Download item
Single download from the Action menu.

  • Inherited – The Body (raw data) is visible and downloadable if the global setting is Allow; otherwise, it is not.
  • Allow – The Body is visible and downloadable.
  • Deny – The Body is NOT visible or downloadable.

View Transformed

View Transformed lets members of the Role view a message through a Stylesheet. A Log Event's Message Type can be bound to any number of Stylesheets, and each bound Stylesheet shows up in the event's Action menu as View message formatted as 'Stylesheet name'.

That is the point of the permission: a Stylesheet can show only part of the data, filtered or masked, in a form business users can read. View Body gives the full payload and all its information. A Role can therefore have View Transformed set to Allow while View Body stays Inherited or Deny. Its members read the formatted message, but never the raw body.

Assign Roles dialog of a Log View where the Administrators Role has View Transformed set to Allow and View Body to Inherited (7.12)
The first Role reads messages through Stylesheets only: View Transformed is Allow, View Body is Inherited.

  • Inherited – Transformation is available if the global setting is Allow; otherwise, it is not.
  • Allow – Transformation is available to the end-user.
  • Deny – Transformation is NOT available.

Resend

Resend lets members of the Role send the original message Body again from Log Views.

Log Event Action menu with the Resend item
The Resend item in a Log Event's Action menu.

  • Inherited – Resend is available if the global setting is Allow; otherwise, it is not.
  • Allow – Resend is available to the end-user.
  • Deny – Resend is NOT available.

Note

The AllowResubmit System Parameter must be set to true; otherwise, Resend is disabled for everyone, administrators too: the items are hidden, and the Web API refuses them (403). The permit can still be set here, but it has no effect while the switch is false; Edit Log View shows it locked, Off by AllowResubmit.

Repair

Granting both Resend and Repair lets members of the Role edit the message Body and resubmit it.

To Repair a Log Event, first click View Details.

Log Event Action menu with View details
View details opens the Log Event in a new browser tab.

A new tab opens in the Client Browser. On this page, click Repair and resubmit.

Repair and resubmit button on the Log Event details page
The Repair and resubmit button on the details page.

Repair message modal with the editable message, Encoding, and transport types
Step 1 edits the message (with its encoding); step 2 picks the transport: File, MSMQ, ActiveMQ, or Webhook.

  • Inherited – Repair and resubmit is available if the global setting is Allow; otherwise, it is not.
  • Allow – Repair and resubmit is visible and accessible.
  • Deny – Repair and resubmit is NOT visible or accessible.

Note

The AllowResubmit and AllowRepair System Parameters must be set to true; otherwise, Repair and resubmit is disabled for everyone, administrators too: the items are hidden, and the Web API refuses them (403). The Resend permission must also be set to Allow. The Repair permit can still be set here, but it has no effect while a switch is false; Edit Log View shows it locked, Off by AllowRepair (or Off by AllowResubmit).

Repair without Resend shows neither Repair and resubmit nor the repair option in the Resend dialog. Repair alone does let Nodinite load the body so it can be edited, but without View Body there is still no Download. While AllowRepair is false, Repair gives no access to the body at all; reading it needs View Body.

The Webhooks to choose from are defined in the ResendWebhookSettings System Parameter, and ResubmitContextValuesForActiveMQ selects which context properties are attached when the message is resubmitted to an ActiveMQ queue. The full repair flow, including the 7.11 encoding options, is described in Repair.

Note

The Nodinite Administrators Role can be set to Deny access to the Log and all related permissions. This limits even the built-in administrators when log data is sensitive.

  • Use this with caution. Always make sure at least one user has access to the Log and related permissions, so you aren't locked out of critical log data.

Administrators Role with Deny on Access Log and all Log View rights
The Administrators Role with Deny on the Log and all related permissions.

Permission Inheritance and Summary

The net rights of a User are the combination of all their Roles. If any Role has Deny on the Log, the user is denied all Log Views regardless of other permissions. If one Role allows a view and another Role denies the same view, Deny wins: the user does not see that view. Open a User in Add or manage User to see the result.

User editor Log Permissions (2) tab of the user alice.smith in the CONTOSO domain, with Access Log allowed and the rights per Log View (7.12)
The User editor shows the net (effective) Log permissions for that user, across all of their Roles.

Next Steps

Add or manage Role
Add or manage Log View
Permission Set for Monitor Views

Monitor Views permission set
Repository Model permission set
C4 Diagram Set permission set
What is a Role?
Access Management
Log Views
Log Views - Overview
Getting Started with Log
Users
DefaultRolesInViews – Roles pre-selected for new Log Views
AllowResubmit and AllowRepair – Global switches for Resend and Repair
ProtectedContextValues – Mask context values
Which Search Field Values a Log View Shows – What a Role's users see of each event
Administration