Fetching contributors…
Cannot retrieve contributors at this time
176 lines (148 sloc) 8.49 KB
<?xml version="1.0" encoding="utf-8"?>
For more information on how to configure your ASP.NET application, please visit
<section name="" type="Kudu.SiteManagement.Configuration.Section.KuduConfigurationSection, Kudu.SiteManagement, Version=, Culture=neutral" />
<!-- Settings used everywhere -->
<add key="webpages:Version" value="" />
<add key="webpages:Enabled" value="false" />
<add key="PreserveLoginUrl" value="true" />
<add key="ClientValidationEnabled" value="true" />
<add key="UnobtrusiveJavaScriptEnabled" value="true" />
<!-- Settings used only in Azure Kudu.Web -->
Change enableCustomHostNames to true in order to support end user managed custom hostnames
in addition to the default hostnames for both application and service sites.
This is in addition to custom default hostname option, in that it
allows you to add and manage additional hostnames for an application.
< enableCustomHostNames="false">
<serviceSite path="..\Kudu.Services.Web" />
<applications path="..\apps" />
IIS Shared Configuration
If your IIS config file is in a different location (usually due to running a shared configration) you can specify the
new location like this:
<iisConfigurationFile path="c:\myconfig.config" />
Defining custom host names:
To support custom default hostnames inplace of the localhost and random port usage,
add a bindings section to the configuration.
Values are domain suffixes you wish to have added to the Kudu application name.
So an application binding with the url "" and a Kudu application
called "Test Site" will result in a url of "".
### Bindings Section Example:
<applicationBinding scheme="http" url="" />
<applicationBinding scheme="https" url="" certificate="*" require-sni="true" />
<serviceBinding scheme="http" url="" />
<serviceBinding scheme="https" url="" certificate="*" require-sni="true" />
Note: is an external service that always points to
so the default value below can be used for local testing of the configuration.
There is two types of bindings:
- Application Binding: Adds a binding sufix for the application site for new Kudu applications.
- Service Binding: Adds a binding sufix for the service site for new Kudu applications.
The following attributes are support for binding configurations:
- url: (Required) The url suffix for bindings. Supported formats: - only specify hostname suffix - uses suffix and port 8080 - binds to internal ip, port 80, with hostname suffix
- scheme: The scheme for bindings, either 'http' or 'https', if the attribute is not set, default is 'http'.
- certificate: Friendly name of the certificate to be used for https bindings.
This is required when the scheme is set to 'https', otherwise it has no meaning.
- require-sni: Sets if SNI is required for https bindings.
This is only used for https bindings and is only supported on IIS 8 and above.
### Remarks for IIS 7 Support:
Since IIS 7 does not support SNI (Server Name Indication) there is some limitations on the used certificates when it
comes to support for HTTPS.
This means that IIS 7 requires the use of wildcard certificates.
### Certificate Stores:
By default StoreName.My is used when resolving certificates, but since IIS 8 allows us to use multiple stores, it
is possible to configure which stores to search when resolving certificates.
To do this add a certificateStores configuration block as in the example:
<store name="My" />
<store name="Root" />
A list of valid names can be found at:
Using these settings allows some flexibility in the way IIS bindings are created by default.
### Credential of Basic Authentication
The default credential that used by Kudu.Web is admin/kudu.
It can be changed with following configuration:
<basicAuth username="user" password="password" />
<compilation debug="true" targetFramework="4.6">
<add assembly="System.Web.Abstractions, Version=, Culture=neutral, PublicKeyToken=31BF3856AD364E35" />
<add assembly="System.Web.Helpers, Version=, Culture=neutral, PublicKeyToken=31BF3856AD364E35" />
<add assembly="System.Web.Routing, Version=, Culture=neutral, PublicKeyToken=31BF3856AD364E35" />
<add assembly="System.Web.Mvc, Version=, Culture=neutral, PublicKeyToken=31BF3856AD364E35" />
<add assembly="System.Web.WebPages, Version=, Culture=neutral, PublicKeyToken=31BF3856AD364E35" />
<httpRuntime requestValidationMode="2.0" />
<pages controlRenderingCompatibilityVersion="4.0" />
<validation validateIntegratedModeConfiguration="false" />
<modules runAllManagedModulesForAllRequests="true" />
<!-- Web fonts -->
<remove fileExtension=".eot" />
<remove fileExtension=".svg" />
<remove fileExtension=".ttf" />
<remove fileExtension=".woff" />
<remove fileExtension=".woff2" />
<mimeMap fileExtension=".eot" mimeType="application/" />
<mimeMap fileExtension=".svg" mimeType="image/svg+xml" />
<mimeMap fileExtension=".ttf" mimeType="application/octet-stream" />
<mimeMap fileExtension=".woff" mimeType="application/x-font-woff" />
<mimeMap fileExtension=".woff2" mimeType="font/woff2" />
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<assemblyIdentity name="System.Web.WebPages.Deployment" publicKeyToken="31bf3856ad364e35" />
<bindingRedirect oldVersion="" newVersion="" />
<assemblyIdentity name="System.Web.WebPages.Razor" publicKeyToken="31bf3856ad364e35" />
<bindingRedirect oldVersion="" newVersion="" />
<assemblyIdentity name="System.Web.Razor" publicKeyToken="31bf3856ad364e35" />
<bindingRedirect oldVersion="" newVersion="" />
<assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
<bindingRedirect oldVersion="" newVersion="" />
<assemblyIdentity name="System.Web.Helpers" publicKeyToken="31bf3856ad364e35" />
<bindingRedirect oldVersion="" newVersion="" />
<assemblyIdentity name="System.Web.WebPages" publicKeyToken="31bf3856ad364e35" />
<bindingRedirect oldVersion="" newVersion="" />
<assemblyIdentity name="System.Web.Mvc" publicKeyToken="31bf3856ad364e35" />
<bindingRedirect oldVersion="" newVersion="" />