You're viewing **Apigee Edge** documentation. [Go to the **Apigee X** documentation](http://cloud.google.com/apigee/docs/api-platform/publish/adding-developers-your-api-product). info Register and manage your app developers, as described in the following sections. (App registration is a separate process, as described in [Register apps and manage API keys](https://docs.apigee.com/api-platform/publish/creating-apps-surface-your-api)). ## Introduction Edge provides many benefits that are completely dependent on knowing who's calling your APIs. For example, API security, traffic management, and a fair amount of analytics data depend on knowing who's calling. And how does Edge know who's calling your APIs? By reading unique information in each API call, such as a user ID, an API key, or an OAuth token. That unique information locks or unlocks the functionality you build into your API proxies, giving you full control over API access and behavior. That's why app developers need to register to use your APIs. Once added, developers register their apps, choose the APIs they want to use, and receive the unique API credentials (consumer keys and secrets) needed to access your APIs. > [!WARNING] > **Warning:** API security, traffic management, and developer/app analytics are dependent on proper API proxy configuration. For example, you need to add the right policies to your proxies, such as API key validation or OAuth access token verification, quota enforcement, and rate limiting. Those policies identify which specific developer and app is making the call, which in turn enables API security enforcement, developer- or app-specific traffic management, API analytics capture, and other functionality. Technically, you could develop open APIs that don't check for API keys or access tokens, which means you wouldn't really need to register developers. But we strongly discourage this, because you lose API security, lose control over performance (through good traffic management), lose out on analytics data, and miss out on other major benefits that Edge provides. ### How to register app developers Register app developers using one of the following methods: - If you have a paid Edge account, developers can self-register through a developer portal. For more information, see one of the following sections based on the type of developer portal: - Integrated portal: [Create a developer account on the integrated portal](https://docs.apigee.com/api-platform/publish/portal/portal-interact#register) - Drupal 10: [Register an app developer account](https://www.drupal.org/docs/8/modules/apigee-edge/how-app-developers-interact-with-the-apigee-edge-module#registering-an-app-developer-account) - Drupal 7: [Add and manage user accounts](https://docs.apigee.com/api-platform/publish/drupal/add-and-manage-user-accounts) - Administrators can [register app developers using the API](https://docs.apigee.com/api-platform/publish/using-edge-management-api-publish-apis). - As a developer portal administrator, manage developers directly on your portal, as described in the following sections: - Integrated portal: [Manage developer accounts](https://docs.apigee.com/api-platform/publish/portal/api-portal-users) to manage developer accounts. > [!NOTE] > After a developer creates an app on the integrated portal, as described in this section, the developer account information is synced to and available on Edge on the [Developers page](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#ui). The app developer record is associated with the developer account using the developer's email address. For more information about where developer account and associated app information is stored, see [Where developer account information is stored](https://docs.apigee.com/api-platform/publish/portal/build-integrated-portal#apidev-info-stored). - Drupal 10: [How app developers interact with the Apigee Edge module](https://www.drupal.org/docs/8/modules/apigee-edge/how-app-developers-interact-with-the-apigee-edge-module) - Drupal 7: [Add and manage user accounts](https://docs.apigee.com/api-platform/publish/drupal/add-and-manage-user-accounts) - As an organization administrator, manage developers using the Edge [UI](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#ui) or [API](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#api), as described in the following sections. > [!NOTE] > When portal users create a team in the integrated portal, the developer team information is stored on Edge and a unique, auto-generated email address is generated to serve as the primary key used by Edge to identify the developer team. For more information, see [Where developer team information is stored (beta)](https://docs.apigee.com/api-platform/publish/portal/build-integrated-portal#team-info-stored). ### Recommendations for managing developer accounts on developer portals Apigee recommends that you manage developer accounts directly on your developer portal. If you are using the integrated portal, this is the only way to ensure that the developer accounts on the integrated portal and Edge stay in sync. If you use the Drupal-based developer portal, managing developer accounts directly on the developer portal provides the following advantages: - When you add a developer through the administrator interface on the portal, you can set the developer's password for the portal and trigger an automated email message sent to the developer.When adding or modifying a developer using Edge, no email is sent to the developer and you cannot set the password for the developer on the portal. Therefore, the developer must reset their password on the portal before they can sign in to the portal. - Any changes made to the developer's account on the portal are automatically sent to Edge. If you decide to manage Drupal-based developer accounts using Edge, you must [synchronize app developers between the portal and Edge](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#synchronize-portal-edge). ## Exploring the Developers page Access and explore the Developers page using the Edge UI and New Edge UI. > [!NOTE] > For integrated portals, developer accounts are managed as described in [Manage developer accounts](https://docs.apigee.com/api-platform/publish/portal/api-portal-users). After a developer creates an app on the integrated portal, as described in [Register apps](https://docs.apigee.com/api-platform/publish/portal/portal-interact#register-apps), a separate developer record is created to track apps associated with the developer account and can be accessed on the Developers page. The developer record is associated using the developer's email address. ### Edge To access the Developers page using the Edge UI: 1. Sign in to [apigee.com/edge](https://apigee.com/edge). 2. Select **Publish \> Developers** in the left navigation bar. The Developers page is displayed. ![](https://docs.apigee.com/static/api-platform/images/developers.png) As highlighted in the figure, the Developers page enables you to: - [Add a developer](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#add) - [View and edit developer details](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#edit), including the following: - [Manage custom attributes](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#custom-attributes) - [Activate or deactivate a developer](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#status) - [Export publishing data](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#export) - [Delete a developer](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#delete) - Search the list of developers ### New Edge UI (Private Cloud) > [!NOTE] > **Note:** The New Edge UI is available with Edge for Private Cloud only. To access the Developers page using the New Edge UI: 1. Sign in to the New Edge UI at `http://host:3001/edge`, where host is the IP address or DNS name of the host running the New Edge UI. 2. Select **Publish \> Developers** in the left navigation bar. The Developers page is displayed. ![Developers page in the New Edge UI](https://docs.apigee.com/static/api-platform/images/developers.png) As highlighted in the figure, the Developers page enables you to: - [Add a developer](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#add) - [View and edit developer details](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#edit), including the following: - [Manage custom attributes](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#custom-attributes) - [Activate or deactivate a developer](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#status) - [Export publishing data](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#export) - [Delete a developer](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#delete) - Search the list of developers ## Adding a developer To add a developer: 1. [Access the Developers page.](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#ui) 2. Click **+ Developer**. 3. Enter the developer details, including first name, last name, email, and username. 4. Click **Create**. ## Viewing and editing developer details View and edit developer details. For Monetization-enabled organizations, you can edit the monetization custom attributes defined in [Configuring monetization attributes](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#monetization-attributes). To view and edit developer details: 1. [Access the Developers page.](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#ui) 2. Click the row of the developer that you want to view and edit to open the developer details. 3. In the Details section, the following information is displayed. Edit the developer details, as required. | Detail | Description | |---|---| | Details | Developer first and last name, username, and email; registration status and duration; and developer ID. To edit the developer details, click within any of the following fields: - First Name - Last Name - Email - Username Modify the content and press **Enter** to confirm the change. | | Custom attributes | Custom attributes defined for the developer. Configure custom attributes, as required. For more information, see: - [Managing custom attributes for a developer](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#custom-attributes) - [Configuring monetization attributes](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#monetization-attributes) | | Apps | Apps that have been registered by the developer. See [Registering apps](https://docs.apigee.com/api-platform/publish/creating-apps-surface-your-api). | 4. Activate or deactivate the developer in the Status field. For more information, see [Activating and deactivating a developer](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#status). With **Apigee Edge for Public Cloud** , Edge keeps the following entities in cache for a minimum of 180 seconds after the entities are *accessed*. - OAuth access tokens. This means that a revoked token may still succeed for up to three minutes, until its cache limit expires. - Key Management Service (KMS) entities (Apps, Developers, API Products). - Custom attributes on OAuth tokens and KMS entities. ## Managing custom attributes for a developer Add up to 18 custom attributes for each developer, including the monetization attributes described in [Configuring monetization attributes](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#monetization-attributes). > [!NOTE] > For the [integrated developer portal](https://docs.apigee.com/api-platform/publish/portal/building-your-developer-portal), developer registration and portal login are tracked using the `_apiportal` custom attribute in Edge. For more information, see How app developer registration and login is tracked in Edge. To manage custom attributes: 1. [Access the Developers page.](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#ui) 2. Click the row of the developer for which you want to manage custom attributes to to open the developer details. 3. Click **+** in the Custom Attributes section. 4. Enter the attribute name and value. 5. Click ![](https://docs.apigee.com/static/api-platform/images/checkmark-green.png). 6. To delete a custom attribute, position your cursor over the attribute and click ![](https://docs.apigee.com/static/api-platform/images/delete-icon.png) in the actions menu. ## Activating and deactivating a developer When an app developer self-registers in your portal, you can configure whether or not they are active by default. When a developer is inactive, the developer can still sign in to the developer portal and create apps, but none of the corresponding API keys will work. The developer's apps still retain their approved (or other) status, as do the API keys, even though they're not valid while the developer is inactive. > [!NOTE] > When you deactivate a developer, it may take a few minutes for the change to be updated on all message processors. Until then, some calls by the developer's app may succeed. To activate or deactivate a developer: 1. [Access the Developers page.](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#ui) 2. Click the row of the developer that you want to activate or deactivate to to open the developer details. 3. In the Details section, set the **Status** field to **Active** or **Inactive**, as required. 4. Repeat the steps if the developer is in multiple organizations. ## Exporting publishing data Export the following publishing data as a comma-separated values (CSV) file: - Developer details - Developer, application, and API product details To export publishing data: 1. [Access the Developers page.](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#ui) 2. Click **Export CSV...** 3. Select **Developers** or **Developers, Apps, and Products** from the drop-down. The selected publishing data is downloaded as a CSV file. ## Deleting a developer > [!WARNING] > **Warning:** Deleting developers completely removes them and their related artifacts (such as apps and API keys) from your organization. To avoid permanently deleting developers and their artifacts, consider [deactivating > developers](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#status) instead. > > Developers cannot be deleted on organizations with [monetization](https://docs.apigee.com/api-platform/monetization/basics-monetization) enabled. To delete a developer: 1. [Access the Developers page.](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#ui) 2. Position your cursor over the row of the developer that you want to delete to display the actions menu. 3. Click ![](https://docs.apigee.com/static/api-platform/images/delete-icon.png). 4. Click **Delete** to confirm the deletion. ## Synchronizing app developers between the portal and Edge If you are using a Drupal-based developer portal to publish your APIs, changes made to app developers using Edge are not propagated to the portal. You must sign in to the portal as a portal administrator and synchronize the portal with Edge for those changes to appear on the portal. > [!NOTE] > **Note:** If you use the Drupal-based developer portal, Apigee recommends that you manage app developers directly on your portal, not using Edge. See [Recommendations for managing developer accounts on developer portals.](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#recommendations) To synchronize your developer portal with the app developers defined on Edge, refer to the following sections: - Drupal 10: [Synchronize developers with Apigee Edge](https://www.drupal.org/docs/8/modules/apigee-edge/synchronize-developers-with-apigee-edge) - Drupal 7: [Synchronizing app developers between the portal and Edge](https://docs.apigee.com/api-platform/publish/drupal/communicating-between-developer-services-portal-and-edge#synchronize-portal-edge) ## Grouping developers into companies With monetization, a company is a collection of developers managed as a single entity. A company can be any grouping that is appropriate to your organization such as business unit, product line, or division. Grouping developers into companies is useful when your need to have multiple developers associated under a single corporate entity. For example, you may need to set up different companies for billing purposes. However, developers in your organization don't need to be associated with a company. Note that a developer is always a single entity, uniquely identified by the email element. If a developer is part of a company you'll see the Company name on the Developers page. For more information about managing companies and developers for monetization, see [Manage companies and developers](https://docs.apigee.com/api-platform/monetization/manage-companies-developers). ## Configuring monetization attributes When editing a developer using the [UI](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#edit) or creating or editing a developer using the [API](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#api), you can configure the monetization properties defined in the following table. Initially, you configure the monetization properties for the organization when [editing the organization profile](https://docs.apigee.com/api-platform/monetization/edit-organization-profile). > [!NOTE] > **Note:** In order to subscribe to a rate plan, if the developer is not grouped with a company, then the Legal Name attribute must be defined for the developer. | Field name | Custom attribute name | Description | |---|---|---| | Address | `MINT_DEVELOPER_ADDRESS` | Address of the developer, including the following fields: Address (lines 1 and 2), City, State, Zip Code, and Country. | | Billing Profile | `MINT_BILLING_PROFILE` | Billing cycle for your organization. Valid values include: - `PRORATED`: Billing is based on the number of days that an API product is used in a calendar month. - `CALENDAR_MONTH`: Billing is done monthly. | | Billing Type | `MINT_BILLING_TYPE` | Developer payment model used for billing. The value can be one of the following: - **PREPAID**: Developer pays in advance for the use of an API product. Funds are deducted from the developer's balance when the API product is used. The developer must maintain a prepaid balance sufficient to purchase the API product. - **POSTPAID**: Developer is billed monthly (through an invoice) for the use of API products. The developer pays for the use of API products based on the payment terms set by the plan(s) included on the invoice. - **BOTH**: Supports either billing type. Defaults to PREPAID. See [Configuring prepaid and postpaid billing types using the API](https://docs.apigee.com/api-platform/monetization/edit-organization-profile#billing-type-api). | | Category | `MINT_DEVELOPER_CATEGORY` | Developer category to which you want to add the developer. A developer category is a grouping of developers or companies with similar characteristics. For more information, see [Manage developer categories](https://docs.apigee.com/api-platform/monetization/manage-developer-categories). | | Company ID | `MINT_COMPANY_ID` | Company ID, if applicable. For more information, see [Grouping developers into companies](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#companies). | | Developer Type | `MINT_DEVELOPER_TYPE` | **This property is not used by Apigee.** Developer type. Valid values include: `TRUSTED` or `UNTRUSTED` | | Is Broker | `MINT_IS_BROKER` | Flag that specifies whether the revenue is based on net. | | Legal name | `MINT_DEVELOPER_LEGAL_NAME` | Legal name of the developer that will be used in all reports. **Note**: This attribute is required if the developer is not grouped with a company and wants to subscribe to a published rate plan. | | Self Billing | `MINT_HAS_SELF_BILLING` | Flag that specifies whether self-billing invoices are enabled. If enabled (`true`), monetization generates a self-billing invoice instead of a revenue share statement. A self-billing invoice is a financial document that details the amount due to the developer. It acts as an invoice to the API Provider on behalf of the developer. | | Tax Exempt Auth # | `MINT_TAX_EXEMPT_AUTH_NO` | Government tax exemption number, if applicable. | | Tax Rate | `MINT_APPROX_TAX_RATE` | Approximate tax rate for the developer. Specify a decimal value with a maximum number of 3 characters before the decimal and 4 characters after the decimal. | ## Managing developers using the API Manage developers using the [Developer APIs](https://apidocs.apigee.com/docs/developers/1/overview). When creating and updating a developer using the API, you can configure the monetization attributes described in [Configuring monetization attributes](https://docs.apigee.com/api-platform/publish/adding-developers-your-api-product#monetization-attributes), as required.