4D.术士的属性

trydofor原创2022/6/28术士属性大约 9 分钟

4D.术士的属性

有关Warlock登录授权的设置

4D.1.wings-enabled-77.properties

覆盖简单实现，

wings.enabled.faceless.simple-journal=false
wings.enabled.faceless.simple-flakeid=false

wings.enabled.warlock.watching

Boolean=false，是否支持计时分析

wings.enabled.warlock.sec-check-url

Boolean=true，是否检查URL冲突

wings.enabled.warlock.sec-web-auto

Boolean=true，是否支持 Web 自动配置，firewall，debug等

wings.enabled.warlock.sec-http-bind

Boolean=true，是否支持 warlock security http wing bind

wings.enabled.warlock.sec-http-auth

Boolean=true，是否支持 warlock security http wing auth

wings.enabled.warlock.sec-http-base

Boolean=true，是否支持 warlock security http base 验证

wings.enabled.warlock.sec-http-auto

Boolean=true，是否支持 warlock security http auto

wings.enabled.warlock.sec-http-chain

Boolean=true，是否配置默认的 SecurityFilterChain

wings.enabled.warlock.dummy-service

Boolean=false，是否支持security的dummy服务

wings.enabled.warlock.mvc-auth

Boolean=true，是否开启默认的auth Controller

Boolean=true，是否开启默认的login page Controller

wings.enabled.warlock.mvc-proc

Boolean=true，是否开启由filter处理仅做文档的login/out proc

wings.enabled.warlock.mvc-user

Boolean=true，是否开启默认的user Controller

wings.enabled.warlock.mvc-mock

Boolean=true，是否开启默认的mock Controller

wings.enabled.warlock.mvc-test

Boolean=true，是否开启默认的test Controller

wings.enabled.warlock.mvc-tweak

Boolean=false，是否开启默认的TweakController

wings.enabled.warlock.mvc-oauth

Boolean=true，是否开启默认的OauthController

4D.2.wings-flywave-fit-79.properties

wings.faceless.flywave.fit.warlock-enum-i18n

检查并自动安装，warlock-enum-i18n的数据库依赖

path=classpath*:/wings-flywave/branch/feature/01-enum-i18n/*.sql
revi=2019_0521_01L
lost=WARN

wings.faceless.flywave.fit.warlock-user-auth

检查并自动安装，warlock-user-auth的数据库依赖

path=classpath*:/wings-flywave/master/04-auth/*.sql
revi=2020_1024_01L, 2020_1024_02L
lost=WARN

wings.faceless.flywave.fit.warlock-conf-mode

检查并自动安装，warlock-conf-mode的数据库依赖

path=classpath*:/wings-flywave/master/05-conf/*.sql
revi=2020_1025_01L
lost=WARN

4D.3.wings-warlock-justauth-77.properties

Oauth登录支持，使用just-auth

wings.warlock.just-auth.cache-size

Integer=5000，缓存capacity数量

wings.warlock.just-auth.cache-live

Integer=300，ttl秒数，expireAfterWrite

wings.warlock.just-auth.safe-state

Map<String, String>，默认，/login={1}/#{0}{2}

设定安全的state，通过key获取内容，执行重定向(http或/开头)或回写。内容支持MessageFormat格式的占位符模板，{0}为key，若是http开头，则检测是否为safe-host

wings.warlock.just-auth.safe-host

Set<String>=localhost:8080,localhost:8081

设定安全的host，减少dev时的跨域，可引发redirect_uri_mismatch错误

wings.warlock.just-auth.auth-type

Map<String, AuthConfig>，key同wings.warlock.security.auth-type.*，支持{host},{scheme},{authType},{authZone}变量，根据request的参数。

github.client-id=Iv1.561a1b1940c77d3a
github.client-secret=${GITHUB_OAUTH_SECRET}
github.redirect-uri={scheme}://{host}/auth/github/login.json

wings.warlock.just-auth.http-conf

Map<String, Http>，如果不需要代理，设置proxy-type=DIRECT或host=空即可

github.timeout=10，此处为秒，与just-auth的毫秒不同。
github.proxy-type=SOCKS
github.proxy-host=127.0.0.1
github.proxy-port=1081

4D.4.wings-warlock-check-77.properties

是否做时区的检查

wings.warlock.check.tz-offset

Integer=5，秒，数据库和jvm时间差，绝对值的最大值

wings.warlock.check.tz-fail

Boolean=true，时间差异过大时，是终止还是log

4D.5.wings-warlock-cud-77.properties

Jooq对配置和授权表的CUD监听，empty表示不记录字段，-表示忽略此表。

wings.faceless.jooq.cud.table[win_perm_entry]=
wings.faceless.jooq.cud.table[win_role_entry]=
wings.faceless.jooq.cud.table[win_conf_runtime]=key,current,handler

4D.6.wings-warlock-error-77.properties

全局异常控制。default为默认配置，兜底处理所以异常并为其他同类型提供默认值。

wings.warlock.error.default-exception

http-status=200
content-type=application/json;charset=UTF-8
response-body={"success":false,"message":"unknown error"}

4D.7.wings-warlock-i18n-77.properties

wings.warlock.i18n.zoneid-enum

Set<String>=pro.fessional.wings.faceless.enums.autogen.StandardTimezone

初始化的ZoneId的StandardTimezoneEnum类

wings.warlock.i18n.locale-enum

Set<String>=pro.fessional.wings.faceless.enums.autogen.StandardLanguage

初始化的Locale的StandardLanguageEnum类

4D.8.wings-warlock-security-77.properties

Spring Security设置

wings.warlock.security.web-debug

Boolean=false，WebSecurity.debug

wings.warlock.security.authority-role

Boolean=true，权限是否使用Role

wings.warlock.security.authority-perm

Boolean=true，权限是否使用Perm

wings.warlock.security.anonymous

Boolean=false，是否支持匿名用户登录

Boolean=true，true以servlet的forward进行，否则redirect(302)跳转

String=/auth/login-page.json，未登录时跳转的页面，需要有controller处理

String=/auth/{authType}/login.json

loginProcessingUrl，处理登录的Ant格式URL，由filter处理，不需要controller。支持变量authType和authZone，可以通过param或path获得（PathPattern）

Set<String>=POST,GET，spring默认仅POST，以更好的RESTful，但Oauth有Get

wings.warlock.security.logout-url

String=/auth/logout.json

登出地址，由filter处理，不需要controller

Boolean=false，登录成功后是否重定向

String=redirectTo，登录成功的重定向参数

String=/，登录成功的重定向默认地址

String={"success":true,"message":"login success"}，非重定向时登录成功返回的body，空时不注入handler

String={"success":false,"message":"{message}"}，登录失败返回的body

wings.warlock.security.logout-success-body

String={"success":true,"message":"logout success"}，登出成功返回的body，空时不注入handler

wings.warlock.security.session-maximum

Integer=-1，同时登陆的maximumSessions。-1为不限制

wings.warlock.security.session-expired-body

String={"success":false,"message":"session has been expired, possibly due to multiple logins"}，过期时返回的内容

wings.warlock.security.username-para

String=username，Username Parameter，用户名参数

wings.warlock.security.password-para

String=password，Password Parameter，密码参数

wings.warlock.security.role-prefix

String=ROLE_，GrantedAuthorityDefaults建议和spring一致，不用动

wings.warlock.security.web-ignore

配置顺序由宽松到严格的顺序，webIgnore > PermitAll > Authenticated > Authority > AnyRequest收尾。value是-或空，表示忽略此key。

①忽略项，Map<String, String>，antMatcher，无SecurityFilter流程及功能，如静态资源。

assets=/assets/**
webjars=/webjars/**
swagger-ui=/swagger-ui/**
swagger-api=/v3/api-docs/**

wings.warlock.security.permit-all

②都允许，Map<String, String>，antMatcher。

error=/error
auth=/auth/**
test=/test/**

wings.warlock.security.authenticated

③仅登录，Map<String, String>，antMatcher。

user=/user/**

wings.warlock.security.authority

④有权限，Map<String, String>，antMatcher。按URL分组合并权限，最后以URL的ascii倒序设置，即英数先于*，宽松规则在后。

ROLE_ACTUATOR=/actuator/**

wings.warlock.security.any-request

⑤默认项，String，支持以下。

permitAll|authenticated|anonymous|fullyAuthenticated
任意非空，非以上字符串，认为是Authority，逗号或空白分割多个。

wings.warlock.security.auth-type-default

String=pro.fessional.wings.warlock.service.auth.WarlockAuthType#USERNAME

支持的验证类型，enum全路径，一对一，否则反向解析有问题；不含-，default是特殊值，表示没有匹配时使用。

wings.warlock.security.auth-type

Map<String, String>，登录方式枚举映射，必须一对一映射。

username=pro.fessional.wings.warlock.service.auth.WarlockAuthType#USERNAME
mobile=pro.fessional.wings.warlock.service.auth.WarlockAuthType#MOBILE
email=pro.fessional.wings.warlock.service.auth.WarlockAuthType#EMAIL
github=me.zhyd.oauth.config.AuthDefaultSource#GITHUB
weibo=me.zhyd.oauth.config.AuthDefaultSource#WEIBO

key为用户说明，重复时覆盖，建议为username+(/+auth-type)?
auth-type=时，为匹配全部auth-type。
其他设置，参考WarlockAuthnService.Details 的类型及默认值。

以root举例，注意，仅是举例，并非真实默认值。

root.auth-type=
root.username=
root.password=
root.user-id=
root.status= 默认ACTIVE
root.nickname= 默认使用username
root.locale= 默认使用Locale.getDefault()
root.zone-id= 默认使用ZoneId.systemDefault()
root.passsalt= 默认空
root.expired= 默认使用LocalDateTime.MAX

wings.warlock.security.mem-auth

Map<String, Ma>，内存用户权限，key授权说明，重复时覆盖，建议以类型和用途命名。

以boot-admin举例，注意，仅是举例，并非真实默认值。

boot-admin.user-id=
boot-admin.username=
boot-admin.auth-type=
boot-admin.auth-role=
boot-admin.auth-perm=

4D.9.wings-warlock-urlmap-77.properties

Controller中RequestMapping的URL常量

String=/auth/login-list.{extName}，集成登录默认页，默认返回支持的type列表，需要PathVar {extName}

String=/auth/{authType}/login-page.{extName}，具体验证登录默认页，根据content-type自动返回，需要PathVar {extName} {authType}

String=/auth/login-page.{extName}，具体验证登录默认页，把authType变成RequestParam

测试 wings-trydofor.user-id=79
测试 wings-trydofor.secret=wings-trydofor-secret
测试 wings-trydofor.hosts=localhost 302的主机名，不要使用ipv6
测试 wings-trydofor.scopes=api 区分大小写，逗号分隔

http-status=401
response-body={"success":false,"code":"Client","message":"client error"}

wings.warlock.apiauth.error-signature

签名错误时的应答，支持{code}占位符。

http-status=403
response-body={"success":false,"code":"{code}","message":"{code} error"}

wings.warlock.apiauth.error-unhandled

未知错误时的应答，

http-status=200
response-body={"success":false,"code":"Unknown","message":"unknown error"}

4D.C.wings-warlock-watching-77.properties

对代码进行跟踪，默认-1，表示关闭；0为全开启

controller层由Interceptor实现
service依赖注解 @Watching
jooq层，依赖于listener