Configuring cert-manager Certificates

How to configure cert-manager IssuerRef for TLS certificates on Domain or ClusterDomain

When the operator is installed with the cert-manager certificate manager (configured via the CERT_MANAGER environment variable), it creates a cert-manager Certificate resource for each Domain or ClusterDomain. Every Certificate must reference an issuer. By default the operator uses a ClusterIssuer named cluster-ca. Use certConfig.certManager.issuerRef to override this with any issuer available in your cluster.

Default behavior

If certConfig.certManager is not set, the operator uses the following issuer reference:

FieldDefault
namecluster-ca
kindClusterIssuer
groupcert-manager.io

Configuring a custom issuer

Set certConfig.certManager.issuerRef on a Domain or ClusterDomain to point to any cert-manager issuer:

apiVersion: sme.sap.com/v1alpha1
kind: Domain                 # also applies to ClusterDomain
metadata:
  namespace: cap-app-01
  name: cap-app-01-primary
spec:
  domain: my.cluster.shoot.url.k8s.example.com
  ingressSelector:
    app: istio-ingressgateway
    istio: ingressgateway
  certConfig:
    certManager:
      issuerRef:
        name: my-cluster-issuer   # name of the issuer
        kind: ClusterIssuer       # ClusterIssuer or Issuer
        group: cert-manager.io    # optional; defaults to cert-manager.io

issuerRef fields

FieldRequiredDescription
nameyesName of the cert-manager issuer to use
kindnoClusterIssuer (cluster-scoped) or Issuer (namespace-scoped). Defaults to Issuer if omitted
groupnoAPI group of the issuer. Defaults to cert-manager.io if omitted