Aller au contenu
local-cert
Parcourir la documentation

Kubernetes

Avec cert-manager, local-cert se déclare comme un ClusterIssuer ACME. Les Ingress et les ressources Certificate s'en servent ensuite comme de n'importe quel émetteur.

ValeurOù la trouverDans ce guide
Directory ACMEfixe pour chaque instancehttps://certs.example.com/acme/directory
Key ID (kid)Clés & droits → Identifiants EABeab_XXXXXXXXXXXXXXXX
Clé HMACaffichée une seule fois à la créationCLE_HMAC

1. Le secret EAB

kubectl
kubectl -n cert-manager create secret generic local-cert-eab \
  --from-literal=secret=CLE_HMAC

Pour un ClusterIssuer, le secret doit se trouver dans l'espace de noms de cert-manager.

2. Le ClusterIssuer

local-cert-issuer.yaml
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  name: local-cert
spec:
  acme:
    server: https://certs.example.com/acme/directory
    email: ops@example.com
    privateKeySecretRef:
      name: local-cert-account
    externalAccountBinding:
      keyID: eab_XXXXXXXXXXXXXXXX
      keySecretRef:
        name: local-cert-eab
        key: secret
    solvers:
      - http01:
          ingress:
            ingressClassName: nginx
appliquer et vérifier
kubectl apply -f local-cert-issuer.yaml
kubectl get clusterissuer local-cert -o wide   # READY doit passer à True

Remplacez ingressClassName par celle de votre contrôleur (traefik sur k3s, par exemple).

3. Demander un certificat

Par annotation sur un Ingress :

ingress.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: nas
  annotations:
    cert-manager.io/cluster-issuer: local-cert
spec:
  ingressClassName: nginx
  tls:
    - hosts: [nas.home.example.com]
      secretName: nas-tls
  rules:
    - host: nas.home.example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: nas
                port:
                  number: 80

ou explicitement :

certificate.yaml
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
  name: nas
spec:
  secretName: nas-tls
  dnsNames: [nas.home.example.com]
  issuerRef:
    kind: ClusterIssuer
    name: local-cert

Suivre une émission

kubectl
kubectl get certificate,certificaterequest,order,challenge -A
kubectl describe challenge -A | tail -n 20

Comptez une à trois minutes entre la présentation du challenge et le passage du Certificate à Ready. cert-manager renouvelle ensuite seul, aux deux tiers de la durée de vie.

Variantes

  • Un émetteur par espace de noms : utilisez Issuer à la place de ClusterIssuer, avec le secret EAB dans le même espace de noms. Un identifiant EAB par équipe, limité à ses domaines, cloisonne proprement.
  • Gateway API : remplacez le solveur par http01.gatewayHTTPRoute.parentRefs.
  • Sans cert-manager (k3s avec Traefik) : le resolver décrit dans Traefik se déclare dans les arguments du chart via un HelmChartConfig.
  • Jokers : cert-manager refuse HTTP-01 pour un joker. Émettez-le par l'API et chargez-le comme secret TLS.