6.5.2. 使用脚本创建 JAR 以进行部署


注意

JAR 文件是具有 .jar 扩展名的常规 ZIP 文件。

为了使您的脚本可用于 Red Hat Single Sign-On,您需要将其部署到服务器。因此,您应该创建带有以下结构的 JAR 文件:

META-INF/keycloak-scripts.json

my-script-authenticator.js
my-script-policy.js
my-script-mapper.js
Copy to Clipboard Toggle word wrap

META-INF/keycloak-scripts.json 是一个文件描述符,提供关于您要部署的脚本的元数据信息。这是一个带有以下结构的 JSON 文件:

{
    "authenticators": [
        {
            "name": "My Authenticator",
            "fileName": "my-script-authenticator.js",
            "description": "My Authenticator from a JS file"
        }
    ],
    "policies": [
        {
            "name": "My Policy",
            "fileName": "my-script-policy.js",
            "description": "My Policy from a JS file"
        }
    ],
    "mappers": [
        {
            "name": "My Mapper",
            "fileName": "my-script-mapper.js",
            "description": "My Mapper from a JS file"
        }
    ]
}
Copy to Clipboard Toggle word wrap

此文件应引用您要部署的不同脚本供应商:

  • authenticators

    对于 OpenID Connect 脚本编写器。您可以在同一 JAR 文件中有一个或多个验证器

  • policies

    对于使用 Red Hat Single Sign-On Authorization 服务时的 JavaScript 策略。您可以在同一 JAR 文件中拥有一个或多个策略

  • 映射程序

    对于 OpenID Connect 脚本映射程序。您可以在同一 JAR 文件中有一个或多个映射程序

对于 JAR 文件中的每个脚本文件,您需要在 META-INF/keycloak-scripts.json 中对应条目,将您的脚本文件映射到特定的提供程序类型。为此,您应该为每个条目提供以下属性:

  • name

    用于通过 Red Hat Single Sign-On 管理控制台显示脚本的友好名称。如果没有提供,则会改为使用脚本文件的名称

  • description

    最好描述脚本文件的可选文本

  • fileName

    脚本文件的名称。这个属性 是必需的,应映射到 JAR 中的文件。

Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2026 Red Hat
返回顶部