Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into toc-update

Author: AbbyMSFT

articles/active-directory-b2c/partner-strata.md

@@ -4,100 +4,84 @@ titleSuffix: Azure AD B2C
 description: In this tutorial, learn how to integrate Azure AD B2C authentication with WhoIAM for user verification. 
 services: active-directory-b2c
 author: gargi-sinha
-manager: CelesteDG
+manager: martinco
 ms.reviewer: kengaderdus
 ms.service: active-directory
 ms.workload: identity
 ms.topic: how-to
-ms.date: 09/13/2022
+ms.date: 12/19/2022
 ms.author: gasinh
 ms.subservice: B2C
 ---
 
-# Tutorial for configuring WhoIAM with Azure Active Directory B2C
+# Tutorial to configure Azure Active Directory B2C with WhoIAM
 
-In this sample tutorial, we provide guidance on how to configure [WhoIAM](https://www.whoiam.ai/brims/) Branded Identity Management System (BRIMS) in your environment and integrate it with Active Directory B2C (Azure AD B2C).
+In this tutorial, learn how to configure WhoIAM Branded Identity Management System (BRIMS) in your environment and integrate it with Azure Active Directory B2C (Azure AD B2C). The BRIMS apps and services are deployed in your environment. They provide user verification with voice, SMS, and email. BRIMS works with your identity and access management solution and is platform-agnostic.
+
+Learn more: [WhoIAM, Products and Services, Branded Identity Management System](https://www.whoiam.ai/brims/)
 
-BRIMS is a set of apps and services that's deployed in your environment. It provides voice, SMS, and email verification of your user base. BRIMS works in conjunction with your existing identity and access management solution and is platform agnostic.
 
 ## Prerequisites
 
 To get started, you'll need:
 
-- An Azure AD subscription. If you don't have a subscription, you can get a [free account](https://azure.microsoft.com/free/).
-
-- [An Azure AD B2C tenant](./tutorial-create-tenant.md) that's linked to your Azure subscription.
-
-- A WhoIAM [trial account](https://www.whoiam.ai/contact-us/).
+- An Azure AD subscription
+  - If you don't have one, you can get an [Azure free account](https://azure.microsoft.com/free/)
+- [An Azure AD B2C tenant](./tutorial-create-tenant.md) linked to your Azure subscription
+- A WhoIAM trial account
+  - Go to [WhoIAM, Contact us](https://www.whoiam.ai/contact-us/) to get started
 
 ## Scenario description
 
 The WhoIAM integration includes the following components:
 
-- An Azure AD B2C tenant. It's the authorization server that verifies the user's credentials based on custom policies defined in it. It's also known as the identity provider.
-
-- An administration portal for managing clients and their configurations.
-
-- An API service that exposes various features through endpoints.  
-
-- Azure Cosmos DB, which acts as the back end for both the BRIMS administration portal and the API service.
+- **Azure AD B2C tenant** - The authorization server that verifies user credentials, based on custom policies, know as the identity provider (IdP)
+- **Administration portal** - To manage clients and their configurations
+- **API service** - To expose various features through endpoints 
+- **Azure Cosmos DB** - The back end for the BRIMS administration portal and API service
 
-The following architecture diagram shows the implementation.
+The following diagram shows the implementation architecture.
 
-![Diagram of the architecture of Azure AD B2C integration with WhoIAM.](media/partner-whoiam/whoiam-architecture-diagram.png)
+   ![Diagram of Azure AD B2C integration with WhoIAM.](media/partner-whoiam/whoiam-architecture-diagram.png)
 
-|Step | Description |
-|:-----| :-----------|
-| 1. | The user arrives at a page to start the sign-up or sign-in request to an app that uses Azure AD B2C as its identity provider.
-| 2. | As part of authentication, the user requests to either verify ownership of their email or phone or use their voice as a biometric verification factor.  
-| 3. | Azure AD B2C makes a call to the BRIMS API service and passes on the user's email address, phone number, and voice recording.
-| 4. | BRIMS uses predefined configurations such as fully customizable email and SMS templates to interact with the user in their respective language in a way that's consistent with the app's style.
-| 5. | After a user's identity verification is complete, BRIMS returns a token to Azure AD B2C to indicate the outcome of the verification. Azure AD B2C then either grants the user access to the app or fails their authentication attempt.  
+1. The user signs up or signs in to request an app that uses Azure AD B2C as IdP
+2. The user requests ownership verification of their email, phone, or they use voice as biometric verification 
+3. Azure AD B2C calls to the BRIMS API service and passes the user attributes
+4. BRIMS interacts with the user in their own language
+5. After verification, BRIMS returns a token to Azure AD B2C, which grants access, or doesn't.  
 
 ## Sign up with WhoIAM
 
 1. Contact [WhoIAM](https://www.whoiam.ai/contact-us/) and create a BRIMS account.
+2. Configure the following Azure services:
 
-2. Use the sign-up guidelines made available to you and configure the following Azure services:
-
-    - [Azure Key Vault](https://azure.microsoft.com/services/key-vault/): Used for secure storage of passwords, such as mail service passwords.
-
-    - [Azure App Service](https://azure.microsoft.com/services/app-service/): Used to host the BRIMS API and admin portal services.
-
-    - [Azure Active Directory](https://azure.microsoft.com/services/active-directory/): Used to authenticate administrative users for the admin portal.
-
-    - [Azure Cosmos DB](https://azure.microsoft.com/services/cosmos-db/): Used to store and retrieve settings.
-
-    - [Application Insights](../azure-monitor/app/app-insights-overview.md) (optional): Used to log in to both the API and the admin portal.
+    * [Key Vault](https://azure.microsoft.com/services/key-vault/): Store passwords
+    * [App Service](https://azure.microsoft.com/services/app-service/): Host the BRIMS API and admin portal services
+    * [Azure Active Directory](https://azure.microsoft.com/services/active-directory/): Authenticate administrative users for the portal
+    * [Azure Cosmos DB](https://azure.microsoft.com/services/cosmos-db/): Store and retrieve settings
+    * [Application Insights overview](../azure-monitor/app/app-insights-overview.md) (optional): Sign in to the API and the portal
 
 3. Deploy the BRIMS API and the BRIMS administration portal in your Azure environment.
-
-4. Azure AD B2C custom policy samples are available in your BRIMS sign-up documentation. Follow the documentation to configure your app and use the BRIMS platform for user identity verification.  
-
-For more information about WhoIAM's BRIMS, see the [product documentation](https://www.whoiam.ai/brims/).
+4. Follow the documentation to configure your app. Use BRIMS for user identity verification. Azure AD B2C custom policy samples are in the BRIMS sign-up documentation.  
+For more information about WhoIAM BRIMS, request documentation on [WhoIAM, Contact Us](https://www.whoiam.ai/brims/).
 
 ## Test the user flow
 
-1. Open the Azure AD B2C tenant. Under **Policies**, select **Identity Experience Framework**.
-
-2. Select your previously created **SignUpSignIn**.
-
-3. Select **Run user flow** and then:
-
-   a. For **Application**, select the registered app (the sample is JWT).
+1. Open the Azure AD B2C tenant. 
+2. Under **Policies**, select **Identity Experience Framework**.
+3. Select the created **SignUpSignIn**.
+4. Select **Run user flow**.
+5. For **Application**, select the registered app (example is JWT).
+6. For **Reply URL**, select the **redirect URL**.
+7. Select **Run user flow**.
+8. Complete the sign-up flow
+9. Create an account.
+10. After the user attribute is created, the BRIMS service is called. 
 
-   b. For **Reply URL**, select the **redirect URL**.
-
-   c. Select **Run user flow**.
-
-4. Go through the sign-up flow and create an account.
-
-5. The BRIMS service will be called during the flow, after the user attribute is created. If the flow is incomplete, check that the user isn't saved in the directory.
+> [!TIP]
+> If the flow is incomplete, confirm the user is saved in the directory.
 
 ## Next steps
 
-For additional information, review the following articles:
-
-- [Custom policies in Azure AD B2C](./custom-policy-overview.md)
-
-- [Get started with custom policies in Azure AD B2C](tutorial-create-user-flows.md?pivots=b2c-custom-policy)
+- [Azure AD B2C custom policy overview](./custom-policy-overview.md)
+- [Tutorial: Create user flows and custom policies in Azure Active Directory B2C](tutorial-create-user-flows.md?pivots=b2c-custom-policy)