fiware/keypass

FIWARE-KeyPass

https://nexus.lab.fiware.org/static/badges/chapters/security.svg](https://www.fiware.org/developers/catalogue/) XACML服务器

https://img.shields.io/github/license/telefonicaid/fiware-keypass.svg](https://opensource.org/licenses/Apache-2.0) https://img.shields.io/badge/quay.io-fiware%2Fkeyspass-grey?logo=red%20hat&labelColor=EE0000](https://quay.io/repository/fiware/keyspass) !https://nexus.lab.fiware.org/static/badges/statuses/incubating.svg

镜像概述

FIWARE-KeyPass是一款多租户的XACML（可扩展访问控制标记语言）服务器，集成策略管理点（PAP）和策略决策点（PDP）功能。基于Balana（XACML v2/v3完整实现）与Dropwizard（高性能REST框架）开发，用于实现访问控制策略的定义、管理和评估，适用于多租户场景下的权限管控。

核心功能

1. 多租户隔离：为不同租户提供独立的策略空间，保障数据与策略的安全性。
2. 策略管理（PAP）：支持XACML策略的创建、查询、更新与删除操作。
3. 策略决策（PDP）：接收XACML请求并返回授权决策（允许/拒绝等）。
4. 规范兼容：完全支持XACML v2和v3标准规范。
5. RESTful API：提供标准化接口，便于与其他系统集成。

使用场景

• 物联网平台：对设备、服务的访问权限进行细粒度控制。
• 企业应用：管理内部系统的用户角色与资源访问策略。
• 多租户服务：为SaaS平台的不同租户提供独立权限管理能力。
• API网关：作为权限决策组件，实现API请求的访问控制。

配置说明

Docker部署示例

基础运行

bash
docker run -d -p 8080:8080 fiware/keypass

挂载自定义配置

使用自定义config.yml配置文件：

bash
docker run -d -p 8080:8080 \
  -v /path/to/your/config.yml:/opt/keypass/conf/config.yml \
  fiware/keypass server /opt/keypass/conf/config.yml

Docker Compose示例

yaml
version: '3'
services:
  keypass:
    image: fiware/keypass
    ports:
      - "8080:8080"
    volumes:
      - ./config.yml:/opt/keypass/conf/config.yml
    command: server /opt/keypass/conf/config.yml

基本操作示例

创建策略

bash
curl -i -H "Accept: application/xml" -H "Content-type: application/xml" \
  -H "Fiware-Service: myTenant" \
  -X POST -d @policy01.xml \
  http://localhost:8080/pap/v1/subject/role12345

评估策略请求

bash
curl -i -H "Accept: application/xml" -H "Content-type: application/xml" \
  -H "Fiware-Service: myTenant" \
  -X POST -d @policy01_request01.xml \
  http://localhost:8080/pdp/v3