Skip to content

Commit d0d3590

Browse files
Merge pull request #252336 from b-ahibbard/access-based-enum-ga
access-based enumeration + non-browsable shares GA announcement
2 parents 3a172af + 73f60d7 commit d0d3590

File tree

3 files changed

+16
-50
lines changed

3 files changed

+16
-50
lines changed

articles/azure-netapp-files/azure-netapp-files-create-volumes-smb.md

Lines changed: 3 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: azure-netapp-files
55
author: b-hchen
66
ms.service: azure-netapp-files
77
ms.topic: how-to
8-
ms.date: 08/20/2024
8+
ms.date: 09/17/2024
99
ms.author: anfdocs
1010
---
1111
# Create an SMB volume for Azure NetApp Files
@@ -21,25 +21,6 @@ This article shows you how to create an SMB3 volume. For NFS volumes, see [Creat
2121
* You must have already set up a capacity pool. See [Create a capacity pool](azure-netapp-files-set-up-capacity-pool.md).
2222
* A subnet must be delegated to Azure NetApp Files. See [Delegate a subnet to Azure NetApp Files](azure-netapp-files-delegate-subnet.md).
2323
* [!INCLUDE [50 GiB volume preview](./includes/50-gib-volume.md)]
24-
* The [non-browsable shares](#non-browsable-share) and [access-based enumeration](#access-based-enumeration) features are currently in preview. You must register each feature before you can use it:
25-
26-
1. Register the feature:
27-
28-
```azurepowershell-interactive
29-
Register-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFSmbNonBrowsable
30-
Register-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFSMBAccessBasedEnumeration
31-
```
32-
33-
2. Check the status of the feature registration:
34-
35-
> [!NOTE]
36-
> 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.
37-
38-
```azurepowershell-interactive
39-
Get-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFSmbNonBrowsable
40-
Get-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFSMBAccessBasedEnumeration
41-
```
42-
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.
4324

4425
## Configure Active Directory connections
4526

@@ -126,14 +107,11 @@ Before creating an SMB volume, you need to create an Active Directory connection
126107

127108
* <a name="access-based-enumeration"></a> If you want to enable access-based enumeration, select **Enable Access Based Enumeration**.
128109

129-
This feature will hide directories and files created under a share from users who do not have access permissions to the files or folders under the share. Users will still be able to view the share.
110+
Hide directories and files created under a share from users who don't have access permissions to the files or folders under the share. Users are still able to view the share.
130111

131112
* <a name="non-browsable-share"></a> You can enable the **non-browsable-share feature.**
132113

133-
This feature prevents the Windows client from browsing the share. The share does not show up in the Windows File Browser or in the list of shares when you run the `net view \\server /all` command.
134-
135-
> [!IMPORTANT]
136-
> Both the access-based enumeration and non-browsable shares features are currently in preview. If this is your first time using either, refer to the steps in [Before you begin](#before-you-begin) to register either feature.
114+
Prevent the Windows client from browsing the share. The share doesn't show up in the Windows File Browser or in the list of shares when you run the `net view \\server /all` command.
137115

138116
* <a name="continuous-availability"></a>If you want to enable Continuous Availability for the SMB volume, select **Enable Continuous Availability**.
139117

articles/azure-netapp-files/create-volumes-dual-protocol.md

Lines changed: 2 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: azure-netapp-files
55
author: b-hchen
66
ms.service: azure-netapp-files
77
ms.topic: how-to
8-
ms.date: 08/20/2024
8+
ms.date: 09/17/2024
99
ms.author: anfdocs
1010
---
1111
# Create a dual-protocol volume for Azure NetApp Files
@@ -23,25 +23,6 @@ To create NFS volumes, see [Create an NFS volume](azure-netapp-files-create-volu
2323
* A subnet must be delegated to Azure NetApp Files.
2424
See [Delegate a subnet to Azure NetApp Files](azure-netapp-files-delegate-subnet.md).
2525
* [!INCLUDE [50 GiB volume preview](./includes/50-gib-volume.md)]
26-
* The [non-browsable shares](#non-browsable-share) and [access-based enumeration](#access-based-enumeration) features are currently in preview. You must register each feature before you can use it:
27-
28-
1. Register the feature:
29-
30-
```azurepowershell-interactive
31-
Register-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFSmbNonBrowsable
32-
Register-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFSMBAccessBasedEnumeration
33-
```
34-
35-
2. Check the status of the feature registration:
36-
37-
> [!NOTE]
38-
> 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.
39-
40-
```azurepowershell-interactive
41-
Get-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFSmbNonBrowsable
42-
Get-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFSMBAccessBasedEnumeration
43-
```
44-
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.
4526

4627
## Considerations
4728

@@ -169,15 +150,12 @@ You can also use [Azure CLI commands](/cli/azure/feature) `az feature register`
169150

170151
* <a name="access-based-enumeration"></a> If you want to enable access-based enumeration, select **Enable Access Based Enumeration**.
171152

172-
This feature hides directories and files created under a share from users who do not have access permissions. You can still view the share. You can only enable access-based enumeration if the dual-protocol volume uses NTFS security style.
153+
Access-based enumeration hides directories and files created under a share from users who do not have access permissions. You can still view the share. You can only enable access-based enumeration if the dual-protocol volume uses NTFS security style.
173154

174155
* <a name="non-browsable-share"></a> You can enable the **non-browsable-share feature.**
175156

176157
This feature prevents the Windows client from browsing the share. The share does not show up in the Windows File Browser or in the list of shares when you run the `net view \\server /all` command.
177158

178-
> [!IMPORTANT]
179-
> The access-based enumeration and non-browsable shares features are currently in preview. If this is your first time using either, refer to the steps in [Before you begin](#before-you-begin) to register the features.
180-
181159
* Customize **Unix Permissions** as needed to specify change permissions for the mount path. The setting does not apply to the files under the mount path. The default setting is `0770`. This default setting grants read, write, and execute permissions to the owner and the group, but no permissions are granted to other users.
182160
Registration requirement and considerations apply for setting **Unix Permissions**. Follow instructions in [Configure Unix permissions and change ownership mode](configure-unix-permissions-change-ownership-mode.md).
183161

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

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,24 @@ author: b-hchen
66
ms.service: azure-netapp-files
77
ms.custom: linux-related-content
88
ms.topic: overview
9-
ms.date: 08/20/2024
9+
ms.date: 09/17/2024
1010
ms.author: anfdocs
1111
---
1212

1313
# What's new in Azure NetApp Files
1414

1515
Azure NetApp Files is updated regularly. This article provides a summary about the latest new features and enhancements.
1616

17+
## September 2024
18+
19+
* [Access-based enumeration](azure-netapp-files-create-volumes-smb.md#access-based-enumeration) is now generally available (GA)
20+
21+
In environments with Azure NetApp Files volumes shared among multiple departments, projects, and users, many users can see the existence of other files and folders in directory listings even if they don't have permissions to access those items. Enabling Access-based enumeration (ABE) on Azure NetApp Files volumes ensures users only see those files and folders in directory listings that they have permission to access. If a user doesn't have read or equivalent permissions for a folder, the Windows client hides the folder from the user’s view. This capability provides an additional layer of security by only displaying files and folders a user has access to, and conversely hiding file and folder information a user has no access. You can enable ABE on Azure NetApp Files SMB volume and dual-protocol volume with NTFS security style.
22+
23+
* [Non-browsable shares](azure-netapp-files-create-volumes-smb.md#non-browsable-share) are now generally available (GA)
24+
25+
By default, Azure NetApp Files SMB and dual-protocol volumes show up in the list of shares in Windows Files Explorer. You might want to exclude specific Azure NetApp Files volumes from being listed. You can configure these volumes as non-browsable in Azure NetApp Files. This feature prevents the Windows client from browsing the share so the share doesn't show up in the Windows File Explorer. This capability provides an additional layer of security by not displaying these shares. This setting doesn't impact permissions. Users who have access to the share maintain their existing access.
26+
1727
## August 2024
1828

1929
* [Azure NetApp Files storage with cool access](cool-access-introduction.md) is now generally available (GA) and supported with the Standard, Premium, and Ultra service levels. Cool access is also now supported for destination volumes in cross-region/cross-zone relationships.

0 commit comments

Comments
 (0)