Merge pull request #248332 from shlipsey3/recommendation-adal-081523

recommendation-adal-081523

Author: prmerger-automator[bot]

articles/active-directory/reports-monitoring/recommendation-migrate-from-adal-to-msal.md

@@ -1,18 +1,16 @@
 ---
-title: Azure Active Directory recommendation - Migrate from ADAL to MSAL | Microsoft Docs
+title: Migrate from ADAL to MSAL recommendation
 description: Learn why you should migrate from the Azure Active Directory Library to the Microsoft Authentication Libraries.
 services: active-directory
 author: shlipsey3
 manager: amycolannino
 ms.service: active-directory
 ms.topic: reference
-ms.workload: identity
+ms.workload: identityr
 ms.subservice: report-monitor
-ms.date: 08/10/2023
+ms.date: 08/15/2023
 ms.author: sarahlipsey
 ms.reviewer: jamesmantu
-
-ms.collection: M365-identity-device-management
 ---
 
 # Azure AD recommendation: Migrate from the Azure Active Directory Library to the Microsoft Authentication Libraries
@@ -37,25 +35,16 @@ Existing apps that use ADAL will continue to work after the end-of-support date.
 
 ## Action plan
 
-The first step to migrating your apps from ADAL to MSAL is to identify all applications in your tenant that are currently using ADAL. You can identify your apps in the Azure portal or programmatically with the Microsoft Graph API or the Microsoft Graph PowerShell SDK.
-
-### [Azure portal](#tab/Azure-portal)
-
-There are four steps to identifying and updating your apps in the Azure portal. The following steps are covered in detail in the [List all apps using ADAL](../develop/howto-get-list-of-all-auth-library-apps.md) article. 
-
-1. Send Azure AD sign-in event to Azure Monitor.
-1. [Access the sign-ins workbook in Azure AD.](../develop/howto-get-list-of-all-auth-library-apps.md)
-1. Identify the apps that use ADAL.
-1. Update your code.
-    - The steps to update your code vary depending on the type of application.
-    - For example, the steps for .NET and Python applications have separate instructions.
-    - For a full list of instructions for each scenario, see [How to migrate to MSAL](../develop/msal-migration.md#how-to-migrate-to-msal).
+The first step to migrating your apps from ADAL to MSAL is to identify all applications in your tenant that are currently using ADAL. You can identify your apps programmatically with the Microsoft Graph API or the Microsoft Graph PowerShell SDK. The steps for the Microsoft Graph PowerShell SDK are provided in the Recommendation details in the Azure Active Directory portal.
 
 ### [Microsoft Graph API](#tab/Microsoft-Graph-API)
 
 You can use Microsoft Graph to identify apps that need to be migrated to MSAL. To get started, see [How to use Microsoft Graph with Azure AD recommendations](howto-use-recommendations.md#how-to-use-microsoft-graph-with-azure-active-directory-recommendations).
 
-Run the following query in Microsoft Graph, replacing the `<TENANT_ID>` placeholder with your tenant ID. This query returns a list of the impacted resources in your tenant.
+1. Sign in to [Graph Explorer](https://aka.ms/ge).
+1. Select **GET** as the HTTP method from the dropdown.
+1. Set the API version to **beta**.
+1. Run the following query in Microsoft Graph, replacing the `<TENANT_ID>` placeholder with your tenant ID. This query returns a list of the impacted resources in your tenant.
 
 ```http
 https://graph.microsoft.com/beta/directory/recommendations/<TENANT_ID>_Microsoft.Identity.IAM.Insights.AdalToMsalMigration/impactedResources
@@ -108,6 +97,7 @@ You can run the following set of commands in Windows PowerShell. These commands
 
 ---
 
+
 ## Frequently asked questions
 
 ### Why does it take 30 days to change the status to completed?
@@ -116,7 +106,7 @@ To reduce false positives, the service uses a 30 day window for ADAL requests. T
 
 ### How were ADAL applications identified before the recommendation was released?
 
-The [Azure AD sign-ins workbook](../develop/howto-get-list-of-all-auth-library-apps.md) is an alternative method to identify these apps. The workbook is still available to you, but using the workbook requires streaming sign-in logs to Azure Monitor first. The ADAL to MSAL recommendation works out of the box. Plus, the sign-ins workbook does not capture Service Principal sign-ins, while the recommendation does.
+The [Azure AD sign-ins workbook](../develop/howto-get-list-of-all-auth-library-apps.md) was an alternative method to identify these apps. The workbook is still available to you, but using the workbook requires streaming sign-in logs to Azure Monitor first. The ADAL to MSAL recommendation works out of the box. Plus, the sign-ins workbook doesn't capture Service Principal sign-ins, while the recommendation does.
 
 ### Why is the number of ADAL applications different in the workbook and the recommendation?