认证与权限安全

属性配置文件身份认证提供者 (vertx-auth-properties)

该认证提供者实现从属性文件(Properties)中读取用户、角色与权限配置,其文件格式完全兼容 Apache Shiro Properties Realm。

请注意,本组件不依赖 Apache Shiro 框架,而是由 Vert.x 独立提供的针对该标准格式的轻量级纯响应式实现。

属性文件结构遵循如下规范:

每一行既可以定义单个用户的用户名、密码及所属角色列表,也可以定义某个角色所包含的权限列表。

对于用户配置行,其标准语法为:

user.{username}={password},{roleName1},{roleName2},...,{roleNameN}

对于角色配置行,其标准语法为:

role.{roleName}={permissionName1},{permissionName2},...,{permissionNameN}

示例如下:

user.tim = mypassword,administrator,developer
user.bob = hispassword,developer
user.joe = anotherpassword,manager
role.administrator=*
role.manager=play_golf,say_buzzwords
role.developer=do_actual_work

在定义角色权限时,通配符 * 表示该角色拥有全部操作权限。

当前实现默认采用标准的用户名 / 密码认证方式。