Application Management
What Is It For?
- Centrally manages consumer apps that access API products in the portal
- Ties apps to an organization, separating person (account) from app ownership
- Surfaces credential and API Product subscription counts on the list and detail
- Provides operational control via metadata, key generate/revoke, and unregister
- Closes the lifecycle safely by approving, archiving, or rejecting consumer deletion requests
Who Uses It?
- Portal administrators: To see all apps, edit them, and decide deletion requests
- Portal Developer roles: To manage apps in their authorized scope
- Support / operations: To verify credential and subscription state by org/app
Test → Prod promote, TEST/PROD credentials, and wizards are not on the Manager app pages. See Application Promote and Portal Settings → Prod Promotion. For live quota/traffic see Traffic & Usage.
Access
- Portal → Applications (route:
/admin/portal-app) — active portal scope - The same component also opens under Identity → Applications (
?source=identity); Project / Portal columns appear and the API Products section is hidden - Authorities: Admin, Portal Manager, Portal Developer (Portal menu)
List
Create opens the new-app dialog.
Filters
| Filter | Description |
|---|---|
| Search by App name | Search by name |
| Search by member account / developer | Finds apps via ACTIVE org memberships matched by account email/name |
| Organization | One or more organizations |
Columns
| Column | Description |
|---|---|
| App | Click name for view; description in tooltip |
| Organization | Badge → org overview |
| Credentials / API Products | Count badges from list-stats |
| Created Date | Created timestamp |
| Reference Id | Unique reference |
Badges on name:
- Deletion requested — consumer deletion request (
PENDING_DELETION) - Archived — archived app
No list badge for ACTIVE / SUSPENDED. Suspend has no Manager UI (backend only).
Row menu (⋮)
- View · Edit · Remove (immediate hard delete)
- When
PENDING_DELETION: Approve & delete · Approve & archive · Reject
Create
| Field | Required | Notes |
|---|---|---|
| App (Name) | Yes | Max 255 |
| Reference Id | Yes | Default UUID |
| Description | No | |
| Organization | Yes | There is no Account field |
Metadata, credentials, and product subscriptions are not in the create dialog; they are managed on edit/view. portalId / projectId come from the active portal context.
View
Header: name, Organization badge, Created Date; Edit / Delete.
Stat cards: Credentials count, API Products count (products hidden in Identity mode).
Information
- Details: name, description, organization, created, referenceId (project in Identity)
- Linked Resources: credential / product counts
- Metadata (read-only): Key, Value (secrets as
••••••••), Secret yes/no
Credentials & Products
- Credential chips (disabled ones secondary)
- Product chips: name · plan type · subscription status (no products in Identity)
Usage Report
App-scoped summary metrics panel (product filter + date range; successful / blocked / error / timing). For platform-wide views see API Traffic Report and Traffic & Usage.
Edit
Saved with Save and Deploy.
| Area | Editable? |
|---|---|
| Name, Description | Yes |
| Organization, Reference Id | No (read-only strip) |
| Metadata | Add/remove rows; key required and unique; value; secret + show/hide |
| API Keys / Credentials | Generate; table: apiKey, enabled, created, expire; Revoke |
| API Products | Plan/status visible; Unregister → UNSUBSCRIBED (new subscribe is not started here) |
Lifecycle
| State | How it appears | Manager actions |
|---|---|---|
| ACTIVE | Default / after Reject | Create, edit, direct Remove |
| PENDING_DELETION | Consumer deletion request (credentials disabled) | Approve & delete / Approve & archive / Reject |
| ARCHIVED | Approve & archive | Data kept; subscriptions unsubscribed |
| SUSPENDED | Backend only | No Manager UI |
Approve & delete permanently removes the app, credentials, ACLs, subscriptions, and gateway undeploy. Prefer archive to keep data.
Developer Portal
Consumer My Apps (create wizard, add subscription, Test only / Promote, deletion request) is documented on Application Promote. Manager does not approve promote on this page.