Merge pull request #197706 from MicrosoftDocs/main

5/10 AM Publish

Author: huypub

articles/active-directory/develop/scenario-spa-app-registration.md

@@ -9,7 +9,7 @@ ms.service: active-directory
 ms.subservice: develop
 ms.topic: conceptual
 ms.workload: identity
-ms.date: 10/12/2021
+ms.date: 05/10/2022
 ms.author: marsma
 ms.custom: aaddev
 # Customer intent: As an application developer, I want to know how to write a single-page application by using the Microsoft identity platform.
@@ -24,7 +24,7 @@ To register a single-page application (SPA) in the Microsoft identity platform,
 For both MSAL.js 1.0- and 2.0-based applications, start by completing the following steps to create the initial app registration.
 
 1. Sign in to the <a href="https://portal.azure.com/" target="_blank">Azure portal</a>.
-1. If you have access to multiple tenants, use the **Directory + subscription** filter :::image type="icon" source="./media/common/portal-directory-subscription-filter.png" border="false"::: in the top menu to select the tenant in which you want to register an application.
+1. If you have access to multiple tenants, use the **Directories + subscriptions** filter :::image type="icon" source="./media/common/portal-directory-subscription-filter.png" border="false"::: in the top menu to select the tenant in which you want to register an application.
 1. Search for and select **Azure Active Directory**.
 1. Under **Manage**, select **App registrations** > **New registration**.
 1. Enter a **Name** for your application. Users of your app might see this name, and you can change it later.

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

@@ -1,94 +1,92 @@
 ---
-title: 'Quickstart: Add guest users in the Azure portal - Azure AD'
+title: 'Quickstart: Add a guest user and send an invitation - Azure AD'
 description: Use this quickstart to learn how Azure AD admins can add B2B guest users in the Azure portal and walk through the B2B invitation workflow.
 services: active-directory
 author: msmimart
 ms.author: mimart
 manager: celestedg
-ms.reviewer: mal
-ms.date: 06/18/2020
+ms.date: 05/10/2022
 ms.topic: quickstart
 ms.service: active-directory
 ms.subservice: B2B
 ms.custom: it-pro, seo-update-azuread-jan, mode-ui
 ms.collection: M365-identity-device-management
-#Customer intent: As a tenant admin, I want to walk through the B2B  invitation workflow so that I can understand how to add a guest user in the portal, and understand the end user experience.
+#Customer intent: As a tenant admin, I want to walk through the B2B invitation workflow so that I can understand how to add a guest user in the portal, and understand the end user experience.
 ---
 
-# Quickstart: Add guest users to your directory in the Azure portal
+# Quickstart: Add a guest user and send an invitation
 
-You can invite anyone to collaborate with your organization by adding them to your directory as a guest user. Then you can either send an invitation email that contains a redemption link or send a direct link to an app you want to share. Guest users can sign in with their own work, school, or social identities. Along with 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).
-
-In this quickstart, you'll add a new guest user to your Azure AD directory via the Azure portal, send an invitation, and see what the guest user's invitation redemption process looks like.
+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.
 
 ## Prerequisites
 
-To complete the scenario in this tutorial, you need:
+To complete the scenario in this quickstart, you need:
+
+- A role that allows you to create users in your tenant directory, such as the Global Administrator role or a limited administrator directory role (for example, Guest inviter or User administrator).
 
- - A role that allows you to create users in your tenant directory, like the Global Administrator role or any of the limited administrator directory roles such as guest inviter or user administrator.
- - A valid email account that you can add to your tenant directory, and that you can use to receive the test invitation email.
+- Access to a valid email address outside of your Azure AD tenant, such as a separate work, school, or social email address. You'll use this email to create the guest account in your tenant directory and access the invitation.
 
 ## Add a new guest user in Azure AD
 
-1. Sign in to the [Azure portal](https://portal.azure.com/) as an Azure AD administrator.
-2. In the left pane, select **Azure Active Directory**.
-3.	Under **Manage**, select **Users**.
+1. Sign in to the [Azure portal](https://portal.azure.com/) with an account that's been assigned the Global administrator, Guest, inviter, or User administrator role.
+
+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)
+
+1. Under **Manage**, select **Users**.
 
     ![Screenshot showing where to select the Users option](media/quickstart-add-users-portal/quickstart-users-portal-user.png)
 
-4.	Select **New guest user**.
+1. Select **New guest user**.
 
-    ![Screenshot showing where to select the New guest user option](media/quickstart-add-users-portal/quickstart-users-portal-user-3.png)
+    ![Screenshot showing where to select the New guest user option.](media/quickstart-add-users-portal/new-guest-user.png)
 
-5. On the **New user** page, select **Invite user** and then add the guest user's information. 
+1. On the **New user** page, select **Invite user** and then add the guest user's information.
 
    - **Name.** The first and last name of the guest user.
    - **Email address (required)**. The email address of the guest user.
    - **Personal message (optional)** Include a personal welcome message to the guest user.
    - **Groups**: You can add the guest user to one or more existing groups, or you can do it later.
-   - **Directory role**: If you require Azure AD administrative permissions for the user, you can add them to an Azure AD role. 
+   - **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)
 
-6. Select **Invite** to automatically send the invitation to the guest user. A notification appears in the upper right with the message **Successfully invited user**. 
-7.	After you send the invitation, the user account is automatically added to the directory as a guest.
+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**.
 
-## Assign an app to the guest user
-Add the Salesforce app to your test tenant and assign the test guest user to the app.
-1.	Sign in to the Azure portal as an Azure AD administrator.
-2.	In the left pane, select **Enterprise applications**.
-3.	Select **New application**.
-4. Under **Add from the gallery**, search for **Salesforce**, and then select it.
+1. After you send the invitation, the user account is automatically added to the directory as a guest.
 
-    ![Screenshot showing the Add from the gallery search box](media/quickstart-add-users-portal/quickstart-users-portal-select-salesforce.png)
-5. Select **Add**.
-6. Under **Manage**, select **Single sign-on**, and under **Single Sign-on Mode**, select **Password-based Sign-on**, and click **Save**.
-7. Under **Manage**, select **Users and groups** > **Add user** > **Users and groups**.
-8. Use the search box to search for the test user (if necessary) and select the test user in the list. Then click **Select**.
-9. Select **Assign**. 
+    ![Screenshot showing the new guest user in the directory.](media/quickstart-add-users-portal/new-guest-user-directory.png)
 
 ## Accept the invitation
+
 Now sign in as the guest user to see the invitation.
-1.	Sign in to your test guest user's email account.
-2.	In your inbox, find the "You're invited" email.
+
+1. Sign in to your test guest user's email account.
+
+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)
 
-3.	In the email body, select **Get Started**. A **Review permissions** page opens in the browser. 
+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)
 
-    ![Screenshot showing the Review permissions page](media/quickstart-add-users-portal/quickstart-users-portal-accept.png)
+1. Select **Accept**.
 
-4. Select **Accept**. The Access Panel opens, which lists the applications the guest user can access.
+1. The **My Apps** page opens. Because we haven't assigned any apps to this guest user, you'll see the message "There are no apps to show." In a real-life scenario, you would [add the guest user to an app](add-users-administrator.md#add-guest-users-to-an-application) so the app would appear here.
 
 ## Clean up resources
-When no longer needed, delete the test guest user and the test app.
-1.	Sign in to the Azure portal as an Azure AD administrator.
-2.	In the left pane, select **Azure Active Directory**.
-3.	Under **Manage**, select **Enterprise applications**.
-4.	Open the application **Salesforce**, and then select **Delete**.
-5.	In the left pane, select **Azure Active Directory**.
-6.	Under **Manage**, select **Users**.
-7.	Select the test user, and then select **Delete user**.
+
+When no longer needed, delete the test guest user.
+
+1. Sign in to the [Azure portal](https://portal.azure.com/) with an account that's been assigned the Global administrator, Guest, inviter, or User administrator role.
+1. Select the **Azure Active Directory** service.
+1. Under **Manage**, select **Users**.
+1. Select the test user, and then select **Delete user**.
 
 ## Next steps
-In this tutorial, you created a guest user in the Azure portal, and sent an invitation to share apps. Then you viewed the redemption process from the guest user's perspective and verified that the app appeared on the guest user's Access Panel. To learn more about adding guest users for collaboration, see [Add Azure Active Directory B2B collaboration users in the Azure portal](add-users-administrator.md).
+
+In this quickstart, you created a guest user in the Azure portal and sent an invitation to share apps. Then you viewed the redemption process from the guest user's perspective and verified that the guest user was able to access their My Apps page. To learn more about adding guest users for collaboration, see [Add Azure Active Directory B2B collaboration users in the Azure portal](add-users-administrator.md).