Azure API Management でユーザー アカウントを管理する方法How to manage user accounts in Azure API Management

API Management では、開発者は、API Management を使用して公開された API のユーザーになります。In API Management, developers are the users of the APIs that you expose using API Management. このガイドでは、開発者を作成する方法と、API Management インスタンスで公開した API および成果物を案内する招待メッセージを開発者に送信する方法について説明します。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. プログラムによるユーザー アカウントの管理については、「API Management REST (API Management REST)」リファレンスのユーザー エンティティに関するドキュメントを参照してください。For information on managing user accounts programmatically, see the User entity documentation in the API Management REST reference.

可用性Availability

重要

この機能は、API Management の PremiumStandardBasicDeveloper レベルで使用できます。This feature is available in the Premium, Standard, Basic and Developer tiers of API Management.

前提条件Prerequisites

次の記事のタスクを済ませておいてください: Azure API Management インスタンスを作成するComplete tasks in this article: Create an Azure API Management instance.

API Management インスタンスに移動します。Go to your API Management instance

API Management インスタンスに移動

  1. Azure Portal にサインインします。Sign in to the Azure portal.

  2. [すべてのサービス] を選択します。Select All services.

  3. 検索ボックスに「 api management」と入力します。In the search box, enter api management.

  4. 検索結果で、 [API Management サービス] を選択します。In the search results, select API Management services.

  5. お使いの API Management サービス インスタンスを選択します。Select your API Management service instance.

ヒント

Azure portal で API Management をお気に入りに追加するには、星を選択します。To add API Management to your favorites in the Azure portal, select the star.

API Management アイコン (The API Management icon (API Management アイコン) が、ポータルの左側のメニューに表示されます。) now appears in the left menu in the portal.

新しい開発者の作成 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.

    新しいユーザーの追加

既定では、新しく作成された開発者アカウントはアクティブになり、開発者グループに関連付けられます。By default, newly created developer accounts are Active, and associated with the Developers group. [アクティブ] 状態の開発者アカウントを使用すると、サブスクリプションがあるすべての API にアクセスできます。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. ブロックされている開発者アカウントは、開発者ポータルにアクセスすることも、API を呼び出すこともできません。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

プログラムによってユーザー アカウントを操作するには、「API Management REST API」リファレンスのユーザー エンティティに関するドキュメントを参照してください。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

開発者アカウントを作成した後は、このアカウントをロールに関連付け、成果物と API をサブスクライブできます。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.