Merge pull request #79099 from MicrosoftDocs/master

Friday PM

Author: tynevi

articles/active-directory-b2c/media/tutorial-create-user-flows/signup-signin-attributes.png

@@ -1,5 +1,5 @@
 ---
-title: Tutorial - Create an Azure Active Directory B2C tenant | Microsoft Docs
+title: Tutorial - Create an Azure Active Directory B2C tenant
 description: Learn how to prepare for registering your applications by creating an Azure Active Directory B2C tenant using the Azure portal.
 services: B2C
 author: mmacy
@@ -8,7 +8,7 @@ manager: celestedg
 ms.service: active-directory
 ms.workload: identity
 ms.topic: conceptual
-ms.date: 01/11/2019
+ms.date: 06/07/2019
 ms.author: marsma
 ms.subservice: B2C
 ---
@@ -30,23 +30,28 @@ If you don't have an Azure subscription, create a [free account](https://azure.m
 ## Create an Azure AD B2C tenant
 
 1. Sign in to the [Azure portal](https://portal.azure.com/).
-2. Make sure that you are using the directory that contains your subscription by clicking the **Directory and subscription filter** in the top menu and choosing the directory that contains it. This directory is different from the one that will contain your Azure AD B2C tenant.
+2. Make sure you're using the directory that contains your subscription. Click the **Directory and subscription filter** in the top menu, then select the directory that contains your subscription. This directory is different from the one that will contain your Azure AD B2C tenant.
 
-    ![Switch to subscription directory](./media/tutorial-create-tenant/switch-directory-subscription.png)
+    ![Switch to subscription directory](./media/tutorial-create-tenant/switch-directory-subscription.PNG)
 
 3. Choose **Create a resource** in the top-left corner of the Azure portal.
 4. Search for and select **Active Directory B2C**, and then click **Create**.
-5. Choose **Create a new Azure AD B2C Tenant**, enter an organization name and initial domain name, which is used in the tenant name, select the country/region (it can't be changed later), and then click **Create**.
+5. Choose **Create a new Azure AD B2C Tenant** and enter an organization name and initial domain name. Select the country/region (it can't be changed later), and then click **Create**.
 
-    ![Create a tenant](./media/tutorial-create-tenant/create-tenant.png)
+    The initial domain name is used as part of your tenant name. In this example, the tenant name is *contoso0926Tenant.onmicrosoft.com*:
 
-    In this example, the tenant name is contoso0926Tenant.onmicrosoft.com
+    ![Create a tenant](./media/tutorial-create-tenant/create-tenant.PNG)
 
-6. On the **Create new B2C Tenant or Link to an exiting Tenant** page, choose **Link an existing Azure AD B2C Tenant to my Azure subscription**, select the tenant that you created, select your subscription, and then click **Create new**.
-7. Enter a name for the resource group that will contain the tenant, select the location, and then click **Create**.
-8. To start using your new tenant, make sure you are using the directory that contains your Azure AD B2C tenant by clicking the **Directory and subscription filter** in the top menu and choosing the directory that contains it.
+6. On the **Create new B2C Tenant or Link to existing Tenant** page, choose **Link an existing Azure AD B2C Tenant to my Azure subscription**.
 
-    ![Switch to tenant directory](./media/tutorial-create-tenant/switch-directories.png)
+    Select the tenant that you created, and select your subscription.
+
+    For resource group, select **Create new**. Enter a name for the resource group that will contain the tenant, select the location, and then click **Create**.
+1. To start using your new tenant, make sure you're using the directory that contains your Azure AD B2C tenant by clicking the **Directory and subscription filter** in the top menu and choosing the directory that contains it.
+
+    If at first you don't see your new Azure B2C tenant in the list, refresh your browser window, then select the **Directory and subscription filter** again in the top menu.
+
+    ![Switch to tenant directory](./media/tutorial-create-tenant/switch-directories.PNG)
 
 ## Next steps
 
@@ -56,5 +61,7 @@ In this article, you learned how to:
 > * Create an Azure AD B2C tenant
 > * Link your tenant to your subscription
 
+Next, learn how to register a web application in your new tenant.
+
 > [!div class="nextstepaction"]
-> [Register your applications](tutorial-register-applications.md)
+> [Register your applications >](tutorial-register-applications.md)

articles/active-directory-b2c/media/tutorial-create-user-flows/signup-signin-properties.png

@@ -1,21 +1,21 @@
 ---
-title: Tutorial - Create user flows - Azure Active Directory B2C | Microsoft Docs
-description: Learn how to Create user flows for your applications in Azure Active Directory B2C using the Azure portal.
+title: Tutorial - Create user flows - Azure Active Directory B2C
+description: Learn how to create user flows in the Azure portal to enable sign up, sign in, and user profile editing for your applications in Azure Active Directory B2C.
 services: active-directory-b2c
 author: mmacy
 manager: celestedg
 
 ms.service: active-directory
 ms.workload: identity
 ms.topic: article
-ms.date: 02/01/2019
+ms.date: 06/07/2019
 ms.author: marsma
 ms.subservice: B2C
 ---
 
 # Tutorial: Create user flows in Azure Active Directory B2C
 
-In your applications, you may have [user flows](active-directory-b2c-reference-policies.md) that enable users to sign up, sign in, or manage their profile. You can create multiple user flows of different types in your Azure Active Directory (Azure AD) B2C tenant and use them in your applications as needed. User flows can be reused across applications.
+In your applications you may have [user flows](active-directory-b2c-reference-policies.md) that enable users to sign up, sign in, or manage their profile. You can create multiple user flows of different types in your Azure Active Directory (Azure AD) B2C tenant and use them in your applications as needed. User flows can be reused across applications.
 
 In this article, you learn how to:
 
@@ -24,92 +24,92 @@ In this article, you learn how to:
 > * Create a profile editing user flow
 > * Create a password reset user flow
 
-This tutorial shows you how to create some recommended user flows by using the Azure portal. If you are looking for information about how to set up a resource owner password credentials (ROPC) flow in your application, see [Configure the resource owner password credentials flow in Azure AD B2C](configure-ropc.md).
+This tutorial shows you how to create some recommended user flows by using the Azure portal. If you're looking for information about how to set up a resource owner password credentials (ROPC) flow in your application, see [Configure the resource owner password credentials flow in Azure AD B2C](configure-ropc.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
 
-[Register your applications](tutorial-register-applications.md) that are part of the user flows you want to create. 
+[Register your applications](tutorial-register-applications.md) that are part of the user flows you want to create.
 
 ## Create a sign-up and sign-in user flow
 
 The sign-up and sign-in user flow handles both sign-up and sign-in experiences with a single configuration. Users of your application are led down the right path depending on the context.
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
-2. Make sure you're using the directory that contains your Azure AD B2C tenant by clicking the **Directory and subscription filter** in the top menu and choosing the directory that contains your tenant.
+1. Make sure you're using the directory that contains your Azure AD B2C tenant by clicking the **Directory and subscription filter** in the top menu and choosing the directory that contains your tenant.
 
-    ![Switch to subscription directory](./media/tutorial-create-user-flows/switch-directories.png)
+    ![Switch to subscription directory](./media/tutorial-create-user-flows/switch-directories.PNG)
 
-3. Choose **All services** in the top-left corner of the Azure portal, and then search for and select **Azure AD B2C**.
-4. In the left menu, select **User flows**, and then select **New user flow**.
+1. Choose **All services** in the top-left corner of the Azure portal, and then search for and select **Azure AD B2C**.
+1. In the left menu under **Policies**, select **User flows (policies)**, and then select **New user flow**.
 
     ![Select new user flow](./media/tutorial-create-user-flows/signup-signin-user-flow.png)
 
-5. Select the **Sign-up and sign-in** user flow on the Recommended tab.
+1. On the **Recommended** tab, select the **Sign up and sign in** user flow.
 
     ![Select the sign-up and sign-in user flow](./media/tutorial-create-user-flows/signup-signin-type.png)
 
-6. Enter a **Name** for the user flow. For example, *signupsignin1*.
-7. For **Identity providers**, select **Email signup**.
+1. Enter a **Name** for the user flow. For example, *signupsignin1*.
+1. For **Identity providers**, select **Email signup**.
 
     ![Set the flow properties](./media/tutorial-create-user-flows/signup-signin-properties.png)
 
-8. For **User attributes and claims**, choose the claims and attributes that you want to collect and send from the user during sign-up. For example, select **Show more**, and then choose **Country/Region**, **Display Name**, and **Postal Code**. Click **OK**.
+1. For **User attributes and claims**, choose the claims and attributes that you want to collect and send from the user during sign-up. For example, select **Show more**, and then choose attributes and claims for **Country/Region**, **Display Name**, and **Postal Code**. Click **OK**.
 
     ![Select attributes and claims](./media/tutorial-create-user-flows/signup-signin-attributes.png)
 
-9. Click **Create** to add the user flow. A prefix of *B2C_1* is automatically appended to the name.
+1. Click **Create** to add the user flow. A prefix of *B2C_1* is automatically appended to the name.
 
 ### Test the user flow
 
-1. On the Overview page of the user flow that you created, select **Run user flow**.
-2. For **Application**, select the web application named *webapp1* that you previously registered. The **Reply URL** should show `https://jwt.ms`.
-3. Click **Run user flow**, and then select **Sign up now**.
+1. Select the user flow you created to open its overview page, then select **Run user flow**.
+1. For **Application**, select the web application named *webapp1* that you previously registered. The **Reply URL** should show `https://jwt.ms`.
+1. Click **Run user flow**, and then select **Sign up now**.
 
-    ![Run the user flow](./media/tutorial-create-user-flows/signup-signin-run-now.png)
+    ![Run the user flow](./media/tutorial-create-user-flows/signup-signin-run-now.PNG)
 
-4. Enter a valid email address, click **Send verification code**, and then enter the verification code that you receive.
-5. Enter a new password and confirm the password.
-6. Enter the name that you want displayed, select your country and region, enter a postal code, and then click **Create**. The token is returned to `https://jwt.ms` and should be displayed to you.
-7. You can now run the user flow again and you should be able to sign in with the account that you created. The returned token includes the claims that you selected of name, country/region, and postal code.
+1. Enter a valid email address, click **Send verification code**, enter the verification code that you receive, then select **Verify code**.
+1. Enter a new password and confirm the password.
+1. Select your country and region, enter the name that you want displayed, enter a postal code, and then click **Create**. The token is returned to `https://jwt.ms` and should be displayed to you.
+1. You can now run the user flow again and you should be able to sign in with the account that you created. The returned token includes the claims that you selected of country/region, name, and postal code.
 
 ## Create a profile editing user flow
 
 If you want to enable users to edit their profile in your application, you use a profile editing user flow.
 
-1. In the left menu, select **User flows**, and then select **New user flow**.
-2. Select the **Profile editing** user flow on the Recommended tab.
-3. Enter a **Name** for the user flow. For example, *profileediting1*.
-4. For **Identity providers**, select **Local Account SignIn**.
-5. For **User attributes**, choose the attributes that you want the customer to be able to edit in their profile. For example, select **Show more**, and then choose **Display Name** and **Job title**. Click **OK**.
-6. Click **Create** to add the user flow. A prefix of *B2C_1* is automatically appended to the name.
+1. In the left menu of the Azure AD B2C tenant overview page, select **User flows (policies)**, and then select **New user flow**.
+1. Select the **Profile editing** user flow on the Recommended tab.
+1. Enter a **Name** for the user flow. For example, *profileediting1*.
+1. For **Identity providers**, select **Local Account SignIn**.
+1. For **User attributes**, choose the attributes that you want the customer to be able to edit in their profile. For example, select **Show more**, and then choose both attributes and claims for **Display name** and **Job title**. Click **OK**.
+1. Click **Create** to add the user flow. A prefix of *B2C_1* is automatically appended to the name.
 
 ### Test the user flow
 
-1. On the Overview page of the user flow that you created, select **Run user flow**.
-2. For **Application**, select the web application named *webapp1* that you previously registered. The **Reply URL** should show `https://jwt.ms`.
-3. Click **Run user flow**, and then sign in with the account that you previously created.
-4. You now have the opportunity to change the display name and job title for the user. Click **Continue**. The token is returned to `https://jwt.ms` and should be displayed to you.
+1. Select the user flow you created to open its overview page, then select **Run user flow**.
+1. For **Application**, select the web application named *webapp1* that you previously registered. The **Reply URL** should show `https://jwt.ms`.
+1. Click **Run user flow**, and then sign in with the account that you previously created.
+1. You now have the opportunity to change the display name and job title for the user. Click **Continue**. The token is returned to `https://jwt.ms` and should be displayed to you.
 
 ## Create a password reset user flow
 
-It's possible for you to enable the user of your application to reset their password if needed. To enable password reset, you use a password reset user flow.
+To enable users of your application to reset their password, you use a password reset user flow.
 
-1. In the left menu, select **User flows**, and then select **New user flow**.
-2. Select the **Password reset** user flow on the Recommended tab.
-3. Enter a **Name** for the user flow. For example, *passwordreset1*.
-4. For **Identity providers**, enable **Reset password using email address**.
-5. Under Application claims, click **Show more** and choose the claims that you want returned in the authorization tokens sent back to your application. For example, select **User's Object ID**.
-6. Click **OK**.
-7. Click **Create** to add the user flow. A prefix of *B2C_1* is automatically appended to the name.
+1. In the left menu, select **User flows (policies)**, and then select **New user flow**.
+1. Select the **Password reset** user flow on the Recommended tab.
+1. Enter a **Name** for the user flow. For example, *passwordreset1*.
+1. For **Identity providers**, enable **Reset password using email address**.
+1. Under Application claims, click **Show more** and choose the claims that you want returned in the authorization tokens sent back to your application. For example, select **User's Object ID**.
+1. Click **OK**.
+1. Click **Create** to add the user flow. A prefix of *B2C_1* is automatically appended to the name.
 
 ### Test the user flow
 
-1. On the Overview page of the user flow that you created, select **Run user flow**.
-2. For **Application**, select the web application named *webapp1* that you previously registered. The **Reply URL** should show `https://jwt.ms`.
-3. Click **Run user flow**, and then sign in with the account that you previously created.
-4. You now have the opportunity to change the password for the user. Click **Continue**. The token is returned to `https://jwt.ms` and should be displayed to you.
+1. Select the user flow you created to open its overview page, then select **Run user flow**.
+1. For **Application**, select the web application named *webapp1* that you previously registered. The **Reply URL** should show `https://jwt.ms`.
+1. Click **Run user flow**, verify the email address of the account that you previously created, and select **Continue**.
+1. You now have the opportunity to change the password for the user. Change the password and select **Continue**. The token is returned to `https://jwt.ms` and should be displayed to you.
 
 ## Next steps
 
@@ -120,5 +120,7 @@ In this article, you learned how to:
 > * Create a profile editing user flow
 > * Create a password reset user flow
 
+Next, learn about adding identity providers to your applications to enable user sign-in with providers like Azure AD, Amazon, Facebook, GitHub, LinkedIn, Microsoft, or Twitter.
+
 > [!div class="nextstepaction"]
-> [Add identity providers to your applications in Azure Active Directory B2C](tutorial-add-identity-providers.md)
+> [Add identity providers to your applications >](tutorial-add-identity-providers.md)