那执行器改成http,支付系统指定http调用和https调用,如果https,使用nginx转发,提供nginx配置文件。
This commit is contained in:
1 parent
ee9b209e3d
commit
cf68147d08
7 files changed
+60
-50
No files matched your search
+18
-9
@@ -8,7 +8,7 @@
|
||||
|
||||
支付后端 `CHAIN_EXECUTOR_ENABLED` 默认 `false`,此时直接执行原密码代码,既不访问内网服务,也不依赖新增表。
|
||||
|
||||
启用后,支付后端启动时先调用 `GET /internal/v1/connectivity` 验证 TLS、来源白名单和服务令牌,
|
||||
启用后,支付后端启动时先调用 `GET /internal/v1/connectivity` 验证传输链路、来源白名单和服务令牌,
|
||||
再调用 `GET /internal/v1/readiness` 验证数据库钱包网络和配置密码。两项必须同时通过,否则支付后端拒绝启动并输出受控诊断日志。
|
||||
启用后,用户输入密码时本地执行,未输入密码时仅允许交给已就绪的内网服务。两种方式共用执行记录和受控交易构造,
|
||||
执行前实时校验余额、资源和链上费率。`RESOURCE_ONLY` 缺口拒绝;`DIRECT` 检查燃烧预算及全局 `trx_num` 保留量。
|
||||
@@ -19,7 +19,7 @@
|
||||
1. 备份并执行 `sql/chain_executor.sql`,只新增执行记录表,不重建原表。
|
||||
2. 使用 JDK 8 构建:`mvn -pl usdt-chain-executor -am package -DskipTests`。
|
||||
3. 给独立执行器配置下表环境变量,再启动 `java -jar usdt-chain-executor/target/usdt-chain-executor-3.4.0.jar`。
|
||||
4. 验证监听地址、来源白名单、TLS 和服务认证后,再配置支付后端环境变量并部署前端。
|
||||
4. 验证监听地址、来源白名单和服务认证;HTTPS 部署还需验证 Nginx 与证书,再配置支付后端。
|
||||
5. 首次在 NILE 验证。没有执行过真实交易的构建/隔离测试不能替代实际部署验收。
|
||||
|
||||
禁止把真实配置密码写在脚本、命令行参数、Git 文件或支付后端配置中。通过进程管理器的受控环境注入。
|
||||
@@ -29,7 +29,7 @@
|
||||
| 变量 | 含义 |
|
||||
| --- | --- |
|
||||
| `CHAIN_EXECUTOR_BIND_ADDRESS` | 必填,本机明确 IPv4;只接受 `10/8`、`172.16/12`、`192.168/16` 或 `127/8` |
|
||||
| `CHAIN_EXECUTOR_PORT` | 必填,独立监听端口,例如 `9088` |
|
||||
| `CHAIN_EXECUTOR_PORT` | 必填,HTTP 监听端口;Nginx 模式建议使用回环端口 `9089` |
|
||||
| `CHAIN_EXECUTOR_ALLOWED_IPS` | 必填,支付后端实际 TCP 来源 IPv4,逗号分隔,逐个精确匹配;不支持通配/CIDR |
|
||||
| `CHAIN_EXECUTOR_TOKEN` | 必填,至少 32 位的独立随机服务凭据;与后端配置相同,不是钱包密码 |
|
||||
| `CHAIN_EXECUTOR_CONFIGURATION_PASSWORD` | 必填,当前全局钱包配置密码,仅在执行器进程内存中使用 |
|
||||
@@ -37,8 +37,6 @@
|
||||
| `CHAIN_EXECUTOR_BROADCAST_ENABLED` | 必填,只有明确为 `true` 才启动 |
|
||||
| `CHAIN_EXECUTOR_DB_URL` | 与支付后端相同数据库;使用 `connectionTimeZone=LOCAL&forceConnectionTimeZoneToSession=true` |
|
||||
| `CHAIN_EXECUTOR_DB_USER` / `CHAIN_EXECUTOR_DB_PASSWORD` | 独立最小权限数据库账号及密码 |
|
||||
| `CHAIN_EXECUTOR_TLS_KEYSTORE` | 非回环监听必填,PKCS12 证书库的绝对路径 |
|
||||
| `CHAIN_EXECUTOR_TLS_PASSWORD` | 证书库密码 |
|
||||
| `TRON_GRID_API_KEY` / `TRON_SCAN_API_KEY` | 按实际节点配置,沿用共享 TRON 客户端 |
|
||||
|
||||
独立执行器数据库权限:`usdt_config`、`wallet_address`、`usdt_payout_order`、
|
||||
@@ -50,17 +48,27 @@
|
||||
| 变量 | 含义 |
|
||||
| --- | --- |
|
||||
| `CHAIN_EXECUTOR_ENABLED` | 启用双通道时设 `true` |
|
||||
| `CHAIN_EXECUTOR_BASE_URL` | 无尾斜杠/路径的根地址,例如 `https://192.168.10.20:9088` |
|
||||
| `CHAIN_EXECUTOR_BASE_URL` | 无尾斜杠/路径的 HTTP 或 HTTPS 根地址,例如 `http://192.168.10.20:9088` 或 `https://192.168.10.20:9088` |
|
||||
| `CHAIN_EXECUTOR_TOKEN` | 独立服务凭据,与执行器一致 |
|
||||
|
||||
仅回环地址允许 HTTP;跨机器强制 HTTPS。证书 SAN 必须包含配置的内网 IP,支付后端 JVM 需信任签发 CA。
|
||||
使用 JVM trustStore 配置受信 CA,禁止关闭证书校验。只支持 IPv4 字面地址,不接受域名,避免 DNS 重绑定和意外公网解析。
|
||||
执行器自身只提供 HTTP。支付后端可使用 HTTP 直连,或使用 HTTPS 调用同机 Nginx,由 Nginx 转发到回环 HTTP。
|
||||
生产跨机器调用推荐 HTTPS;证书 SAN 必须包含配置的内网 IP,支付后端 JVM 需信任签发 CA,禁止关闭证书校验。
|
||||
只支持 IPv4 字面地址,不接受域名,避免 DNS 重绑定和意外公网解析。Nginx 示例见
|
||||
`usdt-chain-executor/nginx/usdt-chain-executor.conf`。
|
||||
|
||||
### HTTPS + Nginx 推荐配置
|
||||
|
||||
执行器配置为 `CHAIN_EXECUTOR_BIND_ADDRESS=127.0.0.1`、`CHAIN_EXECUTOR_PORT=9089`、
|
||||
`CHAIN_EXECUTOR_ALLOWED_IPS=127.0.0.1`。Nginx 使用内网 IP 的 `9088` 端口终止 TLS并转发到
|
||||
`http://127.0.0.1:9089`。支付后端配置 `CHAIN_EXECUTOR_BASE_URL=https://内网IP:9088`。
|
||||
执行器不读取证书或私钥;`CHAIN_EXECUTOR_TLS_KEYSTORE` 和 `CHAIN_EXECUTOR_TLS_PASSWORD` 已废弃。
|
||||
|
||||
## 仅内网访问
|
||||
|
||||
- 服务拒绝 `0.0.0.0`、公网、域名、IPv6 和未配置白名单的启动方式。
|
||||
- 所有 HTTP 路径统一检查真实 TCP 对端 IP 和独立 Bearer 凭据;健康检查也不例外。
|
||||
- 不信任 `X-Forwarded-For` 或其他代理头。默认直接从支付后端调用,不经过反向代理。
|
||||
- 不信任 `X-Forwarded-For` 或其他代理头。经 Nginx 转发时执行器白名单应配置为 `127.0.0.1`,
|
||||
Nginx 自身再用 `allow/deny` 限制支付后端真实来源 IP。
|
||||
- 防火墙/安全组仅允许支付后端指定内网 IP 访问执行端口,其他来源全部拒绝。
|
||||
- 禁止配置公网 NAT、端口转发、公网反向代理和公网 Ingress;容器部署只发布到宿主机指定内网地址。
|
||||
- 前端只访问现有支付后端;执行器地址、凭据、密码、信封和签名交易不返回浏览器。
|
||||
@@ -69,6 +77,7 @@
|
||||
|
||||
## 协议与执行流程
|
||||
|
||||
- `GET /internal/v1/connectivity`:鉴权后验证传输链路,成功返回纯文本 `CONNECTED`。
|
||||
- `GET /internal/v1/readiness`:鉴权后验证当前配置密码和网络,成功返回纯文本 `READY`,未就绪返回 503。
|
||||
- `POST /internal/v1/executions`:鉴权后接收空正文通知,返回 202;只唤醒数据库扫描,不接收任意交易参数。
|
||||
- `GET /system/chainExecutor/status`:现有后端登录鉴权入口,返回可用性和当前操作人最近 5 条公开执行记录。
|
||||
|
||||
Reference in new issue
Block a user