RT.MesWeb.Authentication 1.1.0

Authentication 使用说明

配置要求

• 需要在 appsettings.json 中添加以下配置：

{
    "Authentication": {
        "AuthEntities": {
            "ConnectionString": "Server=127.0.0.1;uid=sa;pwd=password;database=dbname;Trust Server Certificate=true;",
            "DatabaseType": "SqlServer" // 可选值：SqlServer / Oracle / DM
        },
        "SystemAccount": {
            "AdminRoleName": "administrator",
            "AdminUserName": "admin",
            "DefaultPassword": "mes123"
        },
        "ThreeManager": {
            "EnableThreeManager": false,
            "SystemManagerUserName": "110101199001010001",
            "SecurityManagerUserName": "110101199001010002",
            "SecurityAuditorUserName": "110101199001010003",
            "SystemManagerRoleName": "系统管理员",
            "SecurityManagerRoleName": "安全管理员",
            "SecurityAuditorRoleName": "安全审计员",
            "SystemManagerPermissions": "",
            "SecurityManagerPermissions": "",
            "SecurityAuditorPermissions": ""
        },
        "AccessControl": {
            "AllowMultiTerminal": false,
            "SessionTimeoutSeconds": 200,
            "HeartbeatIntervalSeconds": 60,
            "Lockout": {
                "MaxFailedAccessAttempts": 5,
                "DefaultLockoutMinutes": 30,
                "InactiveDaysToLock": 90
            },
            "PasswordPolicy": {
                "ExpiryDays": 180,
                "ReminderDaysBeforeExpiry": 7,
                "RequiredLength": 8,
                "ComplexityRegex": "^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d).+$",
                "AllowRepeatWithLast": false
            }
        }
    },
}

数据库要求

• AuthEntities指向的数据库应当全套权限认证体系的数据表
• AuthEntities指向的数据库应当包含以下序列：
  • AUTH_SEQ_NO：用于生成数据表编号的序列。
• 数据库中应包含序号生成机制
  • SQL Server：应包含生成Sequence的存储过程和Sequence序列对象
  • Oracle：包含生成Sequence的序列对象即可
  • DM：包含生成Sequence的序列对象即可

使用说明

• Authentication服务配置：

// 在MesWebApiHostModule中增加对AuthenticationApiModule的依赖：
[DependsOn(
        typeof(AuthenticationApiModule)
        )]

• 需要在主工程内注册基础服务：

builder.Services.AddHttpContextAccessor();

• AuthEntities需要在主工程内进行依赖注入,直接通过以下方法进行注册：

services.ConfigureAuthentication(configuration);

• LoginService需要在主工程内注册扩展登录提供程序，格式如：

services.AddTransient<CustomLoginProvider>();
services.AddTransient<IDictionary<string, ILoginProvider>>(sp =>
    new Dictionary<string, ILoginProvider>
    {
        { "BS03", sp.GetRequiredService<CustomLoginProvider>() },
    });

• 当前项目依赖Redis服务（Redis服务内容参见RT.MesWeb.Redis）;

• Authentication有授权检查，需要在主工程内启动授权服务（授权配置参见RT.MesWeb.Framework中的README）：

MesLicenseChecker.Current.Start(configuration, hostEnvironment.ContentRootPath, logger);

• 当前项目已经启用多语言支持，需要在主工程内注册多语言资源：

// 在应用程序构建前：
services.AddLocalization(options => options.ResourcesPath = "");
services.Configure<RequestLocalizationOptions>(options =>
{
    var supportedCultures = new[]
    {
        new CultureInfo("zh-CN"),  // 中文简体
        new CultureInfo("en-US"),  // 英文
    };

    // 设置支持的语言列表
    options.SupportedCultures = supportedCultures;
    options.SupportedUICultures = supportedCultures;
    // 默认语言（无语言标识时使用）
    options.DefaultRequestCulture = new RequestCulture("zh-CN");
    // 优先级：URL参数 > Cookie > 请求头
    options.RequestCultureProviders.Insert(0, new QueryStringRequestCultureProvider());
});
// 在应用程序构建后：
app.UseRequestLocalization(app.Services.GetRequiredService<IOptions<RequestLocalizationOptions>>().Value);