1.5. 已弃用的功能
在前面的部分中,一些功能已经作为已弃用。以下小节详细介绍了其他已弃用功能。
1.5.1. RESTEasy util 类已弃用
org.keycloak.common.util.Resteasy
已弃用。您应该使用 org.keycloak.util.KeycloakSessionUtil
获取 KeycloakSession
。
强烈建议您通过在创建自定义提供程序时避免获取 KeycloakSession
。
1.5.2. UserRepresentation
中的属性源已弃用
UserRepresentation
中的 origin
属性已弃用,计划在以后的发行版本中删除。
相反,最好使用 federationLink
属性获取用户链接到的供应商。
1.5.3. keycloak-common
模块中的弃用
在即将推出的 Red Hat build of Keycloak 版本时,以下项目已弃用,且没有替换:
-
org.keycloak.common.util.reflections.Reflections.newInstance(java.lang.Class<T>)
-
org.keycloak.common.util.reflections.Reflections.newInstance (java.lang.Class<?>, java.lang.String)
-
org.keycloak.common.util.reflections.SetAccessiblePrivilegedAction
-
org.keycloak.common.util.reflections.UnSetAccessiblePrivilegedAction
1.5.4. 在 keycloak-services
模块中弃用
类 UserSessionCrossDCManager
已被弃用,计划在以后的 Keycloak 版本中删除。阅读 UserSessionCrossDCManager
Javadoc,以了解要使用的替代方法。
1.5.5. 弃用的帐户 REST 端点用于删除凭证
用于删除用户凭证的账户 REST 端点已弃用。从这个版本开始,帐户控制台不再使用此端点。它被 Delete Credential
application-initiated 替代。
1.5.6. 弃用的 keycloak 登录主题
keycloak
登录主题已弃用,现在使用新的 keycloak.v2
,并将在以后的版本中删除。虽然出于兼容性的原因为新域保留默认值,但强烈建议您将所有 realm 切换为 keycloak.v2
。
1.5.7. 在 PasswordHashProvider 中弃用的方法编码
接口 org.keycloak.credential.hash.PasswordHashProvider
上的方法 String encode (String rawPassword, int iterations)
已被弃用。此方法将在以后的 Red Hat build of Keycloak 版本中删除。
1.5.8. 弃用的主题变量
以下变量在 Admin 主题中被弃用,并将在以后的版本中删除:
-
authServerUrl
.改为使用serverBaseUrl
。 -
authUrl
.改为使用adminBaseUrl
。
以下变量在帐户主题中被弃用,并将在以后的版本中删除:
-
authServerUrl
.使用serverBaseUrl
替代,请注意serverBaseUrl
不包含尾部斜杠。 -
authUrl
.使用serverBaseUrl
替代,请注意serverBaseUrl
不包含尾部斜杠。
1.5.9. 在客户端会话中获取和设置当前刷新令牌的方法现已弃用
String getCurrentRefreshToken ()
, void setCurrentRefreshToken (String currentRefreshToken)
, int getCurrentRefreshTokenUseCount ()
, 和 void setCurrentRefreshTokenUseCount (int currentRefreshTokenUseCount)
在接口 org.keycloak.models.AuthenticatedClientSessionModel
中已被弃用。它们已被类似的方法替代,它需要一个标识符作为参数,如 getRefreshToken (String reuseId)
,以在客户端会话中管理多个刷新令牌。在以后的 Red Hat build of Keycloak 版本中会删除方法。