Merge branch 'main' into main

4gust · web-flow · commit 1f88b0b8bd43 · 2024-10-14T14:59:10.000+01:00
diff --git a/1-Authentication/0-sign-in-vanillajs/README.md b/1-Authentication/0-sign-in-vanillajs/README.md
@@ -63,7 +63,9 @@ Here you'll learn about [ID Tokens](https://docs.microsoft.com/azure/active-dire
 * [Visual Studio Code](https://code.visualstudio.com/download) is recommended for running and editing this sample.
 * [VS Code Azure Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-node-azure-pack) extension is recommended for interacting with Azure through VS Code Interface.
 * A modern web browser.
-* An external tenant. For more information, see: [Create a new external tenant in Microsoft Entra ID](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal)
+* An external tenant. To create one, choose from the following methods:
+    * (Recommended) Use the [Microsoft Entra External ID extension](https://aka.ms/ciamvscode/readme/marketplace) to set up an external tenant directly in Visual Studio Code.
+    * [Create a new external tenant](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal) in the Microsoft Entra admin center.
 * A user account with permissions to an external tenant.
 
 ## Setup the sample
diff --git a/1-Authentication/1-sign-in-react/README.md b/1-Authentication/1-sign-in-react/README.md
@@ -62,8 +62,10 @@ Here you'll learn how to [sign-in](https://docs.microsoft.com/azure/active-direc
 * [Node.js](https://nodejs.org/en/download/) must be installed to run this sample.
 * [Visual Studio Code](https://code.visualstudio.com/download) is recommended for running and editing this sample.
 * [VS Code Azure Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-node-azure-pack) extension is recommended for interacting with Azure through VS Code Interface.
- * An external tenant. For more information, see: [Create a new external tenant in Microsoft Entra ID]https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal)
-* A user an external tenant.
+* An external tenant. To create one, choose from the following methods:
+    * (Recommended) Use the [Microsoft Entra External ID extension](https://aka.ms/ciamvscode/readme/marketplace) to set up an external tenant directly in Visual Studio Code.
+    * [Create a new external tenant](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal) in the Microsoft Entra admin center.
+* A user account with permissions to an external tenant.
 
 >This sample will not work with a **personal Microsoft account**. If you're signed in to the [Microsoft Entra admin center](https://entra.microsoft.com/) with a personal Microsoft account and have not created a user account in your directory before, you will need to create one before proceeding.
 
diff --git a/1-Authentication/1-sign-in-react/SPA/package-lock.json b/1-Authentication/1-sign-in-react/SPA/package-lock.json
diff --git a/1-Authentication/1-sign-in-react/package-lock.json b/1-Authentication/1-sign-in-react/package-lock.json
diff --git a/1-Authentication/2-sign-in-angular/README.md b/1-Authentication/2-sign-in-angular/README.md
@@ -62,7 +62,9 @@ Here you'll learn about [ID Tokens](https://docs.microsoft.com/azure/active-dire
 * [Visual Studio Code](https://code.visualstudio.com/download) is recommended for running and editing this sample.
 * [VS Code Azure Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-node-azure-pack) extension is recommended for interacting with Azure through VS Code Interface.
 * A modern web browser.
-* An external tenant. For more information, see: [Create a new external tenant in Microsoft Entra ID](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal)
+* An external tenant. To create one, choose from the following methods:
+    * (Recommended) Use the [Microsoft Entra External ID extension](https://aka.ms/ciamvscode/readme/marketplace) to set up an external tenant directly in Visual Studio Code.
+    * [Create a new external tenant](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal) in the Microsoft Entra admin center.
 * A user account in your external tenant.
 
 >This sample will not work with a **personal Microsoft account**. If you're signed in to the [Microsoft Entra admin center](https://entra.microsoft.com/) with a personal Microsoft account and have not created a user account in your directory before, you will need to create one before proceeding.
diff --git a/1-Authentication/3-sign-in-electron/.vscode/extensions.json b/1-Authentication/3-sign-in-electron/.vscode/extensions.json
@@ -1,6 +1,5 @@
 {
-    // See http://go.microsoft.com/fwlink/?LinkId=827846
-    // for the documentation about the extensions.json format
-    "recommendations": ["ms-azuretools.ms-entra"]
-  }
-  
+  // See http://go.microsoft.com/fwlink/?LinkId=827846
+  // for the documentation about the extensions.json format
+  "recommendations": ["ms-azuretools.ms-entra"]
+}
diff --git a/1-Authentication/3-sign-in-electron/README.md b/1-Authentication/3-sign-in-electron/README.md
@@ -68,8 +68,10 @@ Here you'll learn how to sign-in users and acquire [ID tokens](https://docs.micr
 * [Visual Studio Code](https://code.visualstudio.com/download) is recommended for running and editing this sample.
 * [VS Code Azure Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-node-azure-pack) extension is recommended for interacting with Azure through VS Code Interface.
 * A modern web browser.
- * An external tenant. For more information, see: [Create a new external tenant in Microsoft Entra ID](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal)
-* A user an external tenant.
+* An external tenant. To create one, choose from the following methods:
+    * (Recommended) Use the [Microsoft Entra External ID extension](https://aka.ms/ciamvscode/readme/marketplace) to set up an external tenant directly in Visual Studio Code.
+    * [Create a new external tenant](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal) in the Microsoft Entra admin center.
+* A user account with permissions to an external tenant.
 
 >This sample will not work with a **personal Microsoft account**. If you're signed in to the [Microsoft Entra admin center](https://entra.microsoft.com/) with a personal Microsoft account and have not created a user account in your directory before, you will need to create one before proceeding.
 
diff --git a/1-Authentication/4-sign-in-device-code/.vscode/extensions.json b/1-Authentication/4-sign-in-device-code/.vscode/extensions.json
@@ -0,0 +1,5 @@
+{
+  // See http://go.microsoft.com/fwlink/?LinkId=827846
+  // for the documentation about the extensions.json format
+  "recommendations": ["ms-azuretools.ms-entra"]
+}
diff --git a/1-Authentication/4-sign-in-device-code/README.md b/1-Authentication/4-sign-in-device-code/README.md
@@ -54,8 +54,10 @@ This sample demonstrates a Node headless application that authenticates users wi
 
 ## Prerequisites
 
- * An external tenant. For more information, see: [Create a new external tenant in Microsoft Entra ID](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal)
-* A user an external tenant.
+* An external tenant. To create one, choose from the following methods:
+    * (Recommended) Use the [Microsoft Entra External ID extension](https://aka.ms/ciamvscode/readme/marketplace) to set up an external tenant directly in Visual Studio Code.
+    * [Create a new external tenant](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal) in the Microsoft Entra admin center.
+* A user account with permissions to an external tenant.
 
 >This sample will not work with a **personal Microsoft account**. If you're signed in to the [Microsoft Entra admin center](https://entra.microsoft.com/) with a personal Microsoft account and have not created a user account in your directory before, you will need to create one before proceeding.
 
diff --git a/1-Authentication/5-sign-in-express/.vscode/extensions.json b/1-Authentication/5-sign-in-express/.vscode/extensions.json
@@ -3,4 +3,4 @@
     // for the documentation about the extensions.json format
     "recommendations": ["ms-azuretools.ms-entra"]
   }
-  
+  
diff --git a/1-Authentication/5-sign-in-express/README.md b/1-Authentication/5-sign-in-express/README.md
@@ -64,7 +64,9 @@ This sample demonstrates how to sign users into a sample Node.js & Express web a
 
 * You must install [Node.js](https://nodejs.org/en/download/) in your computer to run this sample.
 * We recommend [Visual Studio Code](https://code.visualstudio.com/download) for running and editing this sample.
-* Microsoft Entra ID for customers tenant. If you don't already have one, [sign up for a free trial](https://aka.ms/ciam-free-trial).
+* An external tenant. To create one, choose from the following methods:
+    * (Recommended) Use the [Microsoft Entra External ID extension](https://aka.ms/ciamvscode/readme/marketplace) to set up an external tenant directly in Visual Studio Code.
+    * [Create a new external tenant](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal) in the Microsoft Entra admin center.
 * If you'd like to use Azure services, such as hosting your app in Azure App Service, [VS Code Azure Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-node-azure-pack) extension is recommended for interacting with Azure through VS Code Interface.
 
 ## Register the web application in your tenant
diff --git a/1-Authentication/6-sign-in-node-cli-app/.vscode/extensions.json b/1-Authentication/6-sign-in-node-cli-app/.vscode/extensions.json
@@ -3,4 +3,4 @@
     // for the documentation about the extensions.json format
     "recommendations": ["ms-azuretools.ms-entra"]
   }
-  
+  
diff --git a/1-Authentication/6-sign-in-node-cli-app/README.md b/1-Authentication/6-sign-in-node-cli-app/README.md
@@ -61,8 +61,10 @@ Here you'll learn how to sign-in users and acquire [ID tokens](https://docs.micr
 * [Visual Studio Code](https://code.visualstudio.com/download) is recommended for running and editing this sample.
 * [VS Code Azure Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-node-azure-pack) extension is recommended for interacting with Azure through VS Code Interface.
 * A modern web browser.
- * An external tenant. For more information, see: [Create a new external tenant in Microsoft Entra ID](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal)
-* A user an external tenant.
+* An external tenant. To create one, choose from the following methods:
+    * (Recommended) Use the [Microsoft Entra External ID extension](https://aka.ms/ciamvscode/readme/marketplace) to set up an external tenant directly in Visual Studio Code.
+    * [Create a new external tenant](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal) in the Microsoft Entra admin center.
+* A user account with permissions to an external tenant.
 
 ## Setup the sample
 
diff --git a/1-Authentication/7-sign-in-express-mfa/README.md b/1-Authentication/7-sign-in-express-mfa/README.md
@@ -63,10 +63,13 @@ This sample demonstrates how to sign in users and edit profile in Node.js. The e
 
 ## Prerequisites
 
-- You must install [Node.js](https://nodejs.org/en/download/) in your computer to run this sample.
-- We recommend [Visual Studio Code](https://code.visualstudio.com/download) for running and editing this sample.
-- An external tenant. If you don't already have one, [sign up for a free trial](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal).
-- If you'd like to use Azure services, such as hosting your app in Azure App Service, [VS Code Azure Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-node-azure-pack) extension is recommended for interacting with Azure through VS Code Interface.
+* You must install [Node.js](https://nodejs.org/en/download/) in your computer to run this sample.
+* We recommend [Visual Studio Code](https://code.visualstudio.com/download) for running and editing this sample.
+* An external tenant. To create one, choose from the following methods:
+    * (Recommended) Use the [Microsoft Entra External ID extension](https://aka.ms/ciamvscode/readme/marketplace) to set up an external tenant directly in Visual Studio Code.
+    * [Create a new external tenant](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal) in the Microsoft Entra admin center.
+* If you'd like to use Azure services, such as hosting your app in Azure App Service, [VS Code Azure Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-node-azure-pack) extension is recommended for interacting with Azure through VS Code Interface.
+
 
 ## Prepare your tenant
 
diff --git a/2-Authorization/0-call-api-vanillajs/README.md b/2-Authorization/0-call-api-vanillajs/README.md
@@ -70,8 +70,10 @@ Here you'll learn about [access tokens](https://docs.microsoft.com/azure/active-
 * [Visual Studio Code](https://code.visualstudio.com/download) is recommended for running and editing this sample.
 * [VS Code Azure Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-node-azure-pack) extension is recommended for interacting with Azure through VS Code Interface.
 * A modern web browser.
- * An external tenant. For more information, see: [Create a new external tenant in Microsoft Entra ID](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal)
-* A user an external tenant.
+* An external tenant. To create one, choose from the following methods:
+    * (Recommended) Use the [Microsoft Entra External ID extension](https://aka.ms/ciamvscode/readme/marketplace) to set up an external tenant directly in Visual Studio Code.
+    * [Create a new external tenant](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal) in the Microsoft Entra admin center.
+* A user account with permissions to an external tenant.
 
 ## Setup the sample
 
diff --git a/2-Authorization/1-call-api-react/README.md b/2-Authorization/1-call-api-react/README.md
@@ -67,8 +67,10 @@ Here you'll learn about [access tokens](https://docs.microsoft.com/azure/active-
 ## Prerequisites
 
 * Either [Visual Studio](https://visualstudio.microsoft.com/downloads/) or [Visual Studio Code](https://code.visualstudio.com/download) and [.NET Core SDK](https://www.microsoft.com/net/learn/get-started)
- * An external tenant. For more information, see: [Create a new external tenant in Microsoft Entra ID](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal)
-* A user an external tenant.
+* An external tenant. To create one, choose from the following methods:
+    * (Recommended) Use the [Microsoft Entra External ID extension](https://aka.ms/ciamvscode/readme/marketplace) to set up an external tenant directly in Visual Studio Code.
+    * [Create a new external tenant](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal) in the Microsoft Entra admin center.
+* A user account with permissions to an external tenant.
 
 ## Setup the sample
 
diff --git a/2-Authorization/2-call-api-angular/README.md b/2-Authorization/2-call-api-angular/README.md
@@ -69,7 +69,9 @@ Here you'll learn about [access tokens](https://docs.microsoft.com/azure/active-
 ## Prerequisites
 
 * Either [Visual Studio](https://visualstudio.microsoft.com/downloads/) or [Visual Studio Code](https://code.visualstudio.com/download) and [.NET Core SDK](https://www.microsoft.com/net/learn/get-started)
-* An external tenant. For more information, see: [Create a new external tenant in Microsoft Entra ID](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal)
+* An external tenant. To create one, choose from the following methods:
+    * (Recommended) Use the [Microsoft Entra External ID extension](https://aka.ms/ciamvscode/readme/marketplace) to set up an external tenant directly in Visual Studio Code.
+    * [Create a new external tenant](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal) in the Microsoft Entra admin center.
 * A user account with permissions to an external tenant.
 
 ## Setup the sample
diff --git a/2-Authorization/3-call-api-node-daemon/README.md b/2-Authorization/3-call-api-node-daemon/README.md
@@ -67,9 +67,10 @@ Here you'll learn about [access tokens](https://docs.microsoft.com/azure/active-
 ## Prerequisites
 
 * Either [Visual Studio](https://visualstudio.microsoft.com/downloads/) or [Visual Studio Code](https://code.visualstudio.com/download) and [.NET Core SDK](https://www.microsoft.com/net/learn/get-started)
-* An external tenant. For more information, see: [Create a new external tenant in Microsoft Entra ID](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal)
-* A user an external tenant.
-
+* An external tenant. To create one, choose from the following methods:
+    * (Recommended) Use the [Microsoft Entra External ID extension](https://aka.ms/ciamvscode/readme/marketplace) to set up an external tenant directly in Visual Studio Code.
+    * [Create a new external tenant](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal) in the Microsoft Entra admin center.
+* A user account with permissions to an external tenant.
 ## Setup the sample
 
 ### Step 1: Clone or download this repository
diff --git a/2-Authorization/4-call-api-express/README.md b/2-Authorization/4-call-api-express/README.md
@@ -67,8 +67,10 @@ Here you'll learn about [access tokens](https://docs.microsoft.com/azure/active-
 ## Prerequisites
 
 * Either [Visual Studio](https://visualstudio.microsoft.com/downloads/) or [Visual Studio Code](https://code.visualstudio.com/download) and [.NET Core SDK](https://www.microsoft.com/net/learn/get-started)
-* An external tenant. For more information, see: [Create a new external tenant in Microsoft Entra ID](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal)
-* A user an external tenant.
+* An external tenant. To create one, choose from the following methods:
+    * (Recommended) Use the [Microsoft Entra External ID extension](https://aka.ms/ciamvscode/readme/marketplace) to set up an external tenant directly in Visual Studio Code.
+    * [Create a new external tenant](https://learn.microsoft.com/entra/external-id/customers/how-to-create-external-tenant-portal) in the Microsoft Entra admin center.
+* A user account with permissions to an external tenant.
 
 ## Setup the sample
 

Original file line number	Diff line number	Diff line change
`@@ -3,4 +3,4 @@`
`3`	`3`	`// for the documentation about the extensions.json format`
`4`	`4`	`"recommendations": ["ms-azuretools.ms-entra"]`
`5`	`5`	`}`
`6`		`-`
	`6`	`+`