draft complete

Author: dlepow

articles/api-management/developer-portal-basic-authentication.md

@@ -12,29 +12,21 @@ ms.author: danlep
 
 # Authenticate users of the developer portal by using usernames and passwords 
 
-In the developer portal for Azure API Management, the default authentication method for users is the provide a username and password. In this article, learn how to set up a user with basic authentication credentials to the developer portal
-
-
-In this article, you'll learn how to:
-> [!div class="checklist"]
-> * ... 
+In the developer portal for Azure API Management, the default authentication method for users is to provide a username and password. In this article, learn how to set up users with basic authentication credentials to the developer portal.
 
 
 ## Prerequisites
 
 - Complete the [Create an Azure API Management instance](get-started-create-service-instance.md) quickstart.
 
-- [Import and publish](import-and-publish.md) an API in the Azure API Management instance.
-
-
 [!INCLUDE [premium-dev-standard.md](../../includes/api-management-availability-premium-dev-standard.md)]
 
 [!INCLUDE [api-management-navigate-to-instance.md](../../includes/api-management-navigate-to-instance.md)]
 
 
-## Confirm the Username and password provider
+## Confirm the username and password provider
 
-By default, the Username and password identity provider is enabled in the developer portal. To confirm this setting:
+By default, the username and password *identity provider* is enabled in the developer portal. To confirm this setting:
 
 1. In the left menu of your API Management instance, under **Developer portal**, select **Identities**.
 1. In the **Provider type** list, confirm that **Username and password** appears.
@@ -46,27 +38,33 @@ If the provider isn't already enabled, you can add it:
 
 ## Add a username and password
 
-There are two ways to add a username and password:
+There are two ways to add a username and password for authentication to the developer portal:
+
+* An API publisher can add a user through the Azure portal, or with equivalent Azure tools such as the [New-AzApiManagementUser](/powershell/module/az.apimanagement/new-azapimanagementuser) Azure PowerShell cmdlet. For steps to use the portal, see [How to manage user accounts in Azure API Management](api-management-howto-create-or-invite-developers.md).
 
-* An API publisher can add a user through the Azure portal, or with equivalent Azure tools such as the [New-AzApiManagementUser](/powershell/module/az.apimanagement/new-azapimanagementuser) Azure PowerShell cmdlet. For steps using the portal, see [How to manage user accounts in Azure API Management](api-management-howto-create-or-invite-developers.md).
+    :::image type="content" source="media/developer-portal-basic-authentication/add-user-portal.png" alt-text="Screenshot showing how to add a user in the Azure portal.":::    
 
 * An API consumer (developer) can sign up directly in the developer portal, using the **Sign up** page.
 
+    :::image type="content" source="media/developer-portal-basic-authentication/developer-portal-sign-up-page.png" alt-text="Screenshot of the sign-up page in the developer portal.":::
+
 > [!NOTE]
 > API Management enforces password strength requirements including password length. When you add a user in the Azure portal, the password must be at least 6 characters long. When a developer signs up or resets a password through the developer portal, the password must be at least 8 characters long.
 
+## Delete the username and password provider
 
-
-## Delete the Username and password provider
-
-If you've configured another identity provider for the developer portal such as [Azure AD](api-management-howto-aad.md) or [Azure AD B2C](api-management-howto-aad-b2c.md), you might want to delete the Username password provider:
+If you've configured another identity provider for the developer portal such as [Azure AD](api-management-howto-aad.md) or [Azure AD B2C](api-management-howto-aad-b2c.md), you might want to delete the username and password provider:
 
 1. In the left menu of your API Management instance, under **Developer portal**, select **Identities**.
 1. In the **Provider type** list, select **Username and password**. In the context menu (**...**), select **Delete**.
 
 
 ## Next steps
 
+For steps to add other identity providers for developer sign-up to the developer portal, see:
+
+- [Authorize developer accounts by using Azure Active Directory in Azure API Management](api-management-howto-aad.md)
+- [Authorize developer accounts by using Azure Active Directory B2C in Azure API Management](api-management-howto-aad-b2c.md)
 
 
 [api-management-dev-portal-signin]: ./media/api-management-howto-aad/api-management-dev-portal-signin.png