dwpdigital/acm-cert-helper

ACM Keystore Helper 镜像文档

镜像概述

该镜像是一个与AWS Certificate Manager (ACM)和ACM Private Certificate Authority (ACM-PCA)集成的工具，旨在简化本地Keystore和Truststore文件的生成流程。Keystore用于存储私钥及关联证书，Truststore用于存储可信证书颁发机构(CA)证书，广泛应用于需要证书管理的应用场景。

主要用途

提供自动化工具，从AWS ACM或ACM-PCA获取证书并转换为本地可用的Keystore和Truststore文件，避免手动操作，提高证书管理效率。

核心功能和特性

• 与AWS ACM和ACM-PCA无缝集成，支持从云服务获取证书
• 自动生成符合标准格式的Keystore文件（如JKS格式）
• 自动生成Truststore文件，包含必要的CA证书链
• 支持自定义输出路径和文件名称
• 简化证书管理流程，减少人工操作错误

使用场景和适用范围

• Java应用程序需要本地Keystore/Truststore进行TLS/SSL配置
• 微服务架构中服务间通信的证书认证场景
• 从AWS ACM或ACM-PCA获取证书并在本地应用中使用的环境
• 开发、测试和生产环境中的证书自动化管理

使用方法和配置说明

环境变量配置

Docker运行示例

bash
docker run -d \
  -e AWS_ACCESS_KEY_ID="your-aws-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-aws-secret-key" \
  -e AWS_REGION="us-east-1" \
  -e ACM_CERTIFICATE_ARN="arn:aws:acm:us-east-1:123456789012:certificate/abcdef-1234-5678-90ab-cdef12345678" \
  -e KEYSTORE_PATH="/output/my-keystore.jks" \
  -e KEYSTORE_PASSWORD="securepassword" \
  -e TRUSTSTORE_PATH="/output/my-truststore.jks" \
  -e TRUSTSTORE_PASSWORD="securepassword" \
  -v /local/output:/output \
  your-image-name:latest

Docker Compose配置示例

yaml
version: '3'
services:
  acm-keystore-helper:
    image: your-image-name:latest
    environment:
      - AWS_ACCESS_KEY_ID=your-aws-access-key
      - AWS_SECRET_ACCESS_KEY=your-aws-secret-key
      - AWS_REGION=us-east-1
      - ACM_CERTIFICATE_ARN=arn:aws:acm:us-east-1:123456789012:certificate/abcdef-1234-5678-90ab-cdef***
      - KEYSTORE_PATH=/output/my-keystore.jks
      - KEYSTORE_PASSWORD=securepassword
      - TRUSTSTORE_PATH=/output/my-truststore.jks
      - TRUSTSTORE_PASSWORD=securepassword
    volumes:
      - /local/output:/output