Skip to content

Commit

Permalink
Update IIS options and cross-link IIS+Kestrel options in Hosting topic (
Browse files Browse the repository at this point in the history
dotnet#4310)

* Update IIS options and cross-link IIS+Kestrel options in Hosting topic

* React to feedback
  • Loading branch information
guardrex authored and scottaddie committed Sep 18, 2017
1 parent 990f075 commit bd34380
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 11 deletions.
4 changes: 2 additions & 2 deletions aspnetcore/fundamentals/hosting.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Create a host using an instance of [WebHostBuilder](/dotnet/api/microsoft.aspnet

`CreateDefaultBuilder` performs the following tasks:

* Configures [Kestrel](servers/kestrel.md) as the web server.
* Configures [Kestrel](servers/kestrel.md) as the web server. For the Kestrel default options, see [the Kestrel options section of Kestrel web server implementation in ASP.NET Core](xref:fundamentals/servers/kestrel#kestrel-options).
* Sets the content root to [Directory.GetCurrentDirectory](/dotnet/api/system.io.directory.getcurrentdirectory).
* Loads optional configuration from:
* *appsettings.json*.
Expand All @@ -38,7 +38,7 @@ Create a host using an instance of [WebHostBuilder](/dotnet/api/microsoft.aspnet
* Environment variables.
* Command-line arguments.
* Configures [logging](xref:fundamentals/logging) for console and debug output with [log filtering](xref:fundamentals/logging#log-filtering) rules specified in a Logging configuration section of an *appsettings.json* or *appsettings.{Environment}.json* file.
* When running behind IIS, enables IIS integration by configuring the base path and port the server should listen on when using the [ASP.NET Core Module](xref:fundamentals/servers/aspnet-core-module). The module creates a reverse-proxy between Kestrel and IIS. Also configures the app to [capture startup errors](#capture-startup-errors).
* When running behind IIS, enables [IIS integration](xref:publishing/iis) by configuring the base path and port the server should listen on when using the [ASP.NET Core Module](xref:fundamentals/servers/aspnet-core-module). The module creates a reverse-proxy between IIS and Kestrel. Also configures the app to [capture startup errors](#capture-startup-errors). For the IIS default options, see [the IIS options section of Host ASP.NET Core on Windows with IIS](xref:publishing/iis#iis-options).

The *content root* determines where the host searches for content files, such as MVC view files. The default content root is [Directory.GetCurrentDirectory](/dotnet/api/system.io.directory.getcurrentdirectory). This results in using the web project's root folder as the content root when the app is started from the root folder (for example, calling [dotnet run](/dotnet/core/tools/dotnet-run) from the project folder). This is the default used in [Visual Studio](https://www.visualstudio.com/) and the [dotnet new templates](/dotnet/core/tools/dotnet-new).

Expand Down
19 changes: 10 additions & 9 deletions aspnetcore/publishing/iis.md
Original file line number Diff line number Diff line change
Expand Up @@ -94,21 +94,22 @@ Both `UseKestrel` and `UseIISIntegration` are required. Code calling *UseIISInte

For more information on hosting, see [Hosting in ASP.NET Core](xref:fundamentals/hosting).

### Setting IISOptions for the IISIntegration service
### IIS options

To configure *IISIntegration* service options, include a service configuration for *IISOptions* in *ConfigureServices*.
To configure *IISIntegration* service options, include a service configuration for *IISOptions* in *ConfigureServices*:

```csharp
services.Configure<IISOptions>(options => {
...
services.Configure<IISOptions>(options =>
{
...
});
```

| Option | Setting|
| --- | --- |
| AutomaticAuthentication | If true, the authentication middleware will alter the request user arriving and respond to generic challenges. If false,the authentication middleware will only provide identity and respond to challenges when explicitly indicated by theAuthenticationScheme |
| ForwardClientCertificate | If true and the `MS-ASPNETCORE-CLIENTCERT` request header is present, the `ITLSConnectionFeature` will be populated. |
| ForwardWindowsAuthentication | If true, authentication middleware will attempt to authenticate using platform handler windows authentication. If false, authentication middleware won’t be added. |
| Option | Default | Setting |
| ------------------------------ | ------- | ------- |
| `AutomaticAuthentication` | `true` | If `true`, the authentication middleware sets the `HttpContext.User` and responds to generic challenges. If `false`, the authentication middleware only provides an identity (`HttpContext.User`) and responds to challenges when explicitly requested by the `AuthenticationScheme`. Windows Authentication must be enabled in IIS for `AutomaticAuthentication` to function. |
| `AuthenticationDisplayName` | `null` | Sets the display name shown to users on login pages. |
| `ForwardClientCertificate` | `true` | If `true` and the `MS-ASPNETCORE-CLIENTCERT` request header is present, the `HttpContext.Connection.ClientCertificate` is populated. |

### web.config

Expand Down

0 comments on commit bd34380

Please sign in to comment.