Merge branch 'main' into suzuber/new-vmware-cloud-director-availability-article

Author: Suzi Zuber

.openpublishing.redirection.json

@@ -9,6 +9,9 @@ ms.date: 01/17/2023
 ms.author: godonnell
 ms.subservice: B2C
 zone_pivot_groups: b2c-policy-type
+
+# Customer intent: I want to enrich tokens with claims from external identity data sources using APIs or outbound webhooks.
+
 ---
 
 # Enrich tokens with claims from external sources using API connectors

CODEOWNERS

@@ -5,12 +5,15 @@ description: Configure an API connector to be used in a sign-up user flow.
 ms.service: active-directory
 ms.subservice: B2C
 ms.topic: how-to
-ms.date: 12/20/2022
+ms.date: 01/24/2024
 author: garrodonnell
 ms.author: godonnell
 manager: CelesteDG
 ms.custom: it-pro, b2c-support
 zone_pivot_groups: b2c-policy-type
+
+#Customer Intent: As a developer or IT administrator, I want to use API connectors to integrate sign-up user flows with REST APIs to customize the sign-up experience and integrate with external systems.
+
 ---
 
 # Add an API connector to a sign-up user flow

articles/active-directory-b2c/add-api-connector-token-enrichment.md

@@ -11,6 +11,9 @@ ms.custom: mvc
 ms.topic: how-to
 ms.service: active-directory
 ms.subservice: B2C
+
+#Customer Intent: As a developer integrating Azure AD B2C into my application, I want to add an identity provider, so that users can sign in with their existing social or enterprise accounts without creating a new account.
+
 ---
 
 # Add an identity provider to your Azure Active Directory B2C tenant

articles/active-directory-b2c/add-api-connector.md

@@ -11,7 +11,7 @@ ms.author: godonnell
 ms.subservice: B2C
 zone_pivot_groups: b2c-policy-type
 
-#Customer intent: As a developer, I want to enable my users to reset their passwords without the need for admin intervention, so that they can recover their accounts if they forget their passwords.
+#Customer Intent: As an Azure AD B2C administrator, I want to set up a password reset flow for local accounts, so that users can reset their passwords if they forget them.
 ---
 
 # Set up a password reset flow in Azure Active Directory B2C

articles/active-directory-b2c/add-identity-provider.md

@@ -14,6 +14,9 @@ ms.author: godonnell
 ms.subservice: B2C
 ms.custom: "b2c-support"
 zone_pivot_groups: b2c-policy-type
+
+#Customer Intent: As a developer integrating Azure Active Directory B2C into my application, I want to set up a sign-up and sign-in flow, so that users can sign up and sign in with local or social accounts, and reset their passwords if needed.
+
 ---
 
 # Set up a sign-up and sign-in flow in Azure Active Directory B2C

articles/active-directory-b2c/add-password-reset-policy.md

@@ -9,7 +9,7 @@ manager: CelesteDG
 ms.service: active-directory
 ms.topic: how-to
 
-ms.date: 01/11/2024
+ms.date: 01/26/2024
 ms.author: kengaderdus
 ms.subservice: B2C
 zone_pivot_groups: b2c-policy-type
@@ -38,6 +38,8 @@ In Azure Active Directory B2C (Azure AD B2C), you can send event data directly t
 - Measure performance.
 - Create notifications from Application Insights.
 
+[!INCLUDE [active-directory-b2c-limited-to-custom-policy](../../includes/active-directory-b2c-public-preview.md)]
+
 ## Overview
 
 To enable custom event logs, add an Application Insights technical profile. In the technical profile, you define the Application Insights instrumentation key, the event name, and the claims to record. To post an event, add the technical profile as an orchestration step in a [user journey](userjourneys.md).
@@ -183,11 +185,13 @@ Open the *TrustFrameworkExtensions.xml* file from the starter pack. Add the tech
 
 ## Add the technical profiles as orchestration steps
 
-Add new orchestration steps that refer to the technical profiles.
+Add new orchestration steps that refer to the technical profiles.  
 
 > [!IMPORTANT]
 > After you add the new orchestration steps, renumber the steps sequentially without skipping any integers from 1 to N.
 
+1. Identify the policy file that contains your user journey, such as `SocialAndLocalAccounts/SignUpOrSignin.xml`, then open it.
+
 1. Call `AppInsights-SignInRequest` as the second orchestration step. This step tracks that a sign-up or sign-in request has been received.
 
    ```xml
@@ -199,10 +203,12 @@ Add new orchestration steps that refer to the technical profiles.
    </OrchestrationStep>
    ```
 
-1. Before the `SendClaims` orchestration step, add a new step that calls `AppInsights-UserSignup`. It's triggered when the user selects the sign-up button in a sign-up or sign-in journey.
+1. Before the `SendClaims` orchestration step, add a new step that calls `AppInsights-UserSignup`. It's triggered when the user selects the sign-up button in a sign-up or sign-in journey. You may need to update the orchestration step, `Order="8"`,to make sure you don't skip any integer from the first to the last orchestration step. 
 
    ```xml
-   <!-- Handles the user selecting the sign-up link in the local account sign-in page -->
+   <!-- Handles the user selecting the sign-up link in the local account sign-in page 
+    The `SendClaims` orchestration step comes after this one,
+    -->
    <OrchestrationStep Order="8" Type="ClaimsExchange">
      <Preconditions>
        <Precondition Type="ClaimsExist" ExecuteActionsIf="false">
@@ -221,10 +227,12 @@ Add new orchestration steps that refer to the technical profiles.
    </OrchestrationStep>
    ```
 
-1. After the `SendClaims` orchestration step, call `AppInsights-SignInComplete`. This step shows a successfully completed journey.
+1. After the `SendClaims` orchestration step, call `AppInsights-SignInComplete`. This step shows a successfully completed journey. You may need to update the orchestration step, `Order="10"`, to make sure you don't skip any integer from the first to the last orchestration step. 
 
    ```xml
-   <!-- Track that we have successfully sent a token -->
+   <!-- Track that we have successfully sent a token 
+    The `SendClaims` orchestration step come before this one,
+    -->
    <OrchestrationStep Order="10" Type="ClaimsExchange">
      <ClaimsExchanges>
        <ClaimsExchange Id="TrackSignInComplete" TechnicalProfileReferenceId="AppInsights-SignInComplete" />

articles/active-directory-b2c/add-sign-up-and-sign-in-policy.md

@@ -2,16 +2,15 @@
 title: Build a global identity solution with funnel-based approach
 titleSuffix: Azure AD B2C
 description: Learn the funnel-based design consideration for Azure AD B2C to provide customer identity management for global customers.
-
 author: gargi-sinha
 manager: martinco
-
 ms.service: active-directory
-
 ms.topic: conceptual
-ms.date: 12/15/2022
+ms.date: 01/26/2024
 ms.author: gasinh
 ms.subservice: B2C
+
+#customer intent: I'm a developer, and I need to understand how to build a global identity solution using a funnel-based approach, so I can implement it in my organization's Azure AD B2C environment.
 ---
 
 # Build a global identity solution with funnel-based approach

articles/active-directory-b2c/analytics-with-application-insights.md

@@ -8,9 +8,11 @@ manager: martinco
 ms.service: active-directory
 
 ms.topic: conceptual
-ms.date: 12/15/2022
+ms.date: 01/26/2024
 ms.author: gasinh
 ms.subservice: B2C
+
+#customer intent: As a developer, I want to understand how to build a global identity solution using a funnel-based approach, so I can implement it in my organization's Azure AD B2C environment.
 ---
 
 # Azure Active Directory B2C global identity framework proof of concept for funnel-based configuration