Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into Oct-21-2022-OnPremTS

Author: AbhishekMallick-MS

articles/active-directory/develop/scenario-desktop-acquire-token.md

@@ -2,16 +2,16 @@
 title: Acquire a token to call a web API (desktop app)
 description: Learn how to build a desktop app that calls web APIs to acquire a token for the app
 services: active-directory
-author: Dickson-Mwendia
+author: OwenRichards1
 manager: CelesteDG
-
 ms.service: active-directory
 ms.subservice: develop
 ms.topic: conceptual
 ms.workload: identity
-ms.date: 08/25/2021
-ms.author: dmwendia
-ms.custom: aaddev, devx-track-python, has-adal-ref
+ms.date: 10/21/2022
+ms.author: owenrichards
+ms.custom: aaddev, devx-track-python, has-adal-ref, engagement-fy23
+
 #Customer intent: As an application developer, I want to know how to write a desktop app that calls web APIs by using the Microsoft identity platform.
 ---
 
@@ -21,7 +21,7 @@ After you've built an instance of the public client application, you'll use it t
 
 ## Recommended pattern
 
-The web API is defined by its `scopes`. Whatever the experience you provide in your application, the pattern to use is:
+The web API is defined by its *scopes*. Whatever the experience you provide in your application, the pattern to use is:
 
 - Systematically attempt to get a token from the token cache by calling `AcquireTokenSilent`.
 - If this call fails, use the `AcquireToken` flow that you want to use, which is represented here by `AcquireTokenXX`.

articles/active-directory/external-identities/b2b-quickstart-add-guest-users-portal.md

@@ -16,7 +16,9 @@ ms.collection: M365-identity-device-management
 
 # Quickstart: Add a guest user and send an invitation
 
-With Azure AD [B2B collaboration](what-is-b2b.md), you can invite anyone to collaborate with your organization using their own work, school, or social account. In this quickstart, you'll learn how to add a new guest user to your Azure AD directory in the Azure portal. You'll also send an invitation and see what the guest user's invitation redemption process looks like. In addition to this quickstart, you can learn more about adding guest users [in the Azure portal](add-users-administrator.md), via [PowerShell](b2b-quickstart-invite-powershell.md), or [in bulk](tutorial-bulk-invite.md).
+With Azure AD [B2B collaboration](what-is-b2b.md), you can invite anyone to collaborate with your organization using their own work, school, or social account.
+
+In this quickstart, you'll learn how to add a new guest user to your Azure AD directory in the Azure portal. You'll also send an invitation and see what the guest user's invitation redemption process looks like. In addition to this quickstart, you can learn more about adding guest users [in the Azure portal](add-users-administrator.md), via [PowerShell](b2b-quickstart-invite-powershell.md), or [in bulk](tutorial-bulk-invite.md).
 
 If you don’t have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
@@ -34,15 +36,15 @@ To complete the scenario in this quickstart, you need:
 
 1. Under **Azure services**, select **Azure Active Directory** (or use the search box to find and select **Azure Active Directory**).
 
-    ![Screenshot showing where to select the Azure Active Directory service.](media/quickstart-add-users-portal/azure-active-directory-service.png)
+    :::image type="content" source="media/quickstart-add-users-portal/azure-active-directory-service.png" alt-text="Screenshot showing where to select the Azure Active Directory service.":::
 
 1. Under **Manage**, select **Users**.
 
-    ![Screenshot showing where to select the Users option](media/quickstart-add-users-portal/quickstart-users-portal-user.png)
+    :::image type="content" source="media/quickstart-add-users-portal/quickstart-users-portal-user.png" alt-text="Screenshot showing where to select the Users option.":::
 
-1. Select **New guest user**.
+1. Under **New user** select **Invite external user**.
 
-    ![Screenshot showing where to select the New guest user option.](media/quickstart-add-users-portal/new-guest-user.png)
+    :::image type="content" source="media/quickstart-add-users-portal/new-guest-user.png" alt-text="Screenshot showing where to select the New guest user option.":::
 
 1. On the **New user** page, select **Invite user** and then add the guest user's information.
 
@@ -52,13 +54,14 @@ To complete the scenario in this quickstart, you need:
    - **Groups**: You can add the guest user to one or more existing groups, or you can do it later.
    - **Roles**: If you require Azure AD administrative permissions for the user, you can add them to an Azure AD role.
 
-    ![Screenshot showing the new user page.](media/quickstart-add-users-portal/invite-user.png)
+    :::image type="content" source="media/quickstart-add-users-portal/invite-user.png" alt-text="Screenshot showing the new user page.":::
 
 1. Select **Invite** to automatically send the invitation to the guest user. A notification appears in the upper right with the message **Successfully invited user**.
 
 1. After you send the invitation, the user account is automatically added to the directory as a guest.
 
-    ![Screenshot showing the new guest user in the directory.](media/quickstart-add-users-portal/new-guest-user-directory.png)
+    :::image type="content" source="media/quickstart-add-users-portal/new-guest-user-directory.png" alt-text="Screenshot showing the new guest user in the directory.":::
+
 
 ## Accept the invitation
 
@@ -68,11 +71,12 @@ Now sign in as the guest user to see the invitation.
 
 1. In your inbox, open the email from "Microsoft Invitations on behalf of Contoso."
 
-    ![Screenshot showing the B2B invitation email](media/quickstart-add-users-portal/quickstart-users-portal-email-small.png)
+    :::image type="content" source="media/quickstart-add-users-portal/quickstart-users-portal-email-small.png" alt-text="Screenshot showing the B2B invitation email.":::
+
 
 1. In the email body, select **Accept invitation**. A **Review permissions** page opens in the browser.
 
-    ![Screenshot showing the Review permissions page.](media/quickstart-add-users-portal/consent-screen.png)
+    :::image type="content" source="media/quickstart-add-users-portal/consent-screen.png" alt-text="Screenshot showing the Review permissions page.":::
 
 1. Select **Accept**.
 

articles/active-directory/external-identities/media/quickstart-add-users-portal/azure-active-directory-service.png

@@ -42,7 +42,7 @@ The scenario outlined in this tutorial assumes that you already have the followi
 
 ## Step 2. Configure Documo to support provisioning with Azure AD
 
-1. [Generate an API key](https://help.documo.com/support/solutions/articles/72000513690-how-to-enable-api-and-retrieve-api-key) to use for Azure AD provisioning. 
+1. [Generate an API key](https://help.documo.com/hc/en-us/articles/7789630698011-How-to-Enable-and-Retrieve-API-Keys) to use for Azure AD provisioning. 
 1. Find and remember your API URL. The default API URL is `https://api.documo.com`. If you have a custom Documo API domain, you can reference it in the domain tab of the Documo branding settings page.
 
 ## Step 3. Add Documo from the Azure AD application gallery