仪表盘就是hangfire的网页界面,有要执行的任务、执行情况、报错等后台的敏感信息。
调用仪表盘的方法非常简单,在Starup文件中如下代码:
public void Configure(IApplicationBuilder app, IHostingEnvironment env) { //.. app.UseHangfireDashboard(); //.. }
在浏览器中输入' 你的地址/hangfire '即可访问。
为了安全仪表板只能本地访问,但是我们可以通过实现自己的IDashboardAuthorizationFilter接口来实现身份验证的访问,如下:
public class MyAuthorizationFilter : IDashboardAuthorizationFilter { public bool Authorize(DashboardContext context) { var httpContext = context.GetHttpContext(); // 允许所有经过身份验证的用户查看仪表板(存在潜在危险)。 return httpContext.User.Identity.IsAuthenticated; } }
或者通过使用 hangfire.dashboard.authorization 来快捷实现。
因为仪表盘中存在删除任务等关键操作,默认是关闭的,可以通过设置 IsReadOnlyFunc属性的 Dashboardoption来设置,如下:
app.UseHangfireDashboard("/hangfire", new DashboardOptions { IsReadOnlyFunc = (DashboardContext context) => true });
默认情况下,UseHangfireDashboard方法将仪表板映射到/hangfire路径,我们可以自己修改访问路径:
//映射到/jobs路径 app.UseHangfireDashboard("/jobs");
仪表盘的右上角存在一个返回站点的链接,我们可以对其进行更改:
// 更改返回站点的链接地址 var options = new DashboardOptions { AppPath = "http://your-app.net" }; // 使“返回站点”链接适用于子文件夹应用程序 var options = new DashboardOptions { AppPath = VirtualPathUtility.ToAbsolute("~") }; app.UseHangfireDashboard("/hangfire", options);
仪表盘不只是有一个,还可以存在多个,映射显示不同存储介质的存储信息:
var storage1 = new SqlServerStorage("Connection1"); var storage2 = new SqlServerStorage("Connection2"); app.UseHangfireDashboard("/hangfire1", new DashboardOptions(), storage1); app.UseHangfireDashboard("/hangfire2", new DashboardOptions(), storage2);