Applies ToSharePoint Server Subscription Edition SharePoint Server 2019 SharePoint Foundation 2013 SP1 SharePoint Server 2016

Symptoms

Users cannot access Web.config files in Microsoft SharePoint Server unless they're local administrators, farm administrators, or managed by SharePoint.

Cause

Web.config files may contain sensitive data. To better protect this data and strengthen the security of SharePoint, SharePoint now restricts access to its Web.config files to the users described in the Symptoms section of this article. This change does not impact standard SharePoint functionality.

If you have deployed customizations to your SharePoint farms that depend on the previously more permissive Web.config file permissions, you can follow the steps in the Workaround section of this article to grant additional users permission to the Web.config files. This workaround should only be used when you have deployed customizations that are impacted by this change.

Workaround

Farm administrators can take the following steps to grant trusted users additional permissions to Web.config files:

  1. Right-click the Web.config file, and then select Properties.

  2. Select Security > Edit > Add.

  3. Enter the username, select Check Names to resolve the user, and then select OK.

  4. Select the required permissions for that user, and then select Apply> OK.

To avoid this behavior for new Web.config files by default, farm administrators can run the following PowerShell commands to skip restricting the permissions for Web.config files:

Add-PSSnapin Microsoft.SharePoint.PowerShell $farm = Get-SPFarm $farm.SkipUpdateWebConfigPermission = $true $farm.Update()

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.