kiceurope/wallet

EDCI Wallet Docker镜像文档

镜像概述和主要用途

EDCI Wallet是一个无状态REST API服务（eu.europa.ec.empl.edci.dss.service），主要用于接收、存储和提供凭证。它还能验证凭证或可验证展示的签名与格式，并创建和管理这些凭证或可验证展示的临时共享链接。该镜像将EDCI Wallet部署在Tomcat服务器上，默认使用8080端口。

核心功能和特性

• 无状态REST API架构：提供轻量级、可扩展的服务接口
• 凭证管理：支持凭证的接收、存储和查询服务
• 签名与格式验证：验证凭证或可验证展示的签名有效性和格式正确性
• 临时共享链接：创建和管理凭证的临时共享链接
• 可配置性：通过属性文件进行配置，支持自定义设置
• 调试支持：通过JPDA环境变量启用调试功能
• 依赖等待机制：支持等待其他服务（如数据库）启动后再启动

使用场景和适用范围

• 数字凭证管理系统
• 需要验证数字凭证有效性的应用
• 构建EDCI生态系统（与EDCI Issuer、EDCI Viewer等组件配合使用）
• 企业或组织内部的凭证存储与共享服务

详细使用方法和配置说明

启动EDCI Wallet

EDCI Wallet部署在Tomcat服务器上，默认使用8080端口。最基本的启动命令如下：

bash
docker run -p 8080:8080 docker.xuanyuan.run/kiceurope/wallet

此命令将使用默认的本地主机配置启动容器。如需修改配置，需创建配置文件的卷挂载。

卷和配置

EDCI Wallet的配置存储在一系列属性文件中，修改配置后需重启Web应用。默认配置目录为$CATALINA_HOME/conf/edci/wallet，永久修改配置的方式有两种：

1. 基于kiceurope/wallet构建自定义镜像
2. 挂载配置文件夹的卷

容器启动后会将默认配置复制到配置目录，除非目录中已存在配置文件。因此，最佳实践是挂载配置卷，修改配置后重启容器。

另一个有用的卷是Tomcat的日志目录$CATALINA_HOME/logs，挂载后可持久化日志。

同时挂载配置和日志卷的启动命令示例：

bash
docker run -p 8080:8080 -v /opt/wallet:/usr/local/tomcat/wallet -v /opt/logs:/usr/local/tomcat/logs docker.xuanyuan.run/kiceurope/wallet

环境变量

以下可选环境变量用于启用JPDA调试和等待依赖主机：

外部依赖

EDCI Wallet需要以下外部依赖：

1. EDCI Wallet配置实例：用于检索和验证存储的凭证
2. OIDC身份提供商：推荐使用https://www.keycloak.org/%EF%BC%8CEDCI Wallet和相关系统需配置相同的身份提供商
3. Weasyprint服务器：需在wallet.properties中配置，以启用导出功能

OIDC提供商需使用正确的主机名。若在Docker内部运行身份提供商，可使用host.docker.internal URL指向身份提供商。

EDCI生态系统

EDCI生态系统由EDCI Issuer、EDCI Wallet和EDCI Viewer组成，还需要数据库和身份提供商以实现完整功能。建议使用docker-compose管理容器间通信。

完整的docker-compose示例：

yaml
version: "3.0"
services:
  mysqldb:
    image: docker.xuanyuan.run/kiceurope/mysqldb
    container_name: mysqldb
    build: configuration/docker/mysql/
    environment:
      - MYSQL_ROOT_PASSWORD=changeMe
      - MYSQL_USER=edci
      - MYSQL_PASSWORD=changeMe
    volumes:
      - "C://Dev/EDCI/dockers/docker_mysql/datadir:/var/lib/mysql"
    ports:
      - 3307:3306
      - 33060:33060
    healthcheck:
      test: ["CMD-SHELL", 'mysqladmin ping']
      timeout: 5s
      retries: 6
  keycloak:
    image: ***-quay.xuanyuan.run/keycloak/keycloak
    container_name: keycloak
    command: start-dev
    environment:
      - KEYCLOAK_ADMIN=admin
      - KEYCLOAK_ADMIN_PASSWORD=changeMe
      - KC_DB=mysql
      - KC_DB_URL=jdbc:mysql://mysqldb:3306/keycloak
      - KC_DB_USERNAME=keycloak
      - KC_DB_PASSWORD=changeMe
      - KC_FEATURES=token-exchange,admin-fine-grained-authz
    ports:
      - "9000:8080"
    depends_on:
      mysqldb:
        condition: service_healthy
  issuer:
    image: docker.xuanyuan.run/kiceurope/issuer
    container_name: issuer
    user: edci
    build: edci-issuer/
    environment:
      - JPDA_ENABLED=true
      - JPDA_TRANSPORT=dt_socket
      - JPDA_ADDRESS=8000
      - WAIT_FOR_HOST=mysqldb
      - WAIT_FOR_PORT=3306
      - WAIT_FOR_TIMEOUT=60
    volumes:
      - "C://Dev/EDCI/dockers/docker_issuer/issuer:/usr/local/tomcat/conf/edci/issuer"
      - "C://Dev/EDCI/dockers/docker_issuer/credentials:/usr/local/tomcat/temp/credentials"
      - "C://Dev/EDCI/dockers/docker_issuer/logs:/usr/local/tomcat/logs"
    ports:
      - "8383:8080"
      - "9383:8000"
    depends_on:
      mysqldb:
        condition: service_healthy
  wallet:
    image: docker.xuanyuan.run/kiceurope/wallet
    container_name: wallet
    user: edci
    build: edci-wallet/
    environment:
      - JPDA_ENABLED=true
      - JPDA_TRANSPORT=dt_socket
      - JPDA_ADDRESS=8000
      - WAIT_FOR_HOST=mysqldb
      - WAIT_FOR_PORT=3306
      - WAIT_FOR_TIMEOUT=60
    volumes:
      - "C://Dev/EDCI/dockers/docker_wallet/wallet:/usr/local/tomcat/conf/edci/wallet"
      - "C://Dev/EDCI/dockers/docker_wallet/logs:/usr/local/tomcat/logs"
    ports:
      - "8181:8080"
      - "9181:8000"
    depends_on:
      mysqldb:
        condition: service_healthy
  viewer:
    image: docker.xuanyuan.run/kiceurope/viewer
    container_name: viewer
    user: edci
    build: edci-viewer/
    environment:
      - JPDA_ENABLED=true
      - JPDA_TRANSPORT=dt_socket
      - JPDA_ADDRESS=8000
      - WAIT_FOR_HOST=mysqldb
      - WAIT_FOR_PORT=3306
      - WAIT_FOR_TIMEOUT=60
    volumes:
      - "C://Dev/EDCI/dockers/docker_viewer/viewer:/usr/local/tomcat/conf/edci/viewer"
      - "C://Dev/EDCI/dockers/docker_viewer/logs:/usr/local/tomcat/logs"
    ports:
      - "8282:8080"
      - "9282:8000"
    depends_on:
      mysqldb:
        condition: service_healthy

注意：

• 所有EDCI容器均安装了wait-for-it脚本，可通过WAIT_FOR_*环境变量等待依赖服务
• Keycloak需启用token-exchange和admin-fine-grained-authz特性，以支持Viewer和Wallet的交互
• 容器间内部调用使用服务名（如issuer/wallet/viewer），Keycloak需通过host.docker.internal或正确域名访问

安装后操作

首次启动EDCI生态系统时，各应用和依赖的数据库用户使用默认密码（如示例中的changeMe）。强烈建议：

1. 通过CLI或数据库管理工具修改数据库中的默认密码
2. 更新docker-compose文件中的密码配置