2.9. Keycloak JS

Keycloak JS 库不再由红帽构建的 Keycloak 服务器静态提供。这意味着以下 URL 不再可用：

另外，链接到这些 URL 上库的 keycloakJsUrl 属性已从 Admin Console 主题中删除。如果您的自定义主题使用此属性包含库，您应该更新主题以使用不同的方法包含库。

现在，您应该使用软件包管理器（如 NPM ）在项目中包含该库。该程序库在 NPM 注册表上作为 keycloak-js 提供。您可以使用以下命令安装它：

npm install keycloak-js

或者，服务器的分发还包括 keycloak-js-26.0.0.tgz 存档中的库副本。您可以将库从那里复制到您的项目。如果您在没有构建的情况下直接在浏览器中使用库，则需要自己托管该库。软件包管理器仍然是建议将库包含在项目中，因为它将在以后更轻松地更新库。

在以前的版本中，可以在不传递任何配置的情况下构建 Keycloak 实例。然后，根据包含的 keycloak.js 脚本的路径，从 keycloak.json 文件中自动从服务器加载配置。因为库不再从服务器静态提供，所以这个功能已被删除。现在，在构造 Keycloak 实例时需要显式传递配置：

// Before
const keycloak = new Keycloak();

// After
const keycloak = new Keycloak({
    url: "http://keycloak-server",
    realm: "my-realm",
    clientId: "my-app"
});

// Alternatively, you can pass a URL to a `keycloak.json` file.
// Note this is not reccomended as it creates additional network requests, and is prone to change in the future.
const keycloak = new Keycloak('http://keycloak-server/path/to/keycloak.json');

Keycloak JS 现在使用 Web Crypto API 来计算支持 PKCE 所需的 SHA-256 摘要。由于此 API 的异步性质，以下公共方法现在始终返回 Promise ：

确保将代码更新为 等待 这些方法：

// Before
keycloak.login();
const loginUrl = keycloak.createLoginUrl();
const registerUrl = keycloak.createRegisterUrl();

// After
await keycloak.login();
const loginUrl = await keycloak.createLoginUrl();
const registerUrl = await keycloak.createRegisterUrl();

确保将您的代码更新为 等待 这些方法。

当提供的构建时选项在启动时与在最近优化的 Keycloak 构建过程中在服务器镜像中保留的值不同时，红帽构建的 Keycloak 现在将无法启动。在以前的版本中，在这种情况下会显示警告信息。

名为 basic 的新客户端范围被添加为 realm "default" 客户端范围，因此将添加到所有新创建的客户端。客户端范围还在迁移过程中自动添加到所有现有客户端。

此范围包含以下声明的预配置的协议映射器：

这提供了额外的帮助来减少轻量级访问令牌中的声明数量，但也有机会配置始终自动添加的声明。