Keycloak使用自定义协议映射器从数据库/外部源添加额外声明

Question

我已经看到了这两篇文章，它们给出了这个问题的解决方案，但对于像我这样的非Java开发人员来说，它们没有提供足够详细的信息：

Keycloak从数据库/外部源添加额外声明

如何在KeyCloak中注册自定义ProtocolMapper？

null

实现ProtocolMapper接口并添加包含类引用的文件“Meta-INF/Services/org.keycloak.protocol.ProtocolMapper”。

此时，Keycloak识别新的实现。您应该能够通过管理控制台配置它。

要向令牌添加一些数据，请添加以下接口

<?xml version="1.0" encoding="UTF-8"?>
<jboss-deployment-structure>
    <deployment>
        <dependencies>
            <module name="org.keycloak.keycloak-services"/>
        </dependencies>
    </deployment>
</jboss-deployment-structure>

在完成所有这些操作之后，每个请求都会调用自定义transformAccessToken（）方法，其URL为http://://auth/realms/testrealm/protocol/openid-connect/token

读完这篇文章后，我有几个问题：

1. 如何“实现ProtocolMapper”
2. 您在哪里添加前面提到的文件？（在我的Keycloak安装文件夹中看不到任何META-INF/目录）
3. 如何以及在何处“添加下列接口”
4. 自定义transformAccessToken()看起来像什么

编辑2这里描述的一个方法可以做到这一点，但缺乏细节。Keycloak创建自定义标识提供程序映射器

Answer 1

我希望这一步一步指南对你有所帮助

我使用的是Keycloak 4.5.0--因为我安装了这个较新的版本--但我应该不会有太大的不同。我在示例中实现了OIDCProtocolMapper。

只是为了总结一下--为其他人提供快速概述--后面将更详细地描述每个步骤

我上传了我的html" target="_blank">mavenpom.xml(pom)--只需将其导入IDE中，所有的依赖项都将自动加载。这些依赖项只是提供的，稍后将在运行时直接从keycloak中使用

与此相关的是keycloak.version属性-所有keycloak依赖项当前都加载在版本4.5.0中。final

现在，我创建了一个名为CustomoIDCProtocolMapper的自定义协议映射器类。在这里找到“完整”代码

服务文件对于keycloak查找自定义实现非常重要

将文件名为org.keycloak.protocol.protocolmapper的文件放置在\src\main\resources\meta-inf\services\中

在这个文件中，您可以写入自定义提供者的名称--因此keycloak知道这个类可以作为协议映射器使用
在我的示例中，文件内容只有一行

com.stackoverflow.keycloak.custom.CustomOIDCProtocolMapper

<jboss-deployment-structure>
    <deployment>
        <dependencies>
            <module name="org.keycloak.keycloak-services" />
        </dependencies>
    </deployment>
</jboss-deployment-structure>

现在可以使用映射器了--在我的示例中，我可以在keycloak管理ui中创建映射器，并从下拉菜单中选择StackOverflow Custom Protocol mapper

就像信息一样--这不是keycloak完全官方支持的--所以界面可能会在以后的版本中发生变化

我希望这是可以理解的，并且您将能够成功地实现您自己的映射器