checkboxinua/agentsign

Checkbox AgentSign 镜像文档

镜像概述

Checkbox AgentSign 是一个专为乌克兰财政化系统设计的签名代理 Docker 镜像。它实现了对国家密码算法的支持，用于处理电子数字签名（ЕЦП），并在创建财政收据时自动签署交易数据（提交给国家税务局的数据），从而免去手动逐一签署收据的繁琐过程。

核心功能与特性

• 自动签名：在生成财政收据时自动完成交易数据的数字签名。
• 国家算法支持：全面支持乌克兰国家密码算法标准。
• 安全密钥管理：支持通过 Docker Volume 挂载密钥，并提供基于文件的密码读取方式，保障生产环境安全。
• 灵活配置：支持自定义认证中心（CA）的 OCSP、CMP 和 TSP 参数，适配不同的证书颁发机构。

使用场景和适用范围

• 零售、餐饮等需要开具财政收据的线下或线上收银系统。
• 需要与 Checkbox 财政化 API 集成并实现自动化电子签名的企业级应用。
• 需符合乌克兰税务局（ДПС）合规要求的自动化交易处理场景。

详细的使用方法和配置说明

环境变量配置

注：认证中心参数可通过 乌克兰司法部 CA 列表 获取。

密钥与密码文件准备

1. 准备密钥文件（如 Key-6.dat）。
2. 创建无换行符和空格的密码文件：

   bash
   printf "your_secret_password" > password.txt
   

3. 将密钥文件和密码文件放入本地安全目录（如 ./secure）。

Docker CLI 部署示例

1. 拉取镜像

   bash
   docker pull checkboxinua/agentsign:latest
   

2. 运行容器 通过 -v 参数将本地密钥目录挂载到容器内：

   bash
   docker run -d \
     --name agentsign \
     -v ./secure:/secure:ro \
     -e SIGNER_API_URL="https://api.checkbox.in.ua" \
     -e CASHIER_LOGIN="my-cashier-001" \
     -e SIGNER_KEY_PATH="/secure/Key-6.dat" \
     -e SIGNER_PASSWORD_FILE="/secure/password.txt" \
     -e SIGNER_CA_OCSP="ca.informjust.ua/services/ocsp/" \
     -e SIGNER_CA_CMP="ca.informjust.ua" \
     -e SIGNER_CA_TSP="ca.informjust.ua" \
     checkboxinua/agentsign:latest
   

3. 停止容器

   bash
   docker stop agentsign
   

Docker Compose 部署示例

使用 Docker Compose 可以大幅简化配置管理。

1. 创建 docker-compose.yml 文件

   yaml
   version: '3.7' 
   
   services: 
     signer:
       image: checkboxinua/agentsign:latest
       container_name: agentsign
       restart: always
       volumes:
         - ./secure:/secure/:ro
       environment:
         SIGNER_API_URL: https://api.checkbox.in.ua
         CASHIER_LOGIN: my-cashier-001
         SIGNER_KEY_PATH: /secure/Key-6.dat
         SIGNER_PASSWORD_FILE: /secure/password.txt
         SIGNER_CA_OCSP: ca.informjust.ua/services/ocsp/
         SIGNER_CA_CMP: ca.informjust.ua
         SIGNER_CA_TSP: ca.informjust.ua
   

   此示例使用了乌克兰司法部认证中心的密钥配置，请根据实际情况修改环境变量。

2. 常用管理命令

   • 拉取镜像：docker-compose pull
   • 后台启动：docker-compose up -d
   • 查看日志：docker-compose logs -f
   • 停止服务：docker-compose stop
   • 停止并移除容器：docker-compose down