Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

第 4 章 管理子系统配置

红帽单点登录的低级别配置是通过编辑您的分发中的 standalone.xml、standalone-ha.xml 或 domain.xml 文件来完成。此文件的位置取决于您的 操作模式。

尽管此处可以配置无用设置，但本节将重点介绍 keycloak-server 子系统的配置。无论您使用哪一个配置文件，键cloak -server 子系统的配置都是相同的。

keycloak-server 子系统通常在文件的末尾声明，如下所示： 

<subsystem xmlns="urn:jboss:domain:keycloak-server:1.1">
   <web-context>auth</web-context>
   ...
</subsystem>
Copy to Clipboard Toggle word wrap

请注意，在服务器重新引导之前，此子系统所做的所有更改都无效。

4.1. 配置 SPI 供应商
复制链接

在其他上下文中，会使用该设置在其他上下文中讨论每个配置设置的具体设置。但是，了解用于声明 SPI 提供商设置的格式会很有用。

红帽单点登录是一个高度可扩展的高度模块化系统。有 50 个以上的服务提供商接口(SPI)，您可以交换出每个 SPI 的实现。SPI 的实现称为 提供程序。

SPI 声明中的所有元素都是可选的，但完整的 SPI 声明类似如下： 

<spi name="myspi">
    <default-provider>myprovider</default-provider>
    <provider name="myprovider" enabled="true">
        <properties>
            <property name="foo" value="bar"/>
        </properties>
    </provider>
    <provider name="mysecondprovider" enabled="true">
        <properties>
            <property name="foo" value="foo"/>
        </properties>
    </provider>
</spi>
Copy to Clipboard Toggle word wrap

这里我们为 SPI myspi 定义了两个提供程序。default-provider 列为 myprovider。但是，它最多是 SPI，决定它如何对待这个设置。某些 SPI 允许多个提供程序，有些则不允许。因此，default-provider 可以帮助选择 SPI。

另请注意，每个提供程序定义了自己的一组配置属性。以上两个供应商都有名为 foo 的属性只是一个一致性。

各个属性值的类型由提供程序解释。但是，有一个例外。考虑 eventsStore SPI 的 jpa 供应商： 

<spi name="eventsStore">
    <provider name="jpa" enabled="true">
        <properties>
            <property name="exclude-events" value="[&quot;EVENT1&quot;,
                                                    &quot;EVENT2&quot;]"/>
        </properties>
    </provider>
</spi>
Copy to Clipboard Toggle word wrap

我们看到值开头并以方括号结尾。这意味着该值将作为列表传递到提供程序。在本例中，系统会将提供商传递一个列表，其中有两个元素值 EVENT1 和 EVENT2。要在列表中添加更多值，只需用逗号分隔各个列表元素。不幸的是，您需要用 " 来转义每个列表元素周围的引号。

按照 服务器开发人员指南 中的步骤，了解自定义供应商和提供程序配置的更多详情。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat