[Claude Workbench] Initial commit - preserving existing code
This commit is contained in:
18
certs/.gitignore
vendored
Normal file
18
certs/.gitignore
vendored
Normal file
@@ -0,0 +1,18 @@
|
||||
# 忽略所有密钥文件
|
||||
*.p12
|
||||
*.pem
|
||||
*.key
|
||||
*.crt
|
||||
*.cer
|
||||
*.pfx
|
||||
*.p7b
|
||||
|
||||
# 忽略证书相关文件
|
||||
apiclient_*
|
||||
*.cert
|
||||
*.pwd
|
||||
|
||||
# 但保留说明文档和目录结构
|
||||
!README.md
|
||||
!.gitkeep
|
||||
!.gitignore
|
||||
54
certs/README.md
Normal file
54
certs/README.md
Normal file
@@ -0,0 +1,54 @@
|
||||
# 密钥文件目录说明
|
||||
|
||||
## 目录结构
|
||||
|
||||
```
|
||||
certs/
|
||||
├── README.md # 本说明文档
|
||||
├── wechat/ # 微信支付相关密钥文件
|
||||
│ ├── README.md # 微信支付密钥说明
|
||||
│ └── .gitkeep # 保持目录结构的占位文件
|
||||
└── .gitignore # Git忽略文件配置
|
||||
```
|
||||
|
||||
## 安全注意事项
|
||||
|
||||
⚠️ **重要提醒**:此目录包含敏感信息,请务必注意以下安全事项:
|
||||
|
||||
1. **不要将密钥文件提交到Git仓库**
|
||||
2. **定期更换密钥文件**
|
||||
3. **限制密钥文件的访问权限**
|
||||
4. **备份密钥文件到安全位置**
|
||||
5. **生产环境使用环境变量或密钥管理服务**
|
||||
|
||||
## 密钥文件类型
|
||||
|
||||
### 微信支付
|
||||
- `apiclient_cert.p12` - 微信支付商户证书
|
||||
- `apiclient_key.pem` - 微信支付私钥文件
|
||||
- `apiclient_cert.pem` - 微信支付公钥文件
|
||||
|
||||
### 其他支付方式
|
||||
- 支付宝、银联等支付方式的密钥文件
|
||||
|
||||
## 使用方法
|
||||
|
||||
1. 将相应的密钥文件放入对应目录
|
||||
2. 在 `application.yml` 中配置正确的文件路径
|
||||
3. 确保应用有读取密钥文件的权限
|
||||
|
||||
## 环境变量配置
|
||||
|
||||
建议使用环境变量来配置密钥文件路径:
|
||||
|
||||
```bash
|
||||
# 微信支付证书路径
|
||||
WX_CERT_URL=/path/to/certs/wechat/apiclient_cert.p12
|
||||
```
|
||||
|
||||
## 生产环境建议
|
||||
|
||||
1. 使用密钥管理服务(如AWS KMS、阿里云KMS等)
|
||||
2. 使用Docker Secrets或Kubernetes Secrets
|
||||
3. 定期轮换密钥
|
||||
4. 监控密钥访问日志
|
||||
3
certs/wechat/.gitkeep
Normal file
3
certs/wechat/.gitkeep
Normal file
@@ -0,0 +1,3 @@
|
||||
# 此文件用于保持目录结构
|
||||
# 请将微信支付证书文件放在此目录中
|
||||
# 文件名:apiclient_cert.p12
|
||||
92
certs/wechat/README.md
Normal file
92
certs/wechat/README.md
Normal file
@@ -0,0 +1,92 @@
|
||||
# 微信支付密钥文件说明
|
||||
|
||||
## 文件说明
|
||||
|
||||
### 必需文件
|
||||
|
||||
1. **apiclient_cert.p12** - 微信支付商户证书
|
||||
- 文件大小:约2-3KB
|
||||
- 用途:用于退款、撤销等需要证书的操作
|
||||
- 获取方式:从微信商户平台下载
|
||||
|
||||
### 可选文件
|
||||
|
||||
2. **apiclient_key.pem** - 微信支付私钥文件
|
||||
- 用途:用于签名验证
|
||||
- 格式:PEM格式的私钥文件
|
||||
|
||||
3. **apiclient_cert.pem** - 微信支付公钥文件
|
||||
- 用途:用于验证微信返回的数据
|
||||
- 格式:PEM格式的公钥文件
|
||||
|
||||
## 获取方式
|
||||
|
||||
### 1. 登录微信商户平台
|
||||
- 访问:https://pay.weixin.qq.com/
|
||||
- 使用商户号登录
|
||||
|
||||
### 2. 下载证书
|
||||
- 进入:账户中心 → API安全 → API证书
|
||||
- 下载 `apiclient_cert.p12` 文件
|
||||
|
||||
### 3. 设置证书密码
|
||||
- 下载时会要求设置证书密码
|
||||
- 请妥善保管密码,后续配置需要用到
|
||||
|
||||
## 配置说明
|
||||
|
||||
### application.yml 配置
|
||||
|
||||
```yaml
|
||||
wx2:
|
||||
# 证书路径(需要配置全路径)
|
||||
certUrl: ${WX_CERT_URL:./certs/wechat/apiclient_cert.p12}
|
||||
```
|
||||
|
||||
### 环境变量配置
|
||||
|
||||
```bash
|
||||
# Windows
|
||||
set WX_CERT_URL=C:\Users\admin\Desktop\1818AI_admin\1818_user_server\certs\wechat\apiclient_cert.p12
|
||||
|
||||
# Linux/Mac
|
||||
export WX_CERT_URL=/path/to/project/certs/wechat/apiclient_cert.p12
|
||||
```
|
||||
|
||||
## 安全建议
|
||||
|
||||
1. **文件权限**:设置适当的文件读取权限
|
||||
2. **路径安全**:不要使用相对路径,使用绝对路径
|
||||
3. **定期更新**:证书有效期通常为1年,请及时更新
|
||||
4. **备份管理**:将证书文件备份到安全位置
|
||||
|
||||
## 常见问题
|
||||
|
||||
### Q: 证书文件路径错误
|
||||
A: 确保使用绝对路径,并且文件确实存在于指定位置
|
||||
|
||||
### Q: 证书密码错误
|
||||
A: 检查证书密码是否正确,密码通常在下载时设置
|
||||
|
||||
### Q: 证书文件损坏
|
||||
A: 重新从微信商户平台下载证书文件
|
||||
|
||||
### Q: 权限不足
|
||||
A: 确保应用有读取证书文件的权限
|
||||
|
||||
## 测试验证
|
||||
|
||||
配置完成后,可以通过以下方式测试:
|
||||
|
||||
1. 启动应用
|
||||
2. 调用退款接口
|
||||
3. 检查日志中是否有证书相关错误
|
||||
4. 确认退款功能正常工作
|
||||
|
||||
## 注意事项
|
||||
|
||||
⚠️ **重要提醒**:
|
||||
- 证书文件包含敏感信息,请勿泄露
|
||||
- 生产环境建议使用环境变量配置路径
|
||||
- 定期检查证书有效期
|
||||
- 证书丢失请立即联系微信支付客服
|
||||
Reference in New Issue
Block a user