22.23. required-action


22.23.1. CONFIGURE_RECOVERY_AUTHN_CODES

Expand
 value

spi-required-action--CONFIGURE_RECOVERY_AUTHN_CODES--max_auth_age

在需要用户重新验证前,在最后一次验证后配置此操作的时间(以秒为单位)。

当请求中有 kc_action 参数时,此参数仅在 AIA 上下文中使用,当用户自己在帐户控制台中更新其密码时,该参数适用于实例。

CLI: --spi-required-action-CONFIGURE_RECOVERY_AUTHN_CODES--max_auth_age
Env: KC_SPI_REQUIRED_ACTION__CONFIGURE_RECOVERY_AUTHN_CODES_MAX_AUTH_AGE

300 (默认)或 任何字符串

spi-required-action--CONFIGURE_RECOVERY_AUTHN_CODES--warning_threshold

当用户在帐户上有剩余的恢复代码比此处配置的值小时,帐户控制台会显示警告用户,这会建议他设置新的恢复代码。

CLI: --spi-required-action-CONFIGURE_RECOVERY_AUTHN_CODES--warning_threshold
Env: KC_SPI_REQUIRED_ACTION__CONFIGURE_RECOVERY_AUTHN_CODES_WARNING_THRESHOLD

4 (默认)或任何 整数

22.23.2. CONFIGURE_TOTP

Expand
 value

spi-required-action--CONFIGURE_TOTP--add-recovery-codes

如果启用了这个选项,则需要用户在 OTP 配置后配置恢复代码。

如果用户已经配置了恢复代码,则 Keycloak 不会要求设置它们。作为先决条件,启用恢复代码所需的操作并在身份验证流中启用恢复代码。

CLI: --spi-required-action-CONFIGURE_TOTP--add-recovery-codes
Env: KC_SPI_REQUIRED_ACTION__CONFIGURE_TOTP__ADD_RECOVERY_CODES

true,false (默认)

spi-required-action--CONFIGURE_TOTP--max_auth_age

在需要用户重新验证前,在最后一次验证后配置此操作的时间(以秒为单位)。

当请求中有 kc_action 参数时,此参数仅在 AIA 上下文中使用,当用户自己在帐户控制台中更新其密码时,该参数适用于实例。

CLI: --spi-required-action-CONFIGURE_TOTP--max_auth_age
Env: KC_SPI_REQUIRED_ACTION__CONFIGURE_TOTP__MAX_AUTH_AGE

300 (默认)或 任何字符串

22.23.3. TERMS_AND_CONDITIONS

Expand
 value

spi-required-action--TERMS_AND_CONDITIONS--max_auth_age

在需要用户重新验证前,在最后一次验证后配置此操作的时间(以秒为单位)。

当请求中有 kc_action 参数时,此参数仅在 AIA 上下文中使用,当用户自己在帐户控制台中更新其密码时,该参数适用于实例。

CLI: --spi-required-action--TERMS_AND_CONDITIONS--max_auth_age
Env: KC_SPI_REQUIRED_ACTION__TERMS_AND_CONDITIONS__MAX_AUTH_AGE

300 (默认)或 任何字符串

22.23.4. UPDATE_EMAIL

Expand
 value

spi-required-action--UPDATE_EMAIL--verify-email

如果启用,则无论域级别是否启用了电子邮件验证,将强制用户验证电子邮件。

否则,验证将基于 realm 级别设置。

CLI: --spi-required-action--UPDATE_EMAIL-verify-email
Env: KC_SPI_REQUIRED_ACTION__UPDATE_EMAIL__VERIFY_EMAIL

true,false (默认)

22.23.5. UPDATE_PASSWORD

Expand
 value

spi-required-action--UPDATE_PASSWORD--max_auth_age

在需要用户重新验证前,在最后一次验证后配置此操作的时间(以秒为单位)。

当请求中有 kc_action 参数时,此参数仅在 AIA 上下文中使用,当用户自己在帐户控制台中更新其密码时,该参数适用于实例。

CLI: --spi-required-action--UPDATE_PASSWORD--max_auth_age
Env: KC_SPI_REQUIRED_ACTION__UPDATE_PASSWORD__MAX_AUTH_AGE

300 (默认)或 任何字符串

22.23.6. UPDATE_PROFILE

Expand
 value

spi-required-action--UPDATE_PROFILE--max_auth_age

在需要用户重新验证前,在最后一次验证后配置此操作的时间(以秒为单位)。

当请求中有 kc_action 参数时,此参数仅在 AIA 上下文中使用,当用户自己在帐户控制台中更新其密码时,该参数适用于实例。

CLI: --spi-required-action--UPDATE_PROFILE--max_auth_age
Env: KC_SPI_REQUIRED_ACTION__UPDATE_PROFILE__MAX_AUTH_AGE

300 (默认)或 任何字符串

22.23.7. VERIFY_EMAIL

Expand
 value

spi-required-action--VERIFY_EMAIL--email-resend-cooldown-seconds

发送另一电子邮件验证电子邮件前的最短延迟(以秒为单位)。

CLI: --spi-required-action--VERIFY_EMAIL-email-resend-cooldown-seconds
Env: KC_SPI_REQUIRED_ACTION__VERIFY_EMAIL__EMAIL_RESEND_COOLDOWN_SECONDS

30 (默认)或 任何字符串

spi-required-action--VERIFY_EMAIL--max_auth_age

在需要用户重新验证前,在最后一次验证后配置此操作的时间(以秒为单位)。

当请求中有 kc_action 参数时,此参数仅在 AIA 上下文中使用,当用户自己在帐户控制台中更新其密码时,该参数适用于实例。

CLI: --spi-required-action-VERIFY_EMAIL-max_auth_age
Env: KC_SPI_REQUIRED_ACTION__VERIFY_EMAIL_max_MAX_AUTH_AGE

300 (默认)或 任何字符串

22.23.8. VERIFY_PROFILE

Expand
 value

spi-required-action--VERIFY_PROFILE--max_auth_age

在需要用户重新验证前,在最后一次验证后配置此操作的时间(以秒为单位)。

当请求中有 kc_action 参数时,此参数仅在 AIA 上下文中使用,当用户自己在帐户控制台中更新其密码时,该参数适用于实例。

CLI: --spi-required-action--VERIFY_PROFILE--max_auth_age
Env: KC_SPI_REQUIRED_ACTION__VERIFY_PROFILE__MAX_AUTH_AGE

300 (默认)或 任何字符串

22.23.9. delete_credential

Expand
 value

spi-required-action--delete_credential--max_auth_age

在需要用户重新验证前,在最后一次验证后配置此操作的时间(以秒为单位)。

当请求中有 kc_action 参数时,此参数仅在 AIA 上下文中使用,当用户自己在帐户控制台中更新其密码时,该参数适用于实例。

CLI: --spi-required-action--delete_credential--max_auth_age
Env: KC_SPI_REQUIRED_ACTION__DELETE_CREDENTIAL__MAX_AUTH_AGE

300 (默认)或 任何字符串

22.23.11. update_user_locale

Expand
 value

spi-required-action--update_user_locale--max_auth_age

在需要用户重新验证前,在最后一次验证后配置此操作的时间(以秒为单位)。

当请求中有 kc_action 参数时,此参数仅在 AIA 上下文中使用,当用户自己在帐户控制台中更新其密码时,该参数适用于实例。

CLI: --spi-required-action--update_user_locale--max_auth_age
Env: KC_SPI_REQUIRED_ACTION__UPDATE_USER_LOCALE_MAX_AUTH_AGE

300 (默认)或 任何字符串

22.23.12. webauthn-register

Expand
 value

spi-required-action--webauthn-register--max_auth_age

在需要用户重新验证前,在最后一次验证后配置此操作的时间(以秒为单位)。

当请求中有 kc_action 参数时,此参数仅在 AIA 上下文中使用,当用户自己在帐户控制台中更新其密码时,该参数适用于实例。

CLI: --spi-required-action--webauthn-register--max_auth_age
Env: KC_SPI_REQUIRED_ACTION__WEBAUTHN_REGISTER__MAX_AUTH_AGE

300 (默认)或 任何字符串

22.23.13. webauthn-register-passwordless

Expand
 value

spi-required-action--webauthn-register-passwordless--max_auth_age

在需要用户重新验证前,在最后一次验证后配置此操作的时间(以秒为单位)。

当请求中有 kc_action 参数时,此参数仅在 AIA 上下文中使用,当用户自己在帐户控制台中更新其密码时,该参数适用于实例。

CLI: --spi-required-action--webauthn-register-passwordless--max_auth_age
Env: KC_SPI_REQUIRED_ACTION__WEBAUTHN_REGISTER_PASSWORDLESS_MAX_AUTH_AGE

300 (默认)或 任何字符串

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat