Updates to MSAL Angular

Dickson-Mwendia · Dickson-Mwendia · commit fbff4f260d88 · 2023-11-29T15:17:40.000+03:00
diff --git a/msal-javascript-conceptual/angular/angular-universal.md b/msal-javascript-conceptual/angular/angular-universal.md
@@ -1,3 +1,14 @@
+---
+title: Angular Universal SSR with MSAL Angular
+description: Angular Universal SSR with MSAL Angular
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
 # Angular Universal SSR with MSAL Angular
 
 Angular Universal is minimally supported in `@azure/msal-angular`. As `@azure/msal-angular` is a wrapper library for `@azure/msal-browser`, which uses browser-only global objects such as `window` and `___location` objects, not all of `@azure/msal-angular`'s features are available when using Angular Universal. While login and token acquisition is not supported server-side, Angular Universal can be used with `@azure/msal-angular` without breaking your app.
diff --git a/msal-javascript-conceptual/angular/configuration.md b/msal-javascript-conceptual/angular/configuration.md
@@ -1,3 +1,14 @@
+---
+title: MSAL Angular Configuration
+description: Learn how to configure your Angular application to use MSAL Angular
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
 # MSAL Angular Configuration
 
 MSAL for Angular can be configured in multiple ways:
diff --git a/msal-javascript-conceptual/angular/errors.md b/msal-javascript-conceptual/angular/errors.md
@@ -1,4 +1,16 @@
-# MSAL Angular Errors
+---
+title: Errors in MSAL Angular
+description: Learn how to deal wth errors in MSAL Angular
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
+
+# Errors in MSAL Angular
 
 ***
 
diff --git a/msal-javascript-conceptual/angular/events.md b/msal-javascript-conceptual/angular/events.md
@@ -1,3 +1,15 @@
+---
+title:  Events in MSAL Angular
+description: Learn more about working with events in MSAL Angular
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
+
 # Events in MSAL Angular
 
 Before you start here, make sure you understand how to [initialize the application object](https://github.com/AzureAD/microsoft-authentication-library-for-js/blob/dev/lib/msal-angular/docs/v2-docs/initialization.md).
diff --git a/msal-javascript-conceptual/angular/initialization.md b/msal-javascript-conceptual/angular/initialization.md
@@ -1,4 +1,15 @@
-# Initialization of MSAL Angular
+---
+title: Initializing MSAL Angular
+description: Learn how to initialize MSAL in your Angular application
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
+# Initializing MSAL Angular
 
 Before using `@azure/msal-angular`, [register an application in Azure AD](https://docs.microsoft.com/azure/active-directory/develop/quickstart-register-app) to get your `clientId`.
 
diff --git a/msal-javascript-conceptual/angular/known-issues.md b/msal-javascript-conceptual/angular/known-issues.md
@@ -1,4 +1,15 @@
-# Known issues for MSAL Angular
+---
+title: Known issues in MSAL Angular
+description: Learn more about known issues in MSAL Angular
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
+# Known issues in MSAL Angular
 
 ## 2.0.0
 * MSAL Guard's `CanLoad` does not interactively prompt for login. This will be addressed in a future release.
diff --git a/msal-javascript-conceptual/angular/logging.md b/msal-javascript-conceptual/angular/logging.md
@@ -1,3 +1,14 @@
+---
+title: Logging in MSAL Angular
+description: Learn about logging in MSAL Angular
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
 # Logging in MSAL Angular
 
 The logger definition has the following properties:
diff --git a/msal-javascript-conceptual/angular/msal-guard.md b/msal-javascript-conceptual/angular/msal-guard.md
@@ -1,4 +1,15 @@
-# MSAL Guard
+---
+title: Using MSAL Guard to protect routes
+description: Learn how to use MSAL Guard to protect routes in your Angular application
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
+# Using MSAL Guard to protect routes
 
 MSAL Angular provides `MsalGuard`, a class you can use to protect routes and require authentication before accessing the protected route. This doc provides more information about configuring and considerations when using the `MsalGuard`.
 
diff --git a/msal-javascript-conceptual/angular/msal-interceptor.md b/msal-javascript-conceptual/angular/msal-interceptor.md
@@ -1,3 +1,15 @@
+---
+title: Using the MSAL Interceptor
+description: Learn how to use the MSAL Interceptor
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
+
 # MSAL Interceptor
 
 MSAL Angular provides an `Interceptor` class that automatically acquires tokens for outgoing requests that use the Angular `http` client to known protected resources. This doc provides more information about the configuring and using the `MsalInterceptor`.
diff --git a/msal-javascript-conceptual/angular/multi-tenant.md b/msal-javascript-conceptual/angular/multi-tenant.md
@@ -1,3 +1,15 @@
+---
+title: Support for multi-tenant applications
+description: Learn more about support for multi-tenant applications in MSAL Angular
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
+
 # Multi-Tenant
 
 By default, there is multi-tenant support for your application since MSAL sets the tenant in the authority to 'common' if it is not specified in the config. This allows any Microsoft account to authenticate to your application. If you are not interested in multi-tenant behavior, you will need to set the `authority` config property when instantiating MSAL in the `app.module.ts` as shown below.
diff --git a/msal-javascript-conceptual/angular/performance.md b/msal-javascript-conceptual/angular/performance.md
@@ -1,6 +1,16 @@
-# Performance
+---
+title: Configure MSAL to use your router for client-side navigation
+description: How to configure MSAL Angular to use your router's navigate function for client-side navigation
+author: Dickson-Mwendia
+manager: CelesteDG
 
-## How to configure `@azure/msal-angular` to use your router's navigate function for client-side navigation
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
+
+# How to configure `@azure/msal-angular` to use your router's navigate function for client-side navigation
 
 By default, when MSAL.js needs to navigate from one page in your application to another it will reassign `window.___location`, causing a full frame redirect to the other page and causing your application to re-render. If you're using the Angular Router this may be undesireable since the Router enables "client-side" navigation and shows or hides only the parts of the page as necessary.
 
@@ -14,7 +24,7 @@ If your application is doing all of the things above you can override the method
 
 **NOTE**: Due to a security fix, the `MsalCustomNavigationClient` will not be using the Angular `Router` to navigate client-side when `navigateToLoginRequestUrl` is set to true and handling redirects. This is a known issue that will be addressed in a future release.
 
-### Example Implementation
+## Example Implementation
 
 The example below will show how to implement this when using the Angular `Router`. More information on the Angular Router can be found [here](https://angular.io/guide/router), and you can find a full sample app that implements this for [Angular here](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/msal-lts/samples/msal-angular-v2-samples/angular10-sample-app).
 
diff --git a/msal-javascript-conceptual/angular/public-apis.md b/msal-javascript-conceptual/angular/public-apis.md
@@ -1,4 +1,16 @@
-# Public APIs for MSAL Angular
+---
+title: Commonly used public APIs in MSAL Angular
+description: Commonly used public APIs in MSAL Angular
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
+
+# Commonly used public APIs in MSAL Angular
 
 Before you start here, make sure you understand how to [initialize the application object](https://github.com/AzureAD/microsoft-authentication-library-for-js/blob/dev/lib/msal-angular/docs/initialization.md).
 
diff --git a/msal-javascript-conceptual/angular/redirects.md b/msal-javascript-conceptual/angular/redirects.md
@@ -1,3 +1,14 @@
+---
+title: Using redirects in MSAL Angular
+description: Learn how to use redirects in MSAL Angular
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
 # Using redirects in MSAL Angular
 
 When using redirects with MSAL, it is **mandatory** to handle redirects with either the `MsalRedirectComponent` or `handleRedirectObservable`. While we recommend `MsalRedirectComponent` as the best approach, both approaches are detailed below.
diff --git a/msal-javascript-conceptual/angular/security.md b/msal-javascript-conceptual/angular/security.md
diff --git a/msal-javascript-conceptual/angular/ssosilent.md b/msal-javascript-conceptual/angular/ssosilent.md
@@ -1,3 +1,15 @@
+---
+title: Silent login with ssoSilent()
+description: Learn how to acquire tokens silently using the `ssoSilent()` API
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
+
 # Silent login with ssoSilent()
 
 If you already have a session that exists with the authentication server, you can use the `ssoSilent()` API to make a request for tokens without interaction.
diff --git a/msal-javascript-conceptual/angular/v0-v1-upgrade-guide.md b/msal-javascript-conceptual/angular/v0-v1-upgrade-guide.md
@@ -1,4 +1,16 @@
-# Upgrading from MSAL Angular v0 to v1
+---
+title: Upgrading from MSAL Angular v0 to v1
+description: Learn how to upgrade applications using MSAL Angular v0 to V1
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
+
+# Migrating from MSAL Angular v0 to v1
 
 MSAL Angular v1 brings our Angular wrapper up-to-date with the latest version of MSAL core, and with out-of-the-box support for modern versions of Angular (6+) and rxjs (6).
 
diff --git a/msal-javascript-conceptual/angular/v1-v2-upgrade-guide.md b/msal-javascript-conceptual/angular/v1-v2-upgrade-guide.md
@@ -1,3 +1,15 @@
+---
+title: Upgrading from MSAL Angular v1 to v2
+description: Learn how to upgrade applications using MSAL Angular v1 to V2
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
+
 # Upgrading from MSAL Angular v1 to v2
 
 MSAL Angular v2 brings our Angular wrapper up-to-date with the latest version of MSAL common, and with out-of-the-box support for modern versions of Angular (9 - 12) and rxjs (6).
diff --git a/msal-javascript-conceptual/angular/v2-v3-upgrade-guide.md b/msal-javascript-conceptual/angular/v2-v3-upgrade-guide.md
@@ -1,3 +1,15 @@
+---
+title: Upgrading from MSAL Angular v2 to v3
+description: Learn how to upgrade applications using MSAL Angular v2 to V3
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: emilylauber
+ms.reviewer: dmwendia,cwerner, owenrichards, kengaderdus
+---
+
 # Upgrading from MSAL Angular v2 to v3
 
 MSAL Angular v3 brings our Angular wrapper up-to-date with the latest version of MSAL common, and with out-of-the-box support for Angular 15 and rxjs 7.
diff --git a/msal-javascript-conceptual/node/accounts.md b/msal-javascript-conceptual/node/accounts.md
@@ -1,3 +1,16 @@
+---
+title: Overview
+description:  Overview of the Microsoft Authentication Libraries for JavaScript
+services: active-directory
+author: Dickson-Mwendia
+manager: CelesteDG
+
+ms.topic: reference
+ms.date: 11/29/2023
+ms.author: dmwendia
+ms.reviewer: emilylauber
+---
+
 # Accounts in MSAL Node
 
 > This is the platform-specific Accounts documentation for `msal-node`. For the general documentation of the `AccountInfo` object structure, please visit the `msal-common` [Accounts document](../../msal-common/docs/Accounts.md).
diff --git a/msal-javascript-conceptual/overview.md b/msal-javascript-conceptual/overview.md
@@ -5,12 +5,10 @@ services: active-directory
 author: Dickson-Mwendia
 manager: CelesteDG
 
-ms.service: active-directory
-ms.subservice: develop
 ms.topic: reference
-ms.workload: identity
-ms.date: 01/10/2023
+ms.date: 11/29/2023
 ms.author: dmwendia
+ms.reviewer: emilylauber
 ---
 # Microsoft Authentication Library for JavaScript (MSAL.js)
 
diff --git a/msal/overview/msal-overview.md b/msal/overview/msal-overview.md
@@ -63,4 +63,6 @@ All of our libraries follow [semantic versioning](https://semver.org). We recomm
 
 ## Security reporting
 
-If you find a security issue with our libraries or services [please report it to the Microsoft Security Response Center (MSRC)](https://aka.ms/report-security-issue) with as much detail as possible. Your submission may be eligible for a bounty through the [Microsoft Bounty](https://aka.ms/bugbounty) program. Please do not post security issues to GitHub Issues or any other public site. We will contact you shortly upon receiving the information. If you'd like to get notifications of when security incidents occur, [subscribe to security advisory alerts](https://msrc-blog.microsoft.com/2022/08/09/security-update-guide-notification-system-news-create-your-profile-now/).
+If you find a security issue with our libraries or services [please report it to the Microsoft Security Response Center (MSRC)](https://aka.ms/report-security-issue) with as much detail as possible. Your submission may be eligible for a bounty through the [Microsoft Bounty](https://aka.ms/bugbounty) program. Please do not post security issues to GitHub Issues or any other public site. We will contact you shortly upon receiving the information. If you'd like to get notifications of when security incidents occur, [subscribe to security advisory alerts](https://msrc-blog.microsoft.com/2022/08/09/security-update-guide-notification-system-news-create-your-profile-now/).
+
+
