diff --git a/aspnetcore/getting-started/index.md b/aspnetcore/getting-started/index.md index e1609c69c46d..5f8d5763807c 100644 --- a/aspnetcore/getting-started/index.md +++ b/aspnetcore/getting-started/index.md @@ -1,21 +1,21 @@ --- title: Get started with ASP.NET Core author: rick-anderson -description: A quick tutorial that creates and runs a simple Hello World app using ASP.NET Core. +description: A short tutorial that creates and runs a basic Hello World app using ASP.NET Core. ms.author: riande ms.custom: mvc -ms.date: 01/15/2019 +ms.date: 5/15/2019 uid: getting-started --- # Tutorial: Get started with ASP.NET Core -This tutorial shows how to use the .NET Core command-line interface to create an ASP.NET Core web app. +This tutorial shows how to use the .NET Core command-line interface to create and run an ASP.NET Core web app. You'll learn how to: > [!div class="checklist"] > * Create a web app project. -> * Enable local HTTPS. +> * Trust the development certificate. > * Run the app. > * Edit a Razor page. @@ -35,7 +35,7 @@ Open a command shell, and enter the following command: dotnet new webapp -o aspnetcoreapp ``` -## Enable local HTTPS +### Trust the development certificate Trust the HTTPS development certificate: @@ -65,6 +65,8 @@ This command might prompt you for your password to install the certificate on th # [Linux](#tab/linux) +For Windows Subsystem for Linux, see [Trust HTTPS certificate from Windows Subsystem for Linux](xref:security/enforcing-ssl#wsl). + See the documentation for your Linux distribution on how to trust the HTTPS development certificate. --- @@ -96,7 +98,7 @@ In this tutorial, you learned how to: > [!div class="checklist"] > * Create a web app project. -> * Enable local HTTPS. +> * Trust the development certificate. > * Run the project. > * Make a change. diff --git a/aspnetcore/security/enforcing-ssl.md b/aspnetcore/security/enforcing-ssl.md index 7fc273549b2e..e3fe4e9b1bc7 100644 --- a/aspnetcore/security/enforcing-ssl.md +++ b/aspnetcore/security/enforcing-ssl.md @@ -252,6 +252,19 @@ See [this GitHub issue](https://github.com/aspnet/AspNetCore.Docs/issues/6199). ::: moniker-end + + +## Trust HTTPS certificate from Windows Subsystem for Linux + +The Windows Subsystem for Linux (WSL) generates a HTTPS self-signed cert. To configure the Windows certificate store to trust the WSL certificate: + +* Run the following command to export the WSL generated certificate: + `dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\aspnetapp.pfx -p ` +* In a WSL window, run the following command: + `ASPNETCORE_Kestrel__Certificates__Default__Password="" ASPNETCORE_Kestrel__Certificates__Default__Path=/mnt/c/Users/user-name/.aspnet/https/aspnetapp.pfx dotnet watch run` + + The preceding command sets the environment variables so Linux uses the Windows trusted certificate. + ## Additional information *