Skip to content

Commit ca5f526

Browse files
Merge pull request #277390 from tamram/tamram24-0606
update certificate rotation
2 parents 0bcd0f9 + 73cb8b0 commit ca5f526

File tree

1 file changed

+12
-9
lines changed

1 file changed

+12
-9
lines changed

articles/aks/certificate-rotation.md

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,21 @@
11
---
22
title: Certificate Rotation in Azure Kubernetes Service (AKS)
3-
description: Learn certificate rotation in an Azure Kubernetes Service (AKS) cluster.
3+
description: Learn about certificate rotation in an Azure Kubernetes Service (AKS) cluster.
4+
author: tamram
5+
6+
ms.author: tamram
47
ms.topic: article
58
ms.subservice: aks-security
69
ms.custom: devx-track-azurecli
7-
ms.date: 01/19/2023
10+
ms.date: 06/05/2024
811
---
912

1013
# Certificate rotation in Azure Kubernetes Service (AKS)
1114

12-
Azure Kubernetes Service (AKS) uses certificates for authentication with many of its components. RBAC-enabled clusters created after March 2022 are enabled with certificate auto-rotation. You may need to periodically rotate those certificates for security or policy reasons. For example, you may have a policy to rotate all your certificates every 90 days.
15+
Azure Kubernetes Service (AKS) uses certificates for authentication with many of its components. Clusters with Azure role-based access control (Azure RBAC) that were created after March 2022 are enabled with certificate auto-rotation. You may need to periodically rotate those certificates for security or policy reasons. For example, you may have a policy to rotate all your certificates every 90 days.
1316

1417
> [!NOTE]
15-
> Certificate auto-rotation is *only* enabled by default for RBAC enabled AKS clusters.
18+
> Certificate auto-rotation is enabled by default only for RBAC-enabled AKS clusters.
1619
1720
This article shows you how certificate rotation works in your AKS cluster.
1821

@@ -66,15 +69,15 @@ Microsoft maintains all certificates mentioned in this section, except for the c
6669
az vm run-command invoke --resource-group MC_rg_myAKSCluster_region --name vm-name --command-id RunShellScript --query 'value[0].message' -otsv --scripts "openssl x509 -in /etc/kubernetes/certs/apiserver.crt -noout -enddate"
6770
```
6871

69-
### Check Virtual Machine Scale Set agent node certificate expiration date
72+
### Check certificate expiration for the virtual machine scale set agent node
7073

71-
* Check the expiration date of the Virtual Machine Scale Set agent node certificate using the `az vm run-command invoke` command.
74+
* Check the expiration date of the virtual machine scale set agent node certificate using the `az vm run-command invoke` command.
7275

7376
```azurecli-interactive
7477
az vmss run-command invoke --resource-group "MC_rg_myAKSCluster_region" --name "vmss-name" --command-id RunShellScript --instance-id 1 --scripts "openssl x509 -in /etc/kubernetes/certs/apiserver.crt -noout -enddate" --query "value[0].message"
7578
```
7679

77-
## Certificate Auto Rotation
80+
## Certificate auto-rotation
7881

7982
For AKS to automatically rotate non-CA certificates, the cluster must have [TLS Bootstrapping](https://kubernetes.io/docs/reference/access-authn-authz/kubelet-tls-bootstrapping/), which is enabled by default in all Azure regions.
8083

@@ -103,7 +106,7 @@ For any AKS clusters created or upgraded after March 2022, Azure Kubernetes Serv
103106
## Manually rotate your cluster certificates
104107

105108
> [!WARNING]
106-
> Rotating your certificates using `az aks rotate-certs` recreates all of your nodes, Virtual Machine Scale Sets and Disks and can cause up to *30 minutes of downtime* for your AKS cluster.
109+
> Rotating your certificates using `az aks rotate-certs` recreates all of your nodes, virtual machine scale sets, and disks and can cause up to *30 minutes of downtime* for your AKS cluster.
107110

108111
1. Connect to your cluster using the [`az aks get-credentials`][az-aks-get-credentials] command.
109112

@@ -149,7 +152,7 @@ For any AKS clusters created or upgraded after March 2022, Azure Kubernetes Serv
149152

150153
## Next steps
151154

152-
This article showed you how to automatically rotate your cluster certificates, CAs, and SAs. For more information, see [Best practices for cluster security and upgrades in Azure Kubernetes Service (AKS)][aks-best-practices-security-upgrades].
155+
This article showed you how to manually and automatically rotate your cluster certificates, CAs, and SAs. For more information, see [Best practices for cluster security and upgrades in Azure Kubernetes Service (AKS)][aks-best-practices-security-upgrades].
153156

154157
<!-- LINKS - internal -->
155158
[azure-cli-install]: /cli/azure/install-azure-cli

0 commit comments

Comments
 (0)