Skip to content

Commit a523d56

Browse files
authored
Merge pull request #10461 from MicrosoftDocs/khdownie-patch-2
Update SMB connectivity troubleshooting documentation
2 parents 264237e + ab2b2be commit a523d56

1 file changed

Lines changed: 22 additions & 1 deletion

File tree

support/azure/azure-storage/files/connectivity/files-troubleshoot-smb-connectivity.md

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Troubleshoot problems connecting to and accessing SMB Azure file sh
44
services: storage
55
ms.service: azure-file-storage
66
ms.custom: sap:Connectivity, devx-track-azurepowershell, linux-related-content
7-
ms.date: 05/27/2025
7+
ms.date: 01/07/2026
88
ms.reviewer: kendownie, jarrettr, v-weizhu, v-six, hanagpal, justingross
99
---
1010
# Troubleshoot Azure Files connectivity and access issues (SMB)
@@ -306,6 +306,27 @@ When storage account key access is disabled or disallowed for a storage account,
306306

307307
Use identity-based authentication instead. See [Enable Active Directory authentication over SMB for Linux clients accessing Azure Files](/azure/storage/files/storage-files-identity-auth-linux-kerberos-enable) for prerequisites and instructions.
308308

309+
##### Cause 5: SMB channel encryption is set to AES-256-GCM only
310+
311+
If your Azure storage account is configured to use only AES-256-GCM for SMB channel encryption, mount operations fail when the client defaults to AES-128-GCM.
312+
313+
##### Solution for cause 5
314+
315+
Configure the client to require AES-256-GCM by enabling the `require_gcm_256` option:
316+
317+
```bash
318+
# Load the CIFS module
319+
modprobe cifs
320+
321+
# Set the parameter at runtime
322+
echo 1 | sudo tee /sys/module/cifs/parameters/require_gcm_256
323+
324+
# Persist the configuration
325+
echo "options cifs require_gcm_256=1" | sudo tee -a /etc/modprobe.d/cifs.conf
326+
```
327+
You can also use a Kubernetes DaemonSet to enforce AES-256-GCM on every node. See the following example:
328+
329+
[support-cifs-aes-256-gcm.yaml](https://github.com/andyzhangx/demo/blob/master/aks/support-cifs-aes-256-gcm.yaml)
309330
#### <a id="error115"></a>"Mount error(115): Operation now in progress" when you mount Azure Files by using SMB 3.x
310331

311332
##### Cause

0 commit comments

Comments
 (0)