Skip to content

Commit 3f0b0f2

Browse files
committed
updated article per GitHub issue
1 parent 692cd3c commit 3f0b0f2

File tree

1 file changed

+12
-13
lines changed

1 file changed

+12
-13
lines changed

articles/aks/api-server-authorized-ip-ranges.md

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: API server authorized IP ranges in Azure Kubernetes Service (AKS)
33
description: Learn how to secure your cluster using an IP address range for access to the API server in Azure Kubernetes Service (AKS)
44
services: container-service
55
ms.topic: article
6-
ms.date: 09/21/2020
6+
ms.date: 06/20/2022
77

88

99
#Customer intent: As a cluster operator, I want to increase the security of my cluster by limiting access to the API server to only the IP addresses that I specify.
@@ -13,13 +13,13 @@ ms.date: 09/21/2020
1313

1414
In Kubernetes, the API server receives requests to perform actions in the cluster such as to create resources or scale the number of nodes. The API server is the central way to interact with and manage a cluster. To improve cluster security and minimize attacks, the API server should only be accessible from a limited set of IP address ranges.
1515

16-
This article shows you how to use API server authorized IP address ranges to limit which IP addresses and CIDRs can access control plane.
16+
This article shows you how to use API server authorized IP address ranges, using the Azure CLI, to limit which IP addresses and CIDRs can access control plane.
1717

1818
## Before you begin
1919

20-
This article shows you how to create an AKS cluster using the Azure CLI.
20+
- You need the Azure CLI version 2.0.76 or later installed and configured. Run `az --version` to find the version. If you need to install or upgrade, see [Install Azure CLI][install-azure-cli].
2121

22-
You need the Azure CLI version 2.0.76 or later installed and configured. Run `az --version` to find the version. If you need to install or upgrade, see [Install Azure CLI][install-azure-cli].
22+
- To learn what IP addresses to include when integrating your AKS cluster with Azure DevOps, see the Azure DevOps [Allowed IP addresses and domain URLs][azure-devops-allowed-network-cfg] article.
2323

2424
### Limitations
2525

@@ -62,7 +62,7 @@ az aks create \
6262
>
6363
> The upper limit for the number of IP ranges you can specify is 200.
6464
>
65-
> The rules can take up to 2min to propagate. Please allow up to that time when testing the connection.
65+
> The rules can take up to two minutes to propagate. Please allow up to that time when testing the connection.
6666
6767
### Specify the outbound IPs for the Standard SKU load balancer
6868

@@ -146,9 +146,9 @@ The above operations of adding, updating, finding, and disabling authorized IP r
146146

147147
## How to find my IP to include in `--api-server-authorized-ip-ranges`?
148148

149-
You must add your development machines, tooling or automation IP addresses to the AKS cluster list of approved IP ranges in order to access the API server from there.
149+
You must add your development machines, tooling or automation IP addresses to the AKS cluster list of approved IP ranges in order to access the API server from there.
150150

151-
Another option is to configure a jumpbox with the needed tooling inside a separate subnet in the Firewall's virtual network. This assumes your environment has a Firewall with the respective network, and you have added the Firewall IPs to authorized ranges. Similarly, if you have forced tunneling from the AKS subnet to the Firewall subnet, than having the jumpbox in the cluster subnet is fine too.
151+
Another option is to configure a jumpbox with the necessary tooling inside a separate subnet in the firewall's virtual network. This assumes your environment has a firewall with the respective network, and you have added the firewall IPs to authorized ranges. Similarly, if you have forced tunneling from the AKS subnet to the firewall subnet, than having the jumpbox in the cluster subnet is also okay.
152152

153153
Add another IP address to the approved ranges with the following command.
154154

@@ -163,21 +163,19 @@ az aks update -g $RG -n $AKSNAME --api-server-authorized-ip-ranges $CURRENT_IP/3
163163
```
164164

165165
> [!NOTE]
166-
> The above example appends the API server authorized IP ranges on the cluster. To disable authorized IP ranges, use az aks update and specify an empty range "".
166+
> The above example appends the API server authorized IP ranges on the cluster. To disable authorized IP ranges, use `az aks update` and specify an empty range "".
167167

168-
Another option is to use the below command on Windows systems to get the public IPv4 address, or you can use the steps in [Find your IP address](https://support.microsoft.com/en-gb/help/4026518/windows-10-find-your-ip-address).
168+
Another option is to use the command below on Windows systems to get the public IPv4 address, or you can follow the steps in [Find your IP address](https://support.microsoft.com/en-gb/help/4026518/windows-10-find-your-ip-address).
169169

170170
```azurepowershell-interactive
171171
Invoke-RestMethod http://ipinfo.io/json | Select -exp ip
172172
```
173173

174-
You can also find this address by searching "what is my IP address" in an internet browser.
174+
You can also find this address by searching on *what is my IP address* in an internet browser.
175175

176176
## Next steps
177177

178-
In this article, you enabled API server authorized IP ranges. This approach is one part of how you can run a secure AKS cluster.
179-
180-
For more information, see [Security concepts for applications and clusters in AKS][concepts-security] and [Best practices for cluster security and upgrades in AKS][operator-best-practices-cluster-security].
178+
In this article, you enabled API server authorized IP ranges. This approach is one part of how you can securely run an AKS cluster. For more information, see [Security concepts for applications and clusters in AKS][concepts-security] and [Best practices for cluster security and upgrades in AKS][operator-best-practices-cluster-security].
181179

182180
<!-- LINKS - external -->
183181
[cni-networking]: https://github.com/Azure/azure-container-networking/blob/master/docs/cni.md
@@ -195,3 +193,4 @@ For more information, see [Security concepts for applications and clusters in AK
195193
[operator-best-practices-cluster-security]: operator-best-practices-cluster-security.md
196194
[route-tables]: ../virtual-network/manage-route-table.md
197195
[standard-sku-lb]: load-balancer-standard.md
196+
[azure-devops-allowed-network-cfg]: /azure/devops/organizations/security/allow-list-ip-url

0 commit comments

Comments
 (0)