9.2. 声明信息点

声明信息点(CIP)负责解析声明并将这些声明推送到红帽 Keycloak 服务器，以提供有关策略访问上下文的更多信息。它们可以定义为 policy-enforcer 的配置选项，以便从不同的源解析声明，例如：

HTTP 请求（参数、标头、正文等）
外部 HTTP 服务
配置中定义的静态值
通过实施 Claim Information Provider SPI 的任何其他源

将声明推送到红帽 Keycloak 服务器构建时，策略不仅可以基于用户是谁，还可以考虑上下文和内容，具体根据谁、原因、何时、位置以及给定交易而考虑。它都关于基于上下文的授权，以及如何使用运行时信息来支持精细的授权决策。

9.2.4. 声明信息供应商 SPI
复制链接

当任何内置供应商都不足以解决其要求时，开发人员可以使用 Claim Information Provider SPI 支持不同的声明信息点。

例如，要实施一个新的 CIP 提供程序，您需要在应用的 classpath 中实施 org.keycloak.adapters.authorization.ClaimInformationPointProviderFactory 和 ClaimInformationPointProvider Factory，并提供文件 META-INF/services/org.keycloak.adapters.authorization.ClaimInformationPointProviderFactory。

org.keycloak.adapters.authorization.ClaimInformationPointProviderFactory 示例：

public class MyClaimInformationPointProviderFactory implements ClaimInformationPointProviderFactory<MyClaimInformationPointProvider> {

    @Override
    public String getName() {
        return "my-claims";
    }

    @Override
    public void init(PolicyEnforcer policyEnforcer) {

    }

    @Override
    public MyClaimInformationPointProvider create(Map<String, Object> config) {
        return new MyClaimInformationPointProvider(config);
    }
}

public class MyClaimInformationPointProviderFactory implements ClaimInformationPointProviderFactory<MyClaimInformationPointProvider> {

    @Override
    public String getName() {
        return "my-claims";
    }

    @Override
    public void init(PolicyEnforcer policyEnforcer) {

    }

    @Override
    public MyClaimInformationPointProvider create(Map<String, Object> config) {
        return new MyClaimInformationPointProvider(config);
    }
}

Copy to Clipboard

Toggle word wrap

每个 CIP 提供程序都必须与名称关联，如 MyClaimInformationPointProviderFactory.getName 方法中定义的。名称将用于从 policy-enforcer 配置中的 claim-information-point 部分映射到实现。

在处理请求时，策略 enforcer 将调用 MyClaimInformationPointProviderFactory.create 方法，以获取 MyClaimInformationPointProvider 的实例。调用时，为此特定 CIP 提供程序定义的任何配置（通过 claim-information-point）作为映射传递。

ClaimInformationPointProvider 示例：

public class MyClaimInformationPointProvider implements ClaimInformationPointProvider {

    private final Map<String, Object> config;

    public MyClaimInformationPointProvider(Map<String, Object> config) {
        this.config = config;
    }

    @Override
    public Map<String, List<String>> resolve(HttpFacade httpFacade) {
        Map<String, List<String>> claims = new HashMap<>();

        // put whatever claim you want into the map

        return claims;
    }
}

public class MyClaimInformationPointProvider implements ClaimInformationPointProvider {

    private final Map<String, Object> config;

    public MyClaimInformationPointProvider(Map<String, Object> config) {
        this.config = config;
    }

    @Override
    public Map<String, List<String>> resolve(HttpFacade httpFacade) {
        Map<String, List<String>> claims = new HashMap<>();

        // put whatever claim you want into the map

        return claims;
    }
}

Copy to Clipboard

Toggle word wrap

9.2. 声明信息点

9.2.1. 从 HTTP 请求获取信息
复制链接

9.2.2. 从外部 HTTP 服务获取信息
复制链接

9.2.3. 静态声明
复制链接

9.2.4. 声明信息供应商 SPI
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

9.2. 声明信息点

9.2.1. 从 HTTP 请求获取信息复制链接链接已复制到粘贴板!

9.2.2. 从外部 HTTP 服务获取信息复制链接链接已复制到粘贴板!

9.2.3. 静态声明复制链接链接已复制到粘贴板!

9.2.4. 声明信息供应商 SPI复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

9.2.1. 从 HTTP 请求获取信息
复制链接

9.2.2. 从外部 HTTP 服务获取信息
复制链接

9.2.3. 静态声明
复制链接

9.2.4. 声明信息供应商 SPI
复制链接