Short version: the app runs on Atlassian Forge. Your attachments and work items stay in Jira. The app stores labels, flags and settings in storage that Atlassian hosts for your site, and sends nothing to any other service.
Architecture
| Component | Where it runs | Operated by |
|---|---|---|
| User interface | The user’s browser, in a sandboxed frame inside Jira | Served by Atlassian |
| App functions | Atlassian Forge | Atlassian |
| App storage | Atlassian Forge, in your site’s region | Atlassian |
| Jira REST API and attachments | Atlassian Cloud | Atlassian |
| Servers of Green Builds Software | Do not exist |
What the app can access
A Jira administrator approves these permissions when installing the app.
| Permission | What the app uses it for |
|---|---|
read:jira-work |
Read work items and their attachments |
write:jira-work |
Delete attachments when a user asks for it, and save an attachment’s labels on its work item |
read:jira-user |
Show the name and avatar of the person who uploaded a file |
write:user.property:jira |
Remember each user’s settings, such as column widths |
manage:jira-project |
Save the JQL search of a project |
storage:app |
Store labels and flags, and remember when the app was first used on your site |
Requests are made on behalf of the signed-in user. Jira applies that user’s permissions, so nobody sees or deletes an attachment they could not see or delete in Jira itself.
What the app stores
| Data | Where |
|---|---|
| Labels: name and colour | App storage on Atlassian Forge |
| Which attachment is flagged | App storage on Atlassian Forge |
| Which attachment has which labels | A property of the work item in Jira |
| The saved JQL search of a project | A property of the project in Jira |
| A user’s column and download settings | A property of the user in Jira |
| The date the app was first used on your site | App storage on Atlassian Forge |
The app does not store file names, file contents or work item texts. When the app is uninstalled, Atlassian deletes its storage.
Usage and error logs
To find and fix errors, the app writes a small number of entries to its log on Atlassian Forge:
- that the app was opened, and where,
- that a search has finished, with the number of work items and attachments it loaded and how long it took,
- errors, with their technical details.
The entries contain no user ID and no site ID, and no file names, file contents or work item texts. We can read these logs in Atlassian’s developer console, where Atlassian shows which installation an entry came from. Atlassian keeps app logs only for a limited time, currently up to 60 days, and they are not passed on to anyone.
Data residency
App storage follows Atlassian’s data residency for Forge apps. Attachments never leave Jira’s own storage unless a user downloads them.
Reporting a vulnerability
Use our vulnerability report form, or write to support@green-builds.com. How we handle reports is described in the Trust Center.