v1.11.0 includes a drastic reduction in cert-manager's runtime memory usage,
a slew of improvements to AKS integrations and various other tweaks, fixes and improvements,
all towards cert-manager's goal of being the best way to handle certificates in modern
Cloud Native applications.
Support for Azure Workload Identity Federation with Azure DNS and ACME DNS-01
cert-manager can now authenticate using Azure Workload Identity Federation to manage ACME DNS-01 records in Azure DNS. The advantage of this authentication mechanism is that you do not need to store and manage Azure credentials in Kubernetes Secret resources. Instead cert-manager authenticates to Azure using a short lived Kubernetes ServiceAccount token. This is now the recommended authentication method because it is more secure and easier to maintain than the other methods, and it should be used instead of the deprecated pod-managed identify mechanism.
📖 Read about configuring the ACME issuer with Azure DNS.
📖 Read the AKS + LoadBalancer + Let's Encrypt tutorial for an end-to-end example of this authentication method.
🔗 See pull request #5570 for the implementation
Custom CA Bundles for ACME Servers
Some users choose to run their own ACME servers rather than relying on services such as Let's Encrypt. cert-manager supports any server which complies with the ACME spec for the ACME issuer, but some users had issues when using a private CA certificate for their ACME server, requiring either that they ignore certificate validation (which is insecure) or that they hack their certificate into the cert-manager trust store.
Now, users can set a caBundle flag on their ACME issuer, specifying the trust store that cert-manager should use when communicating with the server. For more details, see Private ACME Servers
1.9 we added alpha support for the
LiteralSubject field in the Certificate resource, which
allowed power-users to specify the exact subject they wanted for their certificate. This helps with forcing
an exact ordering of subject fields, for example.
v1.11 improves on that support by adding the
ability to use several other fields which are used primarily in LDAP RDNs.
Potentially Breaking: Gateway API Upgrade
It's exciting to see the Gateway API project progressing nicely, and cert-manager still has experimental support for Gateway API.
Unless you've explicitly opted in to using the Gateway API support, you don't need to do anything. If you've been using the support, however, you might need to take some actions to ensure there aren't any breakages when you update.
Check out the upgrade guide for more details on what you'll need to do.
Thanks again to all open-source contributors with commits in this release, including:
Changes since cert-manager
- Helm: allow configuring the image used by ACME HTTP-01 solver (#5554, @yann-soubeyrand)
- Add the
--max-concurrent-challengescontroller flag to the helm chart (#5638, @lvyanru8200)
- Adds the ability to specify a custom CA bundle in Issuers when connecting to an ACME server (#5644, @SgtCoDFish)
- Enable testing against Kubernetes 1.26 and test with Kubernetes 1.26 by default (#5646, @SgtCoDFish)
- Experimental make targets for pushing images to an OCI registry using
koand redeploying cert-manager to the cluster referenced by your current KUBECONFIG context. (#5655, @wallrj)
- Add ability to run acmesolver pods as root if desired. The default is still to run as non-root. (#5546, @cmcga1125)
- Add support for DC and UID in
LiteralSubjectfield, all mandatory OIDs are now supported for LDAP certificates (rfc4514). (#5587, @SpectralHiss)
- Add support for Workload Identity to AzureDNS resolver (#5570, @weisdd)
- Breaking: updates the gateway API integration to use the more stable v1beta1 API version. Any users of the cert-manager
ExperimentalGatewayAPISupportalpha feature must ensure that
v1betaof Gateway API is installed in cluster. (#5583, @lvyanru8200)
- Certificate secrets get refreshed if the keystore format change (#5597, @sathyanarays)
- Introducing UseCertificateRequestBasicConstraints feature flag to enable Basic Constraints in the Certificate Signing Request (#5552, @sathyanarays)
- Return error when Gateway has a cross-namespace secret ref (#5613, @mmontes11)
- Signers fire an event on CertificateRequests which have not been approved yet. Used for informational purposes so users understand why a request is not progressing. (#5535, @JoshVanL)
Bug or Regression
- Don't log errors relating to self-signed issuer checks for external issuers (#5681, @SgtCoDFish)
- Fixed a bug in AzureDNS resolver that led to early reconciliations in misconfigured Workload Identity-enabled setups (when Federated Identity Credential is not linked with a controller's k8s service account) (#5663, @weisdd)
- Use manually specified temporary directory template when verifying CRDs (#5680, @SgtCoDFish)
vcertwas upgraded to
v4.23.0, fixing two bugs in cert-manager. The first bug was preventing the Venafi issuer from renewing certificates when using TPP has been fixed. You should no longer see your certificates getting stuck with
WebSDK CertRequest Module Requested Certificateor
This certificate cannot be processed while it is in an error state. Fix any errors, and then click Retry.. The second bug that was fixed prevented the use of
algorithm: Ed25519in Certificate resources with VaaS. (#5674, @maelvls)
golang/x/netto fix CVE-2022-41717 (#5632, @SgtCoDFish)
- Bug fix: When using feature gates with the helm chart, enable feature gate flags on webhook as well as controller (#5584, @lvyanru8200)
golang.org/x/textvulnerability (#5562, @SgtCoDFish)
- Fixes a bug that caused the Vault issuer to omit the Vault namespace in requests to the Vault API. (#5591, @wallrj)
- The Venafi Issuer now supports TLS 1.2 renegotiation, so that it can connect to TPP servers where the vedauth API endpoints are configured to accept client certificates. (Note: This does not mean that the Venafi Issuer supports client certificate authentication). (#5568, @wallrj)
- Upgrade to go 1.19.4 to fix CVE-2022-41717 (#5619, @SgtCoDFish)
- Upgrade to latest go minor release (#5559, @SgtCoDFish)
extraArgsin Helm takes precedence over the new acmesolver image options (#5702, @SgtCoDFish)
- Fix cainjector's --namespace flag. Users who want to prevent cainjector from reading all Secrets and Certificates in all namespaces (i.e to prevent excessive memory consumption) can now scope it to a single namespace using the --namespace flag. A cainjector that is only used as part of cert-manager installation only needs access to the cert-manager installation namespace. (#5694, @irbekrm)
- Fixes a bug where cert-manager controller was caching all Secrets twice (#5691, @irbekrm)
certificate.spec.secretNameSecrets will now be labelled with the
controller.cert-manager.io/faolabel (#5703, @irbekrm)
- Upgrade to go 1.19.5 (#5714, @yanggangtony)