domeneshop/cert-manager-webhook-domeneshop

cert-manager-webhook-domeneshop 镜像文档

镜像概述

cert-manager-webhook-domeneshop是一个针对Domeneshop DNS提供商的cert-manager DNS01挑战webhook。它允许cert-manager通过Domeneshop DNS服务自动完成ACME DNS01验证，从而实现SSL/TLS证书的自动化签发和续期。

核心功能和特性

• DNS01验证支持：实现ACME DNS01挑战验证流程，通过Domeneshop DNS API自动添加和删除验证记录
• Domeneshop API集成：与Domeneshop DNS管理API深度集成，支持域名记录的动态管理
• 自动化证书管理：配合cert-manager实现证书的自动签发、续期和更新
• Kubernetes兼容：设计用于Kubernetes环境，支持标准的cert-manager webhook接口

使用场景和适用范围

• 基于Kubernetes集群部署的应用，需要通过Domeneshop DNS服务进行SSL/TLS证书管理
• 需要自动化处理Let's Encrypt等ACME证书颁发机构证书的场景
• 希望通过DNS验证方式获取通配符证书或内部服务证书的环境

使用方法和配置说明

前提条件

• 已安装cert-manager（v1.0+）的Kubernetes集群
• Domeneshop账户及API凭证（API令牌和密钥）
• Helm（用于安装webhook）

安装步骤

1. 添加Helm仓库

bash
helm repo add domeneshop https://domeneshop.github.io/cert-manager-webhook-domeneshop
helm repo update

2. 安装webhook

bash
helm install cert-manager-webhook-domeneshop domeneshop/cert-manager-webhook-domeneshop \
  --namespace cert-manager \
  --set groupName=acme.yourdomain.com

3. 创建Domeneshop API凭证Secret

bash
kubectl create secret generic domeneshop-credentials \
  --namespace cert-manager \
  --from-literal=api-token='YOUR_DOMENESHOP_API_TOKEN' \
  --from-literal=api-secret='YOUR_DOMENESHOP_API_SECRET'

4. 创建ClusterIssuer

yaml
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  name: letsencrypt-prod
spec:
  acme:
    server: https://acme-v02.api.letsencrypt.org/directory
    email: your-email@example.com
    privateKeySecretRef:
      name: letsencrypt-prod
    solvers:
    - dns01:
        webhook:
          groupName: acme.yourdomain.com
          solverName: domeneshop
          config:
            apiTokenSecretRef:
              name: domeneshop-credentials
              key: api-token
            apiSecretSecretRef:
              name: domeneshop-credentials
              key: api-secret

配置参数说明

环境变量

Webhook配置

使用示例

创建证书请求：

yaml
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
  name: example-com
  namespace: default
spec:
  secretName: example-com-tls
  issuerRef:
    name: letsencrypt-prod
    kind: ClusterIssuer
  commonName: example.com
  dnsNames:
  - example.com
  - www.example.com

应用后，cert-manager将通过本webhook自动完成DNS01验证并获取证书。