Merge pull request #97 from BenBagBag/msal-js-documentation-update

Msal js documentation update

Author: iambmelt

1-Authentication/0-sign-in-vanillajs/App/package.json

@@ -1,7 +1,7 @@
 {
     "name": "ciam-sign-in-javascript",
     "version": "1.0.0",
-    "description": "Vanilla JavaScript single-page application using MSAL.js to authenticate users against Azure AD Customer Identity Access Management (Azure AD for Customers)",
+    "description": "Vanilla JavaScript single-page application using MSAL.js to authenticate users against Microsoft Entra External ID",
     "main": "server.js",
     "scripts": {
         "start": "node server.js",

1-Authentication/0-sign-in-vanillajs/App/public/authConfig.js

@@ -7,7 +7,7 @@ const msalConfig = {
     auth: {
         clientId: 'Enter_the_Application_Id_Here', // This is the ONLY mandatory field that you need to supply.
         authority: 'https://Enter_the_Tenant_Subdomain_Here.ciamlogin.com/', // Replace the placeholder with your tenant subdomain        
-        redirectUri: 'http://localhost:3000/redirect', // You must register this URI on Azure Portal/App Registration. Defaults to window.location.href e.g. http://localhost:3000/
+        redirectUri: 'http://localhost:3000/redirect', // You must register this URI on Microsoft Entra admin center/App Registration. Defaults to window.location.href e.g. http://localhost:3000/
         navigateToLoginRequestUrl: true, // If "true", will navigate back to the original request location before processing the auth code response.
     },
     cache: {

1-Authentication/0-sign-in-vanillajs/App/public/claimUtils.js

@@ -14,7 +14,7 @@ const createClaimsTable = (claims) => {
                 populateClaim(
                     key,
                     claims[key],
-                    "Identifies the intended recipient of the token. In ID tokens, the audience is your app's Application ID, assigned to your app in the Azure portal.",
+                    "Identifies the intended recipient of the token. In ID tokens, the audience is your app's Application ID, assigned to your app in the Microsoft Entra admin center.",
                     index,
                     claimsObj
                 );
@@ -24,7 +24,7 @@ const createClaimsTable = (claims) => {
                 populateClaim(
                     key,
                     claims[key],
-                    'Identifies the issuer, or authorization server that constructs and returns the token. It also identifies the Azure AD tenant for which the user was authenticated. If the token was issued by the v2.0 endpoint, the URI will end in /v2.0. The GUID that indicates that the user is a consumer user from a Microsoft account is 9188040d-6c67-4c5b-b112-36a304b66dad.',
+                    'Identifies the issuer, or authorization server that constructs and returns the token. It also identifies the external tenant for which the user was authenticated. If the token was issued by the v2.0 endpoint, the URI will end in /v2.0. The GUID that indicates that the user is a consumer user from a Microsoft account is 9188040d-6c67-4c5b-b112-36a304b66dad.',
                     index,
                     claimsObj
                 );
@@ -94,7 +94,7 @@ const createClaimsTable = (claims) => {
                 populateClaim(
                     key,
                     claims[key],
-                    'The oid (user’s object id) is the only claim that should be used to uniquely identify a user in an Azure AD tenant. The token might have one or more of the following claim, that might seem like a unique identifier, but is not and should not be used as such.',
+                    'The oid (user’s object id) is the only claim that should be used to uniquely identify a user in an external tenant. The token might have one or more of the following claim, that might seem like a unique identifier, but is not and should not be used as such.',
                     index,
                     claimsObj
                 );
@@ -104,7 +104,7 @@ const createClaimsTable = (claims) => {
                 populateClaim(
                     key,
                     claims[key],
-                    'The tenant ID. You will use this claim to ensure that only users from the current Azure AD tenant can access this app.',
+                    'The tenant ID. You will use this claim to ensure that only users from the current external tenant can access this app.',
                     index,
                     claimsObj
                 );

1-Authentication/0-sign-in-vanillajs/App/public/signout.html

@@ -3,7 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Azure AD | Vanilla JavaScript SPA</title>
+    <title>Microsoft Entra External ID | Vanilla JavaScript SPA</title>
     <link rel="SHORTCUT ICON" href="./favicon.svg" type="image/x-icon">
 
     <!-- adding Bootstrap 4 for UI components  -->

1-Authentication/0-sign-in-vanillajs/AppCreationScripts/AppCreationScripts.md

@@ -28,17 +28,17 @@
 
 ### Presentation of the scripts
 
-This sample comes with two PowerShell scripts, which automate the creation of the Azure Active Directory applications, and the configuration of the code for this sample. Once you run them, you will only need to build the solution and you are good to test.
+This sample comes with two PowerShell scripts, which automate the creation of the Microsoft Entra applications, and the configuration of the code for this sample. Once you run them, you will only need to build the solution and you are good to test.
 
 These scripts are:
 
 - `Configure.ps1` which:
-  - creates Azure AD applications and their related objects (permissions, dependencies, secrets, app roles),
+  - creates Microsoft Entra applications and their related objects (permissions, dependencies, secrets, app roles),
   - changes the configuration files in the sample projects.
   - creates a summary file named `createdApps.html` in the folder from which you ran the script, and containing, for each Azure AD application it created:
     - the identifier of the application
     - the AppId of the application
-    - the url of its registration in the [Azure portal](https://portal.azure.com).
+    - the url of its registration in the [Microsoft Entra admin center](https://entra.microsoft.com/).
 
 - `Cleanup.ps1` which cleans-up the Azure AD objects created by `Configure.ps1`. Note that this script does not revert the changes done in the configuration files, though. You will need to undo the change from source control (from Visual Studio, or from the command line using, for instance, `git reset`).
 
@@ -108,10 +108,9 @@ Note that the script will choose the tenant in which to create the applications,
 
   if you want to create the apps in a particular tenant, you can use the following option:
   
-- Open the [Azure portal](https://portal.azure.com)
-- Select the Azure Active directory you are interested in (in the combo-box below your name on the top right of the browser window)
-- Find the "Active Directory" object in this tenant
-- Go to **Properties** and copy the content of the **Directory Id** property
+- Open the [Microsoft Entra admin center](https://entra.microsoft.com/)
+- Select the Microsoft Entra tenant you are interested in (in the combo-box below your name on the top right of the browser window)
+- Select **Overview** on the left side menu and then select the **Overview** tab. Copy the content of the **Tenant Id** property
 - Then use the full syntax to run the scripts:
 
 ```PowerShell

1-Authentication/0-sign-in-vanillajs/AppCreationScripts/Cleanup.ps1

@@ -18,11 +18,11 @@ Function Cleanup
 
     <#
     .Description
-    This function removes the Azure AD applications for the sample. These applications were created by the Configure.ps1 script
+    This function removes the Microsoft Entra applications for the sample. These applications were created by the Configure.ps1 script
     #>
 
-    # $tenantId is the Active Directory Tenant. This is a GUID which represents the "Directory ID" of the AzureAD tenant 
-    # into which you want to create the apps. Look it up in the Azure portal in the "Properties" of the Azure AD. 
+    # $tenantId is the Microsoft Entra Tenant. This is a GUID which represents the "Directory ID" of the AzureAD tenant 
+    # into which you want to create the apps. Look it up in the Microsoft Entra admin center in the "Properties" of the Azure AD. 
 
     # Connect to the Microsoft Graph API
     Write-Host "Connecting to Microsoft Graph"

1-Authentication/0-sign-in-vanillajs/AppCreationScripts/Configure.ps1

@@ -9,8 +9,8 @@ param(
 )
 
 <#
- This script creates the Azure AD applications needed for this sample and updates the configuration files
- for the visual Studio projects from the data in the Azure AD applications.
+ This script creates the Microsoft Entra applications needed for this sample and updates the configuration files
+ for the visual Studio projects from the data in the Microsoft Entra applications.
 
  In case you don't have Microsoft.Graph.Applications already installed, the script will automatically install it for the current user
  
@@ -173,7 +173,7 @@ Function CreateOptionalClaim([string] $name)
 Function ConfigureApplications
 {
     <#.Description
-       This function creates the Azure AD applications for the sample in the provided Azure AD tenant and updates the
+       This function creates the Microsoft Entra applications for the sample in the provided external tenant and updates the
        configuration files in the client and service project  of the visual studio solution (App.Config and Web.Config)
        so that they are consistent with the Applications parameters
     #> 
@@ -251,7 +251,7 @@ Function ConfigureApplications
     Update-MgApplication -ApplicationId $currentAppObjectId -OptionalClaims $optionalClaims
     Write-Host "Done creating the client application (ciam-msal-javascript-spa)"
 
-    # URL of the AAD application in the Azure portal
+    # URL of the AAD application in the Microsoft Entra admin center
     # Future? $clientPortalUrl = "https://portal.azure.com/#@"+$tenantName+"/blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Overview/appId/"+$currentAppId+"/objectId/"+$currentAppObjectId+"/isMSAApp/"
     $clientPortalUrl = "https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/~/Overview/appId/"+$currentAppId+"/isMSAApp~/false"
 
@@ -289,7 +289,7 @@ Function ConfigureApplications
 
     ReplaceInTextFile -configFilePath $configFile -dictionary $dictionary
     Write-Host -ForegroundColor Green "------------------------------------------------------------------------------------------------" 
-    Write-Host "IMPORTANT: Please follow the instructions below to complete a few manual step(s) in the Azure portal":
+    Write-Host "IMPORTANT: Please follow the instructions below to complete a few manual step(s) in the Microsoft Entra admin center":
     Write-Host "- For client"
     Write-Host "  - Navigate to $clientPortalUrl"
     Write-Host "  - Navigate to your tenant and create user flows to allow users to sign up for the application." -ForegroundColor Red 
@@ -338,7 +338,7 @@ if ($null -eq (Get-Module -ListAvailable -Name "Microsoft.Graph.Users")) {
 Import-Module Microsoft.Graph.Users
 
 Set-Content -Value "<html><body><table>" -Path createdApps.html
-Add-Content -Value "<thead><tr><th>Application</th><th>AppId</th><th>Url in the Azure portal</th></tr></thead><tbody>" -Path createdApps.html
+Add-Content -Value "<thead><tr><th>Application</th><th>AppId</th><th>Url in the Microsoft Entra admin center</th></tr></thead><tbody>" -Path createdApps.html
 
 $ErrorActionPreference = "Stop"
 

1-Authentication/0-sign-in-vanillajs/AppCreationScripts/apps.json

@@ -1,6 +1,6 @@
 {
     "Sample": {
-        "Title": "A JavaScript single-page application using MSAL Angular to authenticate users against Azure AD for Customers",
+        "Title": "A JavaScript single-page application using MSAL Angular to authenticate users against Microsoft Entra External ID",
         "Client": "SinglePageApplication",
         "Level": 100
     },

1-Authentication/0-sign-in-vanillajs/AppCreationScripts/quickstart.md

@@ -14,7 +14,7 @@ ms.date: 04/19/2023
 ---
 # Portal quickstart for JavaScript SPA
 
-> In this quickstart, you download and run a code sample that demonstrates how a JavaScript SPA that can sign in users with Azure AD for Customers.
+> In this quickstart, you download and run a code sample that demonstrates how a JavaScript SPA that can sign in users with Microsoft Entra External ID.
 >
 > [!div renderon="portal" id="display-on-portal" class="sxs-lookup"]
 >

1-Authentication/0-sign-in-vanillajs/AppCreationScripts/sample.json

@@ -1,14 +1,14 @@
 {
     "Sample": {
-        "Title": "Vanilla JavaScript single-page application using MSAL.js to authenticate users against Customer Identity Access Management (CIAM)",
+        "Title": "Vanilla JavaScript single-page application using MSAL.js to authenticate users against Microsoft Entra External ID",
         "Level": 100,
         "Client": "Vanilla JavaScript SPA",
         "RepositoryUrl": "ms-identity-ciam-javascript-tutorial",
         "Endpoint": "AAD v2.0",
         "Languages": [
             "javascript"
         ],
-        "Description": "Vanilla JavaScript single-page application using MSAL.js to authenticate users against Customer Identity Access Management (CIAM)",
+        "Description": "Vanilla JavaScript single-page application using MSAL.js to authenticate users against Microsoft Entra External ID",
         "Products": [
             "azure-active-directory",
             "msal-js",