Skip to content

Commit af3c900

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-stack-docs-pr into validsign7-11
2 parents 6979322 + 12b5b11 commit af3c900

19 files changed

+138
-497
lines changed

.openpublishing.redirection.aks.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1489,6 +1489,11 @@
14891489
"source_path": "AKS-Arc/tutorial-kubernetes-upgrade-cluster.md",
14901490
"redirect_url": "/azure/aks/aksarc/overview",
14911491
"redirect_document_id": false
1492+
},
1493+
{
1494+
"source_path": "AKS-Arc/aks-hci-network-system-requirements.md",
1495+
"redirect_url": "/azure/aks/aksarc/network-system-requirements",
1496+
"redirect_document_id": false
14921497
}
14931498
]
14941499
}

AKS-Arc/TOC.yml

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@
2525
- name: Networking
2626
items:
2727
- name: Networking concepts and requirements
28-
href: aks-hci-network-system-requirements.md
28+
href: network-system-requirements.md
2929
- name: IP address planning
3030
href: aks-hci-ip-address-planning.md
3131
- name: Load balancer
@@ -201,6 +201,21 @@
201201
href: connectivity-troubleshoot.md
202202
- name: Cluster status stuck during upgrade
203203
href: cluster-upgrade-status.md
204+
- name: Security
205+
items:
206+
- name: Security book - recommendations and best practices
207+
href: /azure/azure-arc/kubernetes/conceptual-security-book?toc=/azure/aks/aksarc/toc.json&bc=/azure/aks/aksarc/breadcrumb/toc.json?toc=/azure/aks/aksarc/toc.json&bc=/azure/aks/aksarc/breadcrumb/toc.json
208+
displayName: security, best practices, recommendations
209+
- name: Securing your platform
210+
href: /azure/azure-arc/kubernetes/conceptual-secure-your-platform?toc=/azure/aks/aksarc/toc.json&bc=/azure/aks/aksarc/breadcrumb/toc.json
211+
- name: Securing your workloads
212+
href: /azure/azure-arc/kubernetes/conceptual-secure-your-workloads?toc=/azure/aks/aksarc/toc.json&bc=/azure/aks/aksarc/breadcrumb/toc.json
213+
- name: Securing your operations
214+
href: /azure/azure-arc/kubernetes/conceptual-secure-your-operations?toc=/azure/aks/aksarc/toc.json&bc=/azure/aks/aksarc/breadcrumb/toc.json
215+
- name: Securing your data
216+
href: /azure/azure-arc/kubernetes/conceptual-secure-your-data?toc=/azure/aks/aksarc/toc.json&bc=/azure/aks/aksarc/breadcrumb/toc.json
217+
- name: Securing your network
218+
href: /azure/azure-arc/kubernetes/conceptual-secure-your-network?toc=/azure/aks/aksarc/toc.json&bc=/azure/aks/aksarc/breadcrumb/toc.json
204219
- name: Reference
205220
items:
206221
- name: Azure CLI

AKS-Arc/arc-gateway-aks-arc.md

Lines changed: 24 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -2,25 +2,24 @@
22
title: Simplify network configuration requirements with Azure Arc gateway (preview)
33
description: Learn how to enable Arc gateway on AKS Arc clusters to simplify network configuration requirements
44
ms.topic: how-to
5-
ms.date: 11/18/2024
5+
ms.date: 07/15/2025
66
author: sethmanheim
7-
ms.author: sethm
8-
ms.reviewer: abha
9-
ms.lastreviewed: 11/18/2024
10-
7+
ms.author: sethm
8+
ms.reviewer: srikantsarwa
9+
ms.lastreviewed: 07/15/2025
1110
---
1211

13-
# Simplify network configuration requirements with Azure Arc Gateway (preview)
12+
# Simplify network configuration requirements with Azure Arc gateway (preview)
1413

1514
If you use enterprise proxies to manage outbound traffic, Azure Arc gateway can help simplify the process of enabling connectivity.
1615

17-
The Azure Arc gateway (currently in preview) lets you:
16+
The AKS Arc gateway (currently in preview) lets you:
1817

1918
- Connect to Azure Arc by opening public network access to only seven fully qualified domain names (FQDNs).
2019
- View and audit all traffic that the Arc agents send to Azure via the Arc gateway.
2120

2221
> [!IMPORTANT]
23-
> Azure Arc gateway is currently in preview.
22+
> AKS Arc gateway is currently in preview.
2423
>
2524
> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
2625
@@ -29,7 +28,7 @@ The Azure Arc gateway (currently in preview) lets you:
2928
The Arc gateway works by introducing two new components:
3029

3130
- The **Arc gateway resource** is an Azure resource that serves as a common front end for Azure traffic. The gateway resource is served on a specific domain/URL. You must create this resource by following the steps described in this article. After you successfully create the gateway resource, this domain/URL is included in the success response.
32-
- The **Arc Proxy** is a new component that runs as its own pod (called *Azure Arc Proxy*). This component acts as a forward proxy used by Azure Arc agents and extensions. There is no configuration required on your part for the Azure Arc Proxy.
31+
- The **Arc Proxy** is a new component that runs as its own pod (called _Azure Arc Proxy_). This component acts as a forward proxy used by Azure Arc agents and extensions. There is no configuration required on your part for the Azure Arc Proxy.
3332

3433
For more information, see [how the Azure Arc gateway works](/azure/azure-arc/kubernetes/arc-gateway-simplify-networking?tabs=azure-cli).
3534

@@ -52,36 +51,36 @@ For more information, see [how the Azure Arc gateway works](/azure/azure-arc/kub
5251

5352
## Confirm access to required URLs
5453

55-
Ensure your Arc gateway URL and all of the URLs below are allowed through your enterprise firewall:
54+
Ensure your Arc gateway URL and all of the following URLs are allowed through your enterprise firewall:
5655

57-
|URL |Purpose |
58-
|---------|---------|
59-
|`[Your URL prefix].gw.arc.azure.com`| Your gateway URL. You can obtain this URL by running `az arcgateway list` after you create the resource. |
60-
|`management.azure.com` |Azure Resource Manager endpoint, required for the Azure Resource Manager control channel. |
61-
|`<region>.obo.arc.azure.com` |Required when `az connectedk8s proxy` is used. |
62-
|`login.microsoftonline.com`, `<region>.login.microsoft.com` | Microsoft Entra ID endpoint, used for acquiring identity access tokens. |
63-
|`gbl.his.arc.azure.com`, `<region>.his.arc.azure.com` |The cloud service endpoint for communicating with Arc Agents. Uses short names; for example `eus` for East US. |
64-
|`mcr.microsoft.com`, `*.data.mcr.microsoft.com` |Required to pull container images for Azure Arc agents. |
56+
| URL | Purpose |
57+
| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
58+
| `[Your URL prefix].gw.arc.azure.com` | Your gateway URL. You can obtain this URL by running `az arcgateway list` after you create the resource. |
59+
| `management.azure.com` | Azure Resource Manager endpoint, required for the Azure Resource Manager control channel. |
60+
| `<region>.obo.arc.azure.com` | Required when `az connectedk8s proxy` is used. |
61+
| `login.microsoftonline.com`, `<region>.login.microsoft.com` | Microsoft Entra ID endpoint, used for acquiring identity access tokens. |
62+
| `gbl.his.arc.azure.com`, `<region>.his.arc.azure.com` | The cloud service endpoint for communicating with Arc Agents. Uses short names; for example, `eus` for East US. |
63+
| `mcr.microsoft.com`, `*.data.mcr.microsoft.com` | Required to pull container images for Azure Arc agents. |
6564

66-
## Create an AKS Arc cluster with Arc gateway enabled
65+
## Create an AKS Arc cluster with AKS Arc gateway enabled
6766

68-
Run the following command to create an AKS Arc cluster with the Arc gateway enabled:
67+
Run the following command to create an AKS Arc cluster with the AKS Arc gateway enabled:
6968

7069
```azurecli
7170
az aksarc create -n $clusterName -g $resourceGroup --custom-location $customlocationID --vnet-ids $arcVmLogNetId --aad-admin-group-object-ids $aadGroupID --gateway-id $gatewayId --generate-ssh-keys
7271
```
7372

74-
## Update an AKS Arc cluster and enable Arc gateway
73+
## Update an AKS Arc cluster and enable the AKS Arc gateway
7574

76-
Run the following command to update an AKS Arc cluster to enable Arc gateway:
75+
Run the following command to update an AKS Arc cluster to enable the AKS Arc gateway:
7776

7877
```azurecli
7978
az aksarc update -n $clusterName -g $resourceGroup --gateway-id $gatewayId
8079
```
8180

82-
## Disable Arc gateway on an AKS Arc cluster
81+
## Disable the AKS Arc gateway on an AKS Arc cluster
8382

84-
Run the following command to disable Arc gateway:
83+
Run the following command to disable the AKS Arc gateway:
8584

8685
```azurecli
8786
az aksarc update -n $clusterName -g $resourceGroup --disable-gateway
@@ -92,7 +91,7 @@ az aksarc update -n $clusterName -g $resourceGroup --disable-gateway
9291
To audit your gateway traffic, view the gateway router logs:
9392

9493
1. Run `kubectl get pods -n azure-arc`.
95-
1. Identify the Arc Proxy pod (its name will begin with `arc-proxy-`).
94+
1. Identify the Arc Proxy pod (its name begins with `arc-proxy-`).
9695
1. Run `kubectl logs -n azure-arc <Arc Proxy pod name>`.
9796

9897
## Other scenarios

AKS-Arc/azure-rbac-local.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -222,3 +222,4 @@ az role definition delete -n "AKS Arc Deployment Reader"
222222
- [Access and identity options](concepts-security-access-identity.md) for AKS enabled by Azure Arc
223223
- [Create an Azure service principal with Azure CLI](/cli/azure/azure-cli-sp-tutorial-1)
224224
- Available Azure permissions for [Hybrid + Multicloud](/azure/role-based-access-control/resource-provider-operations#microsoftkubernetes)
225+
- Help to protect your cluster in other ways by following the guidance in the [security book for AKS enabled by Azure Arc](/azure/azure-arc/kubernetes/conceptual-security-book?toc=/azure/aks/aksarc/toc.json&bc=/azure/aks/aksarc/breadcrumb/toc.json).

AKS-Arc/concepts-security-access-identity.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -154,3 +154,4 @@ The following table contains a summary of how users can authenticate to Kubernet
154154

155155
- To get started with Kubernetes RBAC for Kubernetes authorization, see [Control access using Microsoft Entra ID and Kubernetes RBAC](kubernetes-rbac-local.md)
156156
- To get started with Azure RBAC for Kubernetes authorization, see [Use Azure RBAC for Kubernetes Authorization](azure-rbac-local.md)
157+
- Help to protect your cluster in other ways by following the guidance in the [security book for AKS enabled by Azure Arc](/azure/azure-arc/kubernetes/conceptual-security-book?toc=/azure/aks/aksarc/toc.json&bc=/azure/aks/aksarc/breadcrumb/toc.json).

AKS-Arc/configure-ssh-keys.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -80,3 +80,4 @@ For information about error messages that can occur when you create and deploy a
8080
- [Connect to Windows or Linux worker nodes with SSH](ssh-connect-to-windows-and-linux-worker-nodes.md)
8181
- [Restrict SSH access to specific IP addresses](restrict-ssh-access.md)
8282
- [Get on-demand logs for troubleshooting](get-on-demand-logs.md)
83+
- Help to protect your cluster in other ways by following the guidance in the [security book for AKS enabled by Azure Arc](/azure/azure-arc/kubernetes/conceptual-security-book?toc=/azure/aks/aksarc/toc.json&bc=/azure/aks/aksarc/breadcrumb/toc.json).

AKS-Arc/enable-authentication-microsoft-entra-id.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -75,3 +75,4 @@ Enable Microsoft Entra authentication on your existing Kubernetes cluster using
7575
- [Access and identity options for AKS enabled by Azure Arc](concepts-security-access-identity.md)
7676
- [Microsoft Entra integration with Kubernetes RBAC](kubernetes-rbac-local.md)
7777
- [Use Azure role-based access control (RBAC) for Kubernetes authorization](azure-rbac-local.md)
78+
- Help to protect your cluster in other ways by following the guidance in the [security book for AKS enabled by Azure Arc](/azure/azure-arc/kubernetes/conceptual-security-book?toc=/azure/aks/aksarc/toc.json&bc=/azure/aks/aksarc/breadcrumb/toc.json).

AKS-Arc/encrypt-etcd-secrets.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -105,6 +105,7 @@ If you encounter any errors with the KMS plugin, follow the procedure on the [Tr
105105

106106
## Next steps
107107

108+
- Help to protect your cluster in other ways by following the guidance in the [security book for AKS enabled by Azure Arc](/azure/azure-arc/kubernetes/conceptual-security-book?toc=/azure/aks/aksarc/toc.json&bc=/azure/aks/aksarc/breadcrumb/toc.json).
108109
- [Create Kubernetes clusters](aks-create-clusters-cli.md#deploy-the-application-and-load-balancer)
109110
- [Deploy a Linux application on a Kubernetes cluster](deploy-linux-application.md)
110111

AKS-Arc/kubernetes-rbac-entra-id.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -236,3 +236,4 @@ Error from server (Forbidden): pods is forbidden: User cannot list resource "pod
236236
## Next steps
237237

238238
- [Learn more about security in AKS Arc on Windows Server](concepts-security.md)
239+
- Help to protect your cluster in other ways by following the guidance in the [security book for AKS enabled by Azure Arc](/azure/azure-arc/kubernetes/conceptual-security-book?toc=/azure/aks/aksarc/toc.json&bc=/azure/aks/aksarc/breadcrumb/toc.json).

AKS-Arc/kubernetes-rbac-local.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -250,3 +250,4 @@ Error from server (Forbidden): pods is forbidden: User cannot list resource "pod
250250
## Next steps
251251

252252
- [Azure role-based access control (Azure RBAC)](/azure/role-based-access-control/overview)
253+
- Help to protect your cluster in other ways by following the guidance in the [security book for AKS enabled by Azure Arc](/azure/azure-arc/kubernetes/conceptual-security-book?toc=/azure/aks/aksarc/toc.json&bc=/azure/aks/aksarc/breadcrumb/toc.json).

0 commit comments

Comments
 (0)