ASP.NET Debugging: System Requirements

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

This topic describes the software and security requirements for ASP.NET debugging scenarios:

  • Local debugging, in which Visual Studio and the Web application run on the same computer. There are two versions of this scenario:

    • The ASP.NET code resides on the file system.

    • The ASP.NET code resides in an IIS Web site.

  • Remote debugging, in which Visual Studio runs on a client computer and debugs a Web application that is running on a remote server computer.

Security Requirements

For remote debugging, local and remote computers must be on a domain setup or a workgroup setup.

To debug the ASP.NET worker process (hosted by an Application Pool), you must have permission to debug that process. By default, ASP.NET applications prior to IIS 6.0 run as the ASPNET user. In IIS 6.0 and IIS 7.0, the NETWORK SERVICE account is the default. If the worker process is running as ASPNET, or as NETWORK SERVICE, you must have Administrator privileges to debug it.

Important

Starting with Windows Server 2008 R2, we recommend the use of the ApplicationPoolIdentity as the identity for each application pool.

The name of the ASP.NET worker process varies by debugging scenario and by version of IIS. For more information, see How to: Find the Name of the ASP.NET Process.

You can change the user account that the ASP.NET worker process runs under by editing the machine.config file on the server that is running IIS. The best way to do this is to use the Internet Information Services (IIS) Manager. For more information, see How to: Run the Worker Process Under a User Account.

If you change the ASP.NET worker process to run under your own user account, you do not have to be an Administrator on the server that is running IIS.

Caution

Before you change the ASP.NET worker process to run under a different account, consider the possible consequences if the ASP.NET worker process should be hacked while running under that account. The ASPNET and NETWORK SERVICE user accounts run with minimal permissions, reducing the possible damage if the process is hacked. If you must change the ASP.NET worker process to run under an account that has greater permissions, the potential damage is greater.

See also