|
| 1 | +--- |
| 2 | +title: Use basic authentication to developer portal |
| 3 | +titleSuffix: Azure API Management |
| 4 | +description: Learn how to set up user accounts to the developer portal in Azure API Management with username and password authentication. |
| 5 | + |
| 6 | +author: dlepow |
| 7 | +ms.service: api-management |
| 8 | +ms.topic: article |
| 9 | +ms.date: 08/30/2022 |
| 10 | +ms.author: danlep |
| 11 | +--- |
| 12 | + |
| 13 | +# Authenticate users of the developer portal by using usernames and passwords |
| 14 | + |
| 15 | +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 |
| 16 | + |
| 17 | + |
| 18 | +In this article, you'll learn how to: |
| 19 | +> [!div class="checklist"] |
| 20 | +> * ... |
| 21 | +
|
| 22 | + |
| 23 | +## Prerequisites |
| 24 | + |
| 25 | +- Complete the [Create an Azure API Management instance](get-started-create-service-instance.md) quickstart. |
| 26 | + |
| 27 | +- [Import and publish](import-and-publish.md) an API in the Azure API Management instance. |
| 28 | + |
| 29 | + |
| 30 | +[!INCLUDE [premium-dev-standard.md](../../includes/api-management-availability-premium-dev-standard.md)] |
| 31 | + |
| 32 | +[!INCLUDE [api-management-navigate-to-instance.md](../../includes/api-management-navigate-to-instance.md)] |
| 33 | + |
| 34 | + |
| 35 | +## Confirm the Username and password provider |
| 36 | + |
| 37 | +By default, the Username and password identity provider is enabled in the developer portal. To confirm this setting: |
| 38 | + |
| 39 | +1. In the left menu of your API Management instance, under **Developer portal**, select **Identities**. |
| 40 | +1. In the **Provider type** list, confirm that **Username and password** appears. |
| 41 | + |
| 42 | +If the provider isn't already enabled, you can add it: |
| 43 | + |
| 44 | +1. In the left menu of your API Management instance, under **Developer portal**, select **Identities** > **+ Add**. |
| 45 | +1. Under **Type**, select **Username and password**, and then select **Add**. |
| 46 | + |
| 47 | +## Add a username and password |
| 48 | + |
| 49 | +There are two ways to add a username and password: |
| 50 | + |
| 51 | +* 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). |
| 52 | + |
| 53 | +* An API consumer (developer) can sign up directly in the developer portal, using the **Sign up** page. |
| 54 | + |
| 55 | +> [!NOTE] |
| 56 | +> 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. |
| 57 | +
|
| 58 | + |
| 59 | + |
| 60 | +## Delete the Username and password provider |
| 61 | + |
| 62 | +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: |
| 63 | + |
| 64 | +1. In the left menu of your API Management instance, under **Developer portal**, select **Identities**. |
| 65 | +1. In the **Provider type** list, select **Username and password**. In the context menu (**...**), select **Delete**. |
| 66 | + |
| 67 | + |
| 68 | +## Next steps |
| 69 | + |
| 70 | + |
| 71 | + |
| 72 | +[api-management-dev-portal-signin]: ./media/api-management-howto-aad/api-management-dev-portal-signin.png |
| 73 | +[api-management-aad-signin]: ./media/api-management-howto-aad/api-management-aad-signin.png |
| 74 | +[api-management-complete-registration]: ./media/api-management-howto-aad/api-management-complete-registration.png |
| 75 | +[api-management-registration-complete]: ./media/api-management-howto-aad/api-management-registration-complete.png |
| 76 | + |
| 77 | +[How to add operations to an API]: ./mock-api-responses.md |
| 78 | +[How to add and publish a product]: api-management-howto-add-products.md |
| 79 | +[Monitoring and analytics]: api-management-monitoring.md |
| 80 | +[Add APIs to a product]: api-management-howto-add-products.md#add-apis |
| 81 | +[Publish a product]: api-management-howto-add-products.md#publish-product |
| 82 | +[Get started with Azure API Management]: get-started-create-service-instance.md |
| 83 | +[API Management policy reference]: ./api-management-policies.md |
| 84 | +[Caching policies]: ./api-management-policies.md#caching-policies |
| 85 | +[Create an API Management service instance]: get-started-create-service-instance.md |
| 86 | + |
| 87 | +[https://oauth.net/2/]: https://oauth.net/2/ |
| 88 | +[WebApp-GraphAPI-DotNet]: https://github.com/AzureADSamples/WebApp-GraphAPI-DotNet |
| 89 | + |
| 90 | +[Prerequisites]: #prerequisites |
| 91 | +[Configure an OAuth 2.0 authorization server in API Management]: #step1 |
| 92 | +[Configure an API to use OAuth 2.0 user authorization]: #step2 |
| 93 | +[Test the OAuth 2.0 user authorization in the Developer Portal]: #step3 |
| 94 | +[Next steps]: #next-steps |
| 95 | + |
| 96 | +[Sign in to the developer portal by using an Azure AD account]: #Sign-in-to-the-developer-portal-by-using-an-Azure-AD-account |
0 commit comments