RuoVea.OmiApi.SystemApp 7.0.0.5

RuoVea.OmiApi.SystemApp

介绍：

用户、角色、菜单、机构、职位、权限管理 API

用户、角色、菜单、机构、职位、权限管理 API（RuoVea.OmiApi.SystemApp）：基于.Net5.0 、.Net6.0 、.Net7.0、.Net8.0构建的简单、跨平台的系统。 系统业务简单、代码清晰，如果您只是单纯只需简单增、删、改、查。没有多余的功能，简单扩展下基本可以满足日常需求。 支持的数据库有 MySql、SqlServer、PostgreSQL、SQLite、Oracle...

安装教程

Install-Package RuoVea.OmiApi.SystemApp

/*类库映射API组件*/
if (builder.Environment.IsProduction())
{
    builder.Services.AddDynamicWebApi(options =>
    {
        options.DefaultApiPrefix = "/openapi/api";
        options.RemoveControllerPostfixes = new List<string> { "AppService", "Service" };
        options.RemovePrefix = new List<string> { "get", "post" };
    });
}
else
{
    builder.Services.AddDynamicWebApi(options =>
    {
        options.RemoveControllerPostfixes = new List<string> { "AppService", "Service" };
        options.RemovePrefix = new List<string> { "get", "post" };
    });
}

builder.Services.AddOmiSystemSetup();
builder.Services.AddHttpContextSetup<AspNetUser>();
//builder.Services.AddAuthenticationSetup(IdentifyEnum.Jwt, true);

builder.Services.AddSqlSugarSetup(moreFilter: (provider) => {
    SqlSugarFilter.SetCustomEntityFilter(builder.Services, provider);
});
builder.Services.AddSystemInitSetup();


builder.Services
    .RequestActionSetup() // 注入 请求日志拦截 [执行操作日志、参数验证 ]
    .ResultSetup()
    .ExceptionSetup();

builder.Services.AddSwaggerSetup();

#region 跨域
// 跨域
//services.CorsUrls();
builder.Services.AddCors(option =>
{
    option.AddDefaultPolicy(builder =>
    {
        builder.AllowAnyOrigin().AllowAnyHeader().AllowAnyMethod();
    });
});
#endregion

app

app.UseCors();
app.UseAuthentication();
app.UseAuthorization();

配置信息

  /* Jwt配置 */
  "Jwt": {
    "ValidateIssuerSigningKey": true, // 是否验证密钥，bool 类型，默认true
    "IssuerSigningKey": "3c1cbc3f546eda35168c3aa3cb91780fbe703f0996c6d123ea96dc85c70bbc0a", // 密钥，string 类型，必须是复杂密钥，长度大于16
    "ValidateIssuer": true, // 是否验证签发方，bool 类型，默认true
    "ValidIssuer": "SecurityDemo.Authentication.JWT", // 签发方，string 类型
    "ValidateAudience": true, // 是否验证签收方，bool 类型，默认true
    "ValidAudience": "jwtAudience", // 签收方，string 类型
    "ValidateLifetime": true, // 是否验证过期时间，bool 类型，默认true，建议true
    "ExpiredTime": 1440, // 过期时间，long 类型，单位分钟，默认1440分钟(24小时)
    "ClockSkew": 5 // 过期时间容错值，long 类型，单位秒，默认5秒
  },

  /* 数据库链接 具体配置见SqlSugar官网（第一个为默认库不需要设置ConfigId）*/
  "ConnectionConfigs": [
    {
      "DbType": "Sqlite", /*MySql、SqlServer、Sqlite、Oracle、PostgreSQL、Dm、Kdbndp、Oscar、MySqlConnector、Access、OpenGauss、QuestDB、HG、ClickHouse、GBase、Odbc、Custom */
      "ConnectionString": "DataSource=./ruovea.db", /*库连接字符串*/
      //"EnableUnderLine": false, /*启用驼峰转下划线*/
      //"EnableDiffLog": false, /*启用库表差异日志*/

      //"IsEncrypt": false, /*是否加密*/
      //"DbSecurity": "", /*链接字符串解密密钥*/

      //"IsDeleteFilter": true, /*查询删除过滤 实体需继承 IDeletedEntity*/
      //"IsUserIdFilter": false, /*查询过滤器默认为false,true的时候;当有用户cretor的时候将及时过滤 实体需继承ICreatorFilter或EntityBase*/
      //"IsTenantIdFilter": false, /*查询过滤器 默认为false,true的时候;当有用户cretor的时候将及时过滤 实体需继承 ITenantIdFilter*/
      //"CommandTimeOut": 30 /*设置 SQL 执行的超时时间(默认30)分钟 */
    }
  ]

更多配置

1. MD5 配置

{
   "PasswordConfig": {
      "CryptType": "Md5",
      "Length": 32,
      "PublicKey": null,
      "PrivateKey": null
   }
}

注意：MD5已不安全，仅用于兼容旧系统

2. JsMD5 配置

{
   "PasswordConfig": {
      "CryptType": "JsMD5",
      "Length": 32,
      "PublicKey": null,
      "PrivateKey": null
   }
}

3. HMACMD5 配置

{
   "PasswordConfig": {
      "CryptType": "HMACMD5",
      "Length": 32,
      "PublicKey": "your-hmac-secret-key",
      "PrivateKey": null
   }
}

4. AES 配置

{
   "PasswordConfig": {
      "CryptType": "AES",
      "Length": 256,
      "PublicKey": "aes-encryption-key-32bytes",
      "PrivateKey": "initialization-vector-16b"
   }
}

5. DESC 配置

{
   "PasswordConfig": {
      "CryptType": "DESC",
      "Length": 64,
      "PublicKey": "des-key",
      "PrivateKey": "des-iv"
   }
}

6. BASE64 配置

{
   "PasswordConfig": {
      "CryptType": "BASE64",
      "Length": 0,
      "PublicKey": null,
      "PrivateKey": null
   }
}

7. RSA 配置

{
   "PasswordConfig": {
      "CryptType": "RSA",
      "Length": 2048,
      "PublicKey": "-----BEGIN PUBLIC KEY-----...",
      "PrivateKey": "-----BEGIN PRIVATE KEY-----..."
   }
}

8. HMACSHA1 配置

{
   "PasswordConfig": {
      "CryptType": "HMACSHA1",
      "Length": 0,
      "PublicKey": "hmac-key",
      "PrivateKey": null
   }
}

9. HMACSHA256 配置（推荐）

{
   "PasswordConfig": {
      "CryptType": "HMACSHA256",
      "Length": 0,
      "PublicKey": "256-bit-secret-key",
      "PrivateKey": null
   }
}

10. HMACSHA384 配置

{
   "PasswordConfig": {
      "CryptType": "HMACSHA384",
      "Length": 0,
      "PublicKey": "384-bit-key",
      "PrivateKey": null
   }
}

11. HMACSHA512 配置

{
   "PasswordConfig": {
      "CryptType": "HMACSHA512",
      "Length": 0,
      "PublicKey": "512-bit-secure-key",
      "PrivateKey": null
   }
}

12. SM2（非对称加密）

{
  "PasswordConfig": {
    "CryptType": "SM2",
    "Length": 256,  // SM2 标准密钥长度（256位）
    "PublicKey": "04X9Y8Z7...（公钥HEX字符串，通常以04开头表示未压缩）",
    "PrivateKey": "A1B2C3D4...（私钥HEX字符串，64字符）",
    "InitPassword": ""  // 非对称加密一般不在配置存密码
  }
}

13. SM3（哈希算法）

{
  "PasswordConfig": {
    "CryptType": "SM3",
    "Length": 32,  // SM3固定输出32字节
    "PublicKey": null,  // 哈希算法不需要密钥
    "PrivateKey": null,
    "InitPassword": "6c9b8d3f...（Vea108.com的SM3哈希值）"
  }
}

14. SM4-ECB（对称加密）

{
  "PasswordConfig": {
    "CryptType": "SM4ECB",
    "Length": 16,  // SM4密钥固定16字节
    "PublicKey": "SM4-16byte-Key123",  // 加密密钥
    "PrivateKey": null,  // ECB模式不需要IV
    "InitPassword": ""  // 建议通过密钥加密动态密码
  }
}

15. SM4-CBC（对称加密）

{
  "PasswordConfig": {
    "CryptType": "SM4CBC",
    "Length": 16,  // SM4密钥固定16字节
    "PublicKey": "SM4-16byte-Key456",  // 加密密钥
    "PrivateKey": "Random-16byte-IV",  // CBC需要16字节IV
    "InitPassword": ""
  }
}