Skip to content

Commit 6daadd7

Browse files
Learn Build Service GitHub AppLearn Build Service GitHub App
authored andcommitted
Merging changes synced from https://github.com/MicrosoftDocs/azure-docs-pr (branch live)
2 parents aac1b8e + 5f0a0cc commit 6daadd7

32 files changed

+458
-463
lines changed

articles/azure-netapp-files/create-active-directory-connections.md

Lines changed: 49 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -20,13 +20,13 @@ Several features of Azure NetApp Files require that you have an Active Directory
2020
>
2121
> Before creating the AD connection, review [Modify Active Directory connections for Azure NetApp Files](modify-active-directory-connections.md) to understand the impact of making changes to the AD connection configuration options after the AD connection has been created. Changes to the AD connection configuration options are disruptive to client access and some options cannot be changed at all.
2222
23-
* An Azure NetApp Files account must be created in the region where the Azure NetApp Files volumes are deployed.
23+
* An Azure NetApp Files account must be created in the region where the Azure NetApp Files volumes are to be deployed.
2424

25-
* You can configure only one Active Directory (AD) connection per subscription per region.
25+
* By default, Azure NetApp Files allows only one Active Directory (AD) connection per subscription.
2626

27-
Azure NetApp Files doesn’t support multiple AD connections in a single region, even if the AD connections are created in different NetApp accounts. However, you can have multiple AD connections in a single subscription if the AD connections are in different regions. If you need multiple AD connections in a single region, you can use separate subscriptions to do so.
27+
You can [create one Active Directory connection per NetApp account](#multi-ad).
2828

29-
The AD connection is visible only through the NetApp account it's created in. However, you can enable the Shared AD feature to allow NetApp accounts that are under the same subscription and same region to use the same AD connection. See [Map multiple NetApp accounts in the same subscription and region to an AD connection](#shared_ad).
29+
Before enrolling in this feature, check the [Active Directory type](#netapp-accounts-and-active-directory-type) field in your account page.
3030

3131
* The Azure NetApp Files AD connection admin account must have the following properties:
3232
* It must be an AD DS domain user account in the same domain where the Azure NetApp Files computer accounts are created.
@@ -47,7 +47,7 @@ Several features of Azure NetApp Files require that you have an Active Directory
4747
>[!NOTE]
4848
>When you modify the setting to enable AES on the AD connection admin account, it is a best practice to use a user account that has write permission to the AD object that is not the Azure NetApp Files AD admin. You can do so with another domain admin account or by delegating control to an account. For more information, see [Delegating Administration by Using OU Objects](/windows-server/identity/ad-ds/plan/delegating-administration-by-using-ou-objects).
4949
50-
If you set both AES-128 and AES-256 Kerberos encryption on the admin account of the AD connection, the highest level of encryption supported by your AD DS will be used.
50+
If you set both AES-128 and AES-256 Kerberos encryption on the admin account of the AD connection, the Windows client negotiates the highest level of encryption supported by your AD DS. For example, if both AES-128 and AES-256 are supported, and the client supports AES-256, then AES-256 will be used.
5151

5252
* To enable AES encryption support for the admin account in the AD connection, run the following Active Directory PowerShell commands:
5353

@@ -77,9 +77,19 @@ Several features of Azure NetApp Files require that you have an Active Directory
7777
7878
Query timeouts can occur in large LDAP environments with many user and group objects, over slow WAN connections, and if an LDAP server is over-utilized with requests. Azure NetApp Files timeout setting for LDAP queries is set to 10 seconds. Consider leveraging the user and group DN features on the Active Directory Connection for the LDAP server to filter searches if you are experiencing LDAP query timeout issues.
7979
80+
## NetApp accounts and Active Directory type
81+
82+
You can use the NetApp account overview page to confirm the Active Directory account type. There are three values for AD type:
83+
84+
* **NA**: Existing NetApp account which supports only one AD configuration per subscription and region. The AD configuration is not shared with other NetApp accounts in the subscription.
85+
* **Multi AD**: NetApp account supports one AD configuration in each NetApp account in the subscription. This allows for more than one AD connection per subscription when using multiple NetApp accounts.
86+
* **Shared AD**: NetApp account supports only one AD configuration per subscription and region, but the configuration is shared across NetApp accounts in the subscription and region.
87+
88+
For more information about the relationship between NetApp accounts and subscriptions, see [Storage hierarchy of Azure NetApp Files](azure-netapp-files-understand-storage-hierarchy.md).
89+
8090
## Create an Active Directory connection
8191
82-
1. From your NetApp account, select **Active Directory connections**, then select **Join**.
92+
1. From your NetApp account, select **Active Directory connections** then **Join**.
8393
8494
![Screenshot showing the Active Directory connections menu. The join button is highlighted.](./media/create-active-directory-connections/azure-netapp-files-active-directory-connections.png)
8595
@@ -97,11 +107,12 @@ Several features of Azure NetApp Files require that you have an Active Directory
97107
>[!NOTE]
98108
>It is recommended that you configure a Secondary DNS server. See [Understand guidelines for Active Directory Domain Services site design and planning for Azure NetApp Files](understand-guidelines-active-directory-domain-service-site.md). Ensure that your DNS server configuration meets the requirements for Azure NetApp Files. Otherwise, Azure NetApp Files service operations, SMB authentication, Kerberos, or LDAP operations might fail.
99109
100-
If you use Microsoft Entra Domain Services, you should use the IP addresses of the Microsoft Entra Domain Services domain controllers for Primary DNS and Secondary DNS respectively.
110+
If you use Microsoft Entra Domain Services, use the IP addresses of the Microsoft Entra Domain Services domain controllers for Primary DNS and Secondary DNS respectively.
111+
101112
* **AD DNS Domain Name (required)**
102-
This is the fully qualified domain name of the AD DS that will be used with Azure NetApp Files (for example, `contoso.com`).
113+
This is the fully qualified domain name of the AD DS used with Azure NetApp Files (for example, `contoso.com`).
103114
* **AD Site Name (required)**
104-
This is the AD DS site name that will be used by Azure NetApp Files for domain controller discovery.
115+
This is the AD DS site name that Azure NetApp Files USES for domain controller discovery.
105116
106117
The default site name for both AD DS and Microsoft Entra Domain Services is `Default-First-Site-Name`. Follow the [naming conventions for site names](/troubleshoot/windows-server/identity/naming-conventions-for-computer-domain-site-ou#site-names) if you want to rename the site name.
107118
@@ -146,7 +157,7 @@ Several features of Azure NetApp Files require that you have an Active Directory
146157
![Screenshot of the LDAP signing checkbox.](./media/create-active-directory-connections/active-directory-ldap-signing.png)
147158
148159
* **Allow local NFS users with LDAP**
149-
This option enables local NFS client users to access to NFS volumes. Setting this option disables extended groups for NFS volumes. It also limits the number of groups to 16. For more information, see [Allow local NFS users with LDAP to access a dual-protocol volume](create-volumes-dual-protocol.md#allow-local-nfs-users-with-ldap-to-access-a-dual-protocol-volume).
160+
This option enables local NFS client users to access to NFS volumes. Setting this option disables extended groups for NFS volumes, which limits the number of supported groups for a user to 16. When enabled, groups beyond the 16 group limit aren't honored in access permissions. For more information, see [Allow local NFS users with LDAP to access a dual-protocol volume](create-volumes-dual-protocol.md#allow-local-nfs-users-with-ldap-to-access-a-dual-protocol-volume).
150161
151162
* **LDAP over TLS**
152163
@@ -165,9 +176,9 @@ Several features of Azure NetApp Files require that you have an Active Directory
165176
166177
* **LDAP Search Scope**, **User DN**, **Group DN**, and **Group Membership Filter**
167178
168-
The **LDAP search scope** option optimizes Azure NetApp Files storage LDAP queries for use with large AD DS topologies and LDAP with extended groups or Unix security style with an Azure NetApp Files dual-protocol volume.
179+
The [**LDAP search scope**](/windows/win32/ad/search-scope) option optimizes Azure NetApp Files storage LDAP queries for use with large AD DS topologies and LDAP with extended groups or Unix security style with an Azure NetApp Files dual-protocol volume.
169180
170-
The **User DN** and **Group DN** options allow you to set the search base in AD DS LDAP.
181+
The **User DN** and **Group DN** options allow you to set the search base in AD DS LDAP. These options limit the search areas for LDAP queries, reducing the search time and helping to reduce LDAP query timeouts.
171182
172183
The **Group Membership Filter** option allows you to create a custom search filter for users who are members of specific AD DS groups.
173184
@@ -243,6 +254,9 @@ Several features of Azure NetApp Files require that you have an Active Directory
243254
244255
![Screenshot that shows the Administrators box of Active Directory connections window.](./media/create-active-directory-connections/active-directory-administrators.png)
245256
257+
>[!NOTE]
258+
>This privilege is useful for data migrations.
259+
246260
The following privileges apply when you use the **Administrators privilege users** setting:
247261
248262
| Privilege | Description |
@@ -267,16 +281,25 @@ Several features of Azure NetApp Files require that you have an Active Directory
267281
268282
![Screenshot of the Active Directory connections menu showing a successfully created connection.](./media/create-active-directory-connections/azure-netapp-files-active-directory-connections-created.png)
269283
270-
## <a name="shared_ad"></a>Map multiple NetApp accounts in the same subscription and region to an AD connection
284+
## <a name="multi-ad"></a> Create one Active Directory connection per NetApp account (preview)
285+
286+
With this feature, each NetApp account within an Azure subscription can have its own AD connection. Once configured, the AD connection of the NetApp account is used when you create an [SMB volume](azure-netapp-files-create-volumes-smb.md), a [NFSv4.1 Kerberos volume](configure-kerberos-encryption.md), or a [dual-protocol volume](create-volumes-dual-protocol.md). That means, Azure NetApp Files supports more than one AD connection per Azure subscription when multiple NetApp accounts are used.
271287
272-
The Shared AD feature enables all NetApp accounts to share an Active Directory (AD) connection created by one of the NetApp accounts that belong to the same subscription and the same region. For example, using this feature, all NetApp accounts in the same subscription and region can use the common AD configuration to create an [SMB volume](azure-netapp-files-create-volumes-smb.md), a [NFSv4.1 Kerberos volume](configure-kerberos-encryption.md), or a [dual-protocol volume](create-volumes-dual-protocol.md). When you use this feature, the AD connection will be visible in all NetApp accounts that are under the same subscription and same region.
288+
>[!NOTE]
289+
>If a subscription has both this and the [Shared Active Directory](#shared_ad) feature enabled, its existing accounts still share the AD configuration. Any new NetApp accounts created on the subscription can use their own AD configurations. You can confirm your configuration in your account overview page in the [AD type](#netapp-accounts-and-active-directory-type) field.
273290
274-
This feature is currently in preview. You need to register the feature before using it for the first time. After registration, the feature is enabled and works in the background. No UI control is required.
291+
### Considerations
292+
293+
* The scope of each AD configuration is limited to its parent NetApp account.
294+
295+
### Register the feature
296+
297+
The feature to create one AD connection per NetApp account is currently in preview. You need to register the feature before using it for the first time. After registration, the feature is enabled and works in the background.
275298
276299
1. Register the feature:
277300
278301
```azurepowershell-interactive
279-
Register-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFSharedAD
302+
Register-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFMultipleActiveDirectory
280303
```
281304
282305
2. Check the status of the feature registration:
@@ -285,10 +308,19 @@ This feature is currently in preview. You need to register the feature before us
285308
> The **RegistrationState** may be in the `Registering` state for up to 60 minutes before changing to`Registered`. Wait until the status is **Registered** before continuing.
286309
287310
```azurepowershell-interactive
288-
Get-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFSharedAD
311+
Get-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFMultipleActiveDirectory
289312
```
290313
You can also use [Azure CLI commands](/cli/azure/feature) `az feature register` and `az feature show` to register the feature and display the registration status.
291314
315+
## <a name="shared_ad"></a>Map multiple NetApp accounts in the same subscription and region to one AD connection (preview)
316+
317+
The Shared AD feature enables all NetApp accounts to share an AD connection created by one of the NetApp accounts that belong to the same subscription and the same region. For example, using this feature, all NetApp accounts in the same subscription and region can use the common AD configuration to create an [SMB volume](azure-netapp-files-create-volumes-smb.md), a [NFSv4.1 Kerberos volume](configure-kerberos-encryption.md), or a [dual-protocol volume](create-volumes-dual-protocol.md). When you use this feature, the AD connection is visible in all NetApp accounts that are under the same subscription and same region.
318+
319+
With the introduction of the feature to [create an AD connection per NetApp account](#multi-ad), new feature registration for the Shared AD feature are not accepted.
320+
321+
>[!NOTE]
322+
>You can register to use one AD connection per NetApp account if you're already enrolled in the preview for Shared AD. If you currently meet the maximum of 10 NetApp accounts per Azure region per subscription, you must initiate a [support request](azure-netapp-files-resource-limits.md#request-limit-increase) to increase the limit. You can confirm your configuration in your account overview page in the [AD type](#netapp-accounts-and-active-directory-type) field.
323+
292324
## <a name="reset-active-directory"></a> Reset Active Directory computer account password
293325
294326
If you accidentally reset the password of the AD computer account on the AD server or the AD server is unreachable, you can safely reset the computer account password to preserve connectivity to your volumes. A reset affects all volumes on the SMB server.

articles/azure-netapp-files/faq-smb.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -25,9 +25,9 @@ Yes, you must create an Active Directory connection before deploying an SMB volu
2525

2626
## How many Active Directory connections are supported?
2727

28-
You can configure only one Active Directory (AD) connection per subscription and per region. See [Requirements for Active Directory connections](create-active-directory-connections.md#requirements-for-active-directory-connections) for additional information.
28+
Azure NetApp Files now supports the ability to [create multiple Active Directory configurations in a subscription](create-active-directory-connections.md#multi-ad).
2929

30-
However, you can map multiple NetApp accounts that are under the same subscription and same region to a common AD server created in one of the NetApp accounts. See [Map multiple NetApp accounts in the same subscription and region to an AD connection](create-active-directory-connections.md#shared_ad).
30+
You can also map multiple NetApp accounts that are under the same subscription and same region to a common AD server created in one of the NetApp accounts. See [Map multiple NetApp accounts in the same subscription and region to an AD connection](create-active-directory-connections.md#shared_ad).
3131

3232
<a name='does-azure-netapp-files-support-azure-active-directory'></a>
3333

@@ -85,7 +85,7 @@ The same share name can be used for:
8585
* volumes deployed in different regions
8686
* volumes deployed to different availability zones within the same region
8787

88-
If you are using:
88+
If you're using:
8989
* regional volumes (without availability zones) or
9090
* volumes within the same availability zone,
9191

articles/azure-netapp-files/whats-new.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,10 @@ Azure NetApp Files is updated regularly. This article provides a summary about t
1616

1717
## May 2024
1818

19+
* [Support for one Active Directory connection per NetApp account](create-active-directory-connections.md#multi-ad) (Preview)
20+
21+
The Azure NetApp Files support for one Active Directory (AD) connection per NetApp account feature now allows each NetApp account to connect to its own AD Forest and Domain, providing the ability to manage more than one AD connections within a single region under a subscription. This enhancement enables distinct AD connections for each NetApp account, facilitating operational isolation and specialized hosting scenarios. AD connections can be configured multiple times for multiple NetApp accounts to make use of it. With the creation of SMB volumes in Azure NetApp Files now tied to AD connections in the NetApp account, the management of AD environments becomes more scalable, streamlined and efficient. This feature is in preview.
22+
1923
* [Azure NetApp Files backup](backup-introduction.md) is now generally available (GA).
2024

2125
Azure NetApp Files online snapshots are enhanced with backup of snapshots. With this backup capability, you can offload (vault) your Azure NetApp Files snapshots to a Backup vault in a fast and cost-effective way, further protecting your data from accidental deletion.

0 commit comments

Comments
 (0)