DashboardConfigurator.VerifyClientTrustLevel Event

Allows you to verify the trust level used to specify which actions a client can initiate on the server.

Namespace: DevExpress.DashboardWeb

Assembly: DevExpress.Dashboard.v21.2.Web.dll

NuGet Package: DevExpress.Web.Dashboard.Common

Declaration

C#

public event VerifyClientTrustLevelEventHandler VerifyClientTrustLevel

VB.NET

Public Event VerifyClientTrustLevel As VerifyClientTrustLevelEventHandler

Event Data

The VerifyClientTrustLevel event's data class is VerifyClientTrustLevelEventArgs. The following properties provide information specific to this event:

Property	Description
ClientTrustLevel	Gets or sets the trust level that specifies which actions a client can initiate to execute them on a server side.

Remarks

Warning

Initially, the server works at the ClientTrustLevel.Full trust level. Verify the trust level and specify which actions a client can initiate on the server.

You can do one of the following to prevent inadvertent or unauthorized dashboard modifications and protect dashboards stored on a server:

• Handle the VerifyClientTrustLevel event and set e.ClientTrustLevel to Restricted mode.
• Derive a custom dashboard controller from RestrictedDashboardController (ASP.NET MVC / ASP.NET Core) instead of DashboardController.

A list below describes the Web Dashboard’s specifics when it operates in the Restricted mode:

• Only dashboards stored in dashboard storage can be processed on the client. The designer mode does not work.

• Calling the IEditableDashboardStorage.AddDashboard and IDashboardStorage.SaveDashboard methods leads to an exception.

• Information about data sources contained in a dashboard xml definition is not passed to the client when you request a dashboard xml file.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the VerifyClientTrustLevel event.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

DashboardUserBasedMVC/CS/MVCDashboard/App_Start/DashboardConfig.cs#L16

    DashboardConfigurator.Default.VerifyClientTrustLevel += DashboardConfigurator_VerifyClientTrustLevel;
}