¶ 管理用户池配置
更新时间: 2024-10-10 07:28:40
Authing 用户池配置管理模块。
¶ 查询用户池配置
UserPoolManagementClient().detail()
查询用户池配置
¶ 示例
UserPool userPool = managementClient.userpool().detail();
¶ 更新用户池配置
UserPoolManagementClient().update(updates)
更新用户池配置
¶ 参数
updates
<UpdateUserpoolInput>updates.name
<String> 用户池名称updates.logo
<String> 用户池 Logoupdates.domain
<String> 用户池企业应用面板二级域名updates.description
<String> 描述信息updates.emailVerifiedDefault
<Boolean> 设置邮箱默认为已验证状态(用户的emailVerified
字段为true
)。updates.sendWelcomeEmail
<Boolean> 用户注册之后是否发送欢迎邮件updates.registerDisabled
<Boolean> 是否关闭注册,当用户池关闭注册之后,普通用户将无法注册账号,只有管理员能够手动创建账号。updates.allowedOrigins
<String> 安全域配置,安全域(Allowed Origins) 是允许从 JavaScript 向 Authing API 发出请求的 URL(通常与 CORS 一起使用)。 默认情况下,系统会允许你使用所有网址。 如果需要,此字段允许你输入其他来源。 你可以通过逐行分隔多个有效 URL,并在子域级别使用通配符(例如:https://*.sample.com
)。 验证这些 URL 时不考虑查询字符串和哈希信息,如果带上了查询字符串和哈希信息系统会自动忽略整个域名,如果有多条请以换行符分隔。updates.whitelist
<RegisterWhiteListConfigInput> 用户池白名单配置updates.whitelist.phoneEnabled
<Boolean> 是否开启手机号白名单updates.whitelist.emailEnabled
<Boolean> 是否开启邮箱白名单updates.whitelist.usernameEnabled
<Boolean> 是否开启用户名白名单updates.tokenExpiresAfter
<Integer> token 过期时间updates.loginFailCheck
<LoginFailCheckConfigInput> 频繁登录失败限制,开启之后,在规定时间内超过次数后再次登录需要验证码。如果你的业务存在同一区域同一时间段并发登录的场景,请将此检测关闭。updates.loginFailCheck.enabled
<Boolean> 是否开启updates.loginFailCheck.timeInterval
<Integer> 检测周期,单位为秒。updates.loginFailCheck.limit
<Integer> 同一 IP 登录失败次数达到多少次的时候会触发限制条件。updates.frequentRegisterCheck
<FrequentRegisterCheckConfigInput> 频率注册限制,开启之后同一 IP 频繁注册账号时会触发频率限制,需要等一段时间之后才能重新注册。如果你的业务存在同一区域同一时间段并发注册的场景,请将此检测关闭。updates.frequentRegisterCheck.enabled
<Boolean> 是否开启updates.frequentRegisterCheck.timeInterval
<Integer> 检测周期,单位为秒。updates.frequentRegisterCheck.limit
<Integer> 同一个周期内同一 IP 注册次数达到此数目时会触发频率限制。
¶ 示例
UserPool userPool = managementClient
.userpool()
.update(new UpdateUserpoolInput().withDescription("desc"))
.execute();
¶ 获取环境变量列表
UserPoolManagementClient().listEnv()
获取用户池环境变量列表。用户池配置的环境变量可以在 pipeline 场景下使用,详情请见:https://docs.authing.cn/v2/guides/pipeline/env.html
¶ 示例
List<Env> list = managementClient.userpool().listEnv().execute();
¶ 添加环境变量
UserPoolManagementClient().addEnv(key, value)
添加环境变量
¶ 参数
key
<String> 环境变量键value
<Object> 环境变量值
¶ 示例
Env env = managementClient.userpool().addEnv("key", "value").execute();
¶ 删除环境变量
UserPoolManagementClient().removeEnv(key)
删除环境变量
¶ 参数
key
<String> 环境变量的 Key
¶ 示例
managementClient.userpool().removeEnv("key").execute();