You can securely manage all your Forge apps, Cloud Fortified Connect apps and OAuth 2.0 (3LO) integrations in one place using the Atlassian developer console.
The developer console lets you view information about your apps and integrations, including their scopes and environments.
To access the console:
Your apps and integrations are listed with the following details:
For Jira apps, the app name isn't the name displayed to users in the Jira issue. To change the name that appears in the Jira issue, you need to update the title in the manifest.
Your apps and integrations are listed in the order that they were last updated. You can search for an app using the search bar above the app table.
Select a Forge app on the My apps screen to get more information about it, including app ID, environments, and permissions.
The Overview page displays the following panels:
You can view the level of access your Forge app has to an Atlassian user’s account by selecting Permissions in the left menu, or selecting the Permissions panel.
The Permissions page lists the APIs included in your Forge app, where you have added at least one scope from that API to your app's manifest file. For the APIs and scopes to display on the Permissions page, you'll need to deploy your app to the production environment. See Environments and versions for more details.
To see the individual scopes for an API, select View.
Note, you can’t configure scopes for a Forge app from the developer console. To add scopes, see Add scopes to call an Atlassian REST API.
To learn more about Forge app permissions, see Security. For more information about individual scopes, see Permissions.
Any new Forge apps you create using the CLI appear in the console, and any changes you make to existing Forge apps using the CLI are reflected in the console.
The process of deleting Forge apps varies, depending on whether you've listed your app on the Atlassian Marketplace or you've distributed your app via the developer console.
By listing a Forge app on the Atlassian Marketplace, the app effectively becomes one of the following:
To delete a paid via Atlassian Forge app, see the Paid via Atlassian cloud apps only documentation. To delete a free Forge app, see the Free apps documentation.
For both paid via Atlassian and free apps, there are end-of-life (EOL) terms to consider when deleting the app from the Marketplace. The EOL terms only apply to apps with active customers. See Manual retiring of apps for more details.
You can delete the app via the console if the app is not installed on a site.
If the app is currently installed on a site, do one of the following:
If you created Forge apps using Atlassian accounts based on aliases of the same email, then the list of apps for each account is treated independently. This means you need to uninstall the apps from each account individually.
For example, if you have an Atlassian account associated with simon@example.com, you can create separate Atlassian accounts based on aliases of the account, such as si.mon@example.com and simon+app@example.com. If you signed up for Forge and created apps on all of these accounts, you need to uninstall the apps for each individual account.
App admins can download audit logs for apps that use Forge-hosted storage. Audit logs contain details of audit events related to changes made in the storage location of app data.
Unlike app logs, which record events related to the app's operation and performance, audit logs are used for security and compliance purposes. They serve as supporting evidence for audits, demonstrating that the movement of app data was conducted in accordance with customer requests through Atlassian's Data Residency controls.
Audit logs are available for download for a duration of two years. After this period, the logs are permanently deleted from the database and are no longer included in the downloadable CSV file.
When an app is uninstalled from a tenant, audit logs are available for 30 days. After 30 days, the related logs are erased from the database and can no longer be downloaded.
When an app is uninstalled from a tenant, audit logs remain available for download for 30 days. Since you as partner don’t know when an app is uninstalled from a tenant, we recommend downloading audit logs at a regular cadence to capture logs from uninstalled apps.
When a customer site admin moves their Jira or Confluence data to a location, that product’s status
will then appear as PINNED
. For any Forge apps installed on that product, all app data within the
hosted storage is also moved to that same PINNED
location as the host product.
Audit logs capture these data migration events, including when a migration has been scheduled, started, completed, or failed. See Data Residency and Move product data to a different location for more information.
Audit logs capture app installation and uninstallation events within a tenant.
On March 28, 2024, Atlassian triggered a migration event for data residency for all Forge apps using
hosted storage. For any apps deployed before this date, audit logs will include two entries for
those events, Forge backfill started
and Forge backfill completed
. See the
changelog for more details.
The following fields show the event metadata captured in audit logs:
Field | Description | Examples |
---|---|---|
App ID | The unique identifier of the Forge app. | 83ba0476-7067-4011-9a80-0a132d9ff63a |
App name | The name of the Forge app. | spam-log |
Site ID | The unique identifier of the site. | 87f02c6d-d051-4671-9338-612c4460f2fb |
Product | The name of the product associated with the app. | Confluence |
Environment | The environment of the Forge app. | Production |
Installed version | The installed version of the Forge app. | 3.1.0 |
Event | The status of a migration event or app lifecycle event. | Migration scheduled Migration completed App uninstalled |
Event date | The date when the event takes place. | 2024-03-12 |
Location | The current location of the site's data. | Global |
Target location | The intended location for the migration event. This field is marked as N/A during lifecycle events, which are app installation and app uninstallation. | US |
Only app admins have permission to download audit logs.
You can download audit logs via the console:
If you encounter an error when trying to download audit logs, check that your app is using hosted storage, or try a different date range. Remember, you can only download audit logs for apps that use hosted storage within the last two years.
Rate this page: