SUSE Support

Here When You Need Us

How to enable TLS 1.3 for RKE2 ingress-nginx in a Rancher provisioned RKE2 cluster?

This document (000021753) is provided subject to the disclaimer at the end of this document.

Environment

  • SUSE Rancher 2.9.x, 2.10.x
  • OpenSSL version 1.1.1 and above.
  • Nginx-ingress version 1.6 and later.
  • Rancher provisioned RKE2 cluster.

Situation

By default, TLS v1.2 is used in the RKE2 ingress-nginx configuration as per the commit ingress-nginx. However, there could be situations where ingress-nginx needs to be reconfigured to use TLS v1.3. 

Resolution

  1. Login to the Rancher UI, select the desired downstream cluster from Cluster Management. 
  2. For the desired downstream cluster, click on More options >> Edit Config >> Additional Manifest and provide the below HelmChartConfig for 'rke2-ingress-nginx' in this section and click on "Save".
  3. apiVersion: helm.cattle.io/v1
    kind: HelmChartConfig
    metadata:
      name: rke2-ingress-nginx
      namespace: kube-system
    spec:
      valuesContent: |-
        controller:
          config:
            ssl-protocols: "TLSv1.2 TLSv1.3"
  4. Alternatively, this configuration can be provided in the manifest file '/var/lib/rancher/rke2/server/manifests/rke2-ingress-nginx-config.yaml' on each RKE2 server node followed by a 'rke2-server' service restart. 
  5. The example above includes TLSv1.2, but TLSv1.3 can be specified to enable only TLSv1.3.
  6. The TLS version can be confirmed by running the command below:
    # kubectl -n kube-system exec -it rke2-ingress-nginx-controller-xxxx -- /dbg conf|grep -i tls
  7. The TLS version can be verified by running a curl command to the service:
     # curl -v https://<service_url>

Disclaimer

This Support Knowledgebase provides a valuable tool for SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.

  • Document ID:000021753
  • Creation Date: 24-Mar-2025
  • Modified Date:09-Apr-2025
    • SUSE Rancher

< Back to Support Search

For questions or concerns with the SUSE Knowledgebase please contact: tidfeedback[at]suse.com

tick icon

SUSE Support Forums

Get your questions answered by experienced Sys Ops or interact with other SUSE community experts.

tick icon

Support Resources

Learn how to get the most from the technical support you receive with your SUSE Subscription, Premium Support, Academic Program, or Partner Program.

tick icon

Open an Incident

Open an incident with SUSE Technical Support, manage your subscriptions, download patches, or manage user access.