Merging changes synced from https://github.com/MicrosoftDocs/azure-do…

…cs-pr (branch live)

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

@@ -167,7 +167,7 @@ Call `AppInsights-SignInRequest` as orchestration step 2 to track that a sign-in
 
 ```xml
 <!-- Track that we have received a sign in request -->
-<OrchestrationStep Order="1" Type="ClaimsExchange">
+<OrchestrationStep Order="2" Type="ClaimsExchange">
   <ClaimsExchanges>
     <ClaimsExchange Id="TrackSignInRequest" TechnicalProfileReferenceId="AppInsights-SignInRequest" />
   </ClaimsExchanges>

articles/active-directory/b2b/api-connectors-overview.md

@@ -1,29 +1,26 @@
 ---
-title: Manage API connectors in self-service sign-up flows
-description: Use API connectors to customize and extend your self-service sign-up user flows
-
+title: About API connectors in self-service sign-up flows - Azure AD
+description: Use Azure Active Directory (Azure AD) API connectors to customize and extend your self-service sign-up user flows by using web APIs. 
 services: active-directory
 ms.service: active-directory
 ms.subservice: B2B
 ms.topic: conceptual
-ms.date: 04/20/2020
+ms.date: 06/16/2020
 
 ms.author: mimart
 author: msmimart
 manager: celestedg
-ms.reviewer: mal
 ms.custom: "it-pro"                 
 ms.collection: M365-identity-device-management
 ---
 
 # Use API connectors to customize and extend self-service sign-up 
 
 ## Overview 
-As a developer or IT administrator, you can use API connectors to integrate your [self-service sign-up user flows](self-service-sign-up-overview.md) with external systems by leveraging Web APIs. For example, you can use API connectors to:
+As a developer or IT administrator, you can use API connectors to integrate your [self-service sign-up user flows](self-service-sign-up-overview.md) with external systems by leveraging web APIs. For example, you can use API connectors to:
 
 - [**Integrate with a custom approval workflows**](self-service-sign-up-add-approvals.md). Connect to a custom approval system for managing account creation.
-<!-- - [**Perform identity proofing**](code-samples-self-service-sign-up.md#identity-proofing). Use an identity proofing and verification service to add an extra level of security to account creation decisions. -->
-- **Perform identity proofing**. Use an identity proofing and verification service to add an extra level of security to account creation decisions.
+- [**Perform identity proofing**](code-samples-self-service-sign-up.md#identity-proofing). Use an identity proofing and verification service to add an extra level of security to account creation decisions.
 - **Validate user input data**. Validate against malformed or invalid user data. For example, you can validate user-provided data against existing data in an external data store or list of permitted values. If invalid, you can ask a user to provide valid data or block the user from continuing the sign-up flow.
 - **Overwrite user attributes**. Reformat or assign a value to an attribute collected from the user. For example, if a user enters the first name in all lowercase or all uppercase letters, you can format the name with only the first letter capitalized. 
 <!-- - **Enrich user data**. Integrate with your external cloud systems that store user information to integrate them with the sign-up flow. For example, your API can receive the user's email address, query a CRM system, and return the user's loyalty number. Returned claims can be used to pre-fill form fields or return additional data in the application token.  -->
@@ -59,12 +56,6 @@ An API connector at this step in the sign-up process is invoked after the attrib
 <!-- > [!IMPORTANT]
 > If an invalid response is returned or another error occurs (for example, a network error), the user will be redirected to the app with the error re -->
 
-## Frequently asked questions (FAQ)
-
-### How do I integrate with an existing API endpoint?
-You can use an [HTTP trigger in Azure Functions](https://docs.microsoft.com/azure/azure-functions/functions-bindings-http-webhook-trigger?tabs=csharp) as a simple way to call and invoke other Web APIs.
-
 ## Next steps
 - Learn how to [add an API connector to a user flow](self-service-sign-up-add-api-connector.md)
-- Learn how to [add a custom approval system to self-service sign-up](self-service-sign-up-add-approvals.md)
-<!--#TODO: Make doc, link.-->
+- Learn how to [add a custom approval system to self-service sign-up](self-service-sign-up-add-approvals.md)

articles/active-directory/b2b/code-samples-self-service-sign-up.md

@@ -0,0 +1,43 @@
+---
+title: API connector code samples for user flows - Azure AD
+description: Code samples for API connectors in self-service sign-up flows for Azure Active Directory External Identities.
+services: active-directory
+ms.service: active-directory
+ms.subservice: B2B
+ms.topic: sample
+ms.date: 06/16/2020
+
+ms.author: mimart
+author: msmimart
+manager: celestedg
+ms.custom: "it-pro"
+ms.collection: M365-identity-device-management
+---
+
+# Samples for External Identities self-service sign-up
+
+The following tables provide links to code samples for leveraging web APIs in your self-service sign-up user flows using [API connectors](api-connectors-overview.md).
+
+## API connector Azure Function quickstarts
+
+| Sample                                                                                                                          | Description                                                                                                                                               |
+| ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [.NET Core](https://github.com/Azure-Samples/active-directory-dotnet-external-identities-api-connector-azure-function-validate) | This .NET Core Azure Function sample demonstrates how to limit sign-ups to a specific domain (e.g. @fabrikam.com) and validate user-provided information. |
+| [Node.js](https://github.com/Azure-Samples/active-directory-nodejs-external-identities-api-connector-azure-function-validate)   | This Node.js Azure Function sample demonstrates how to limit sign-ups to a specific domain (e.g. @fabrikam.com) and validate user-provided information.   |
+| [Python](https://github.com/Azure-Samples/active-directory-python-external-identities-api-connector-azure-function-validate)    | This Python Azure Function sample demonstrates how to limit sign-ups to a specific domain (e.g. @fabrikam.com) and validate user-provided information.    |
+
+<!-- \| [Java](../../azure-docs-pr/articles/active-directory/b2b/invite-internal-users.md#use-the-invitation-api-to-send-a-b2b-invitation) |  The sample below illustrates how to call the invitation API to invite an internal user as a B2B user. | -->
+
+## Custom approval workflows
+
+| Sample | Description |
+|--------| ----------- |
+| [Manual approval workflow](https://github.com/Azure-Samples/active-directory-dotnet-external-identities-api-connectors-approvals) | This sample demonstrates an end-to-end approval workflow to manage guest user account creation in self-service sign-up |
+
+## Identity proofing
+
+| Sample                                                                                                            | Description                                                                                                                          |
+| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| [IDology](https://github.com/Azure-Samples/active-directory-dotnet-external-identities-idology-identity-proofing) | This sample shows how to add ID proofing to your self-service sign-up user flow by using an API connector to integrate with IDology. |
+
+<!-- | [Experian](https://github.com/Azure-Samples/) | This sample shows how add identity verification to your self-service sign-up user flow by using an API connector to integrate with Experian. | -->