Skip to content

Latest commit

 

History

History
93 lines (65 loc) · 5.63 KB

api-management-howto-create-or-invite-developers.md

File metadata and controls

93 lines (65 loc) · 5.63 KB
title description services documentationcenter author manager editor ms.service ms.workload ms.tgt_pltfrm ms.topic ms.date ms.author
How manage user accounts in Azure API Management | Microsoft Docs
Learn how to create or invite users in Azure API Management
api-management
vladvino
cfowler
api-management
mobile
na
article
02/13/2018
apimpm

How to manage user accounts in Azure API Management

In API Management, developers are the users of the APIs that you expose using API Management. This guide shows to how to create and invite developers to use the APIs and products that you make available to them with your API Management instance. For information on managing user accounts programmatically, see the User entity documentation in the API Management REST reference.

[!INCLUDE premium-dev-standard-basic.md]

Prerequisites

Complete tasks in this article: Create an Azure API Management instance.

[!INCLUDE api-management-navigate-to-instance.md]

Create a new developer

To add a new user, follow the steps in this section:

  1. Select the Users tab to the left of the screen.

  2. Press +Add.

  3. Enter appropriate information for the user.

  4. Press Add.

    Add a new user

By default, newly created developer accounts are Active, and associated with the Developers group. Developer accounts that are in an active state can be used to access all of the APIs for which they have subscriptions. To associate the newly created developer with additional groups, see How to associate groups with developers.

Invite a developer

To invite a developer, follow the steps in this section:

  1. Select the Users tab to the left of the screen.
  2. Press +Invite.

A confirmation message is displayed, but the newly invited developer does not appear in the list until after they accept the invitation.

When a developer is invited, an email is sent to the developer. This email is generated using a template and is customizable. For more information, see Configure email templates.

Once the invitation is accepted, the account becomes active.

Deactivate or reactivate a developer account

By default, newly created or invited developer accounts are Active. To deactivate a developer account, click Block. To reactivate a blocked developer account, click Activate. A blocked developer account can't access the developer portal or call any APIs. To delete a user account, click Delete.

To block a user, follow the following steps.

  1. Select the Users tab to the left of the screen.
  2. Click on the user that you want to block.
  3. Press Block.

Reset a user password

To programmatically work with user accounts, see the User entity documentation in the API Management REST API reference. To reset a user account password to a specific value, you can use the Update a user operation and specify the desired password.

Next steps

Once a developer account is created, you can associate it with roles and subscribe it to products and APIs. For more information, see How to create and use groups.