Jira Integration | Atlassian Forge App | Fluid Attacks Help

Jira integration

Integrates’ Jira integration is an Atlassian Forge app for Jira, written in TypeScript and built with React.
This app leverages the Atlassian Forge platform to extend the functionality of Jira, Atlassian’s backlog management software, with custom user interface components that bring Fluid Attacks’ services closer to our clients’ workflows on the Atlassian ecosystem.

Getting Started

Forge App

To start developing this app:
  1. Ensure that the Bitbucket app, named exactly “Bitbucket”, is available in your Okta account. If it is not, please request it at help@fluidattacks.com.
  2. After logging into the account, visit our Atlassian site.
  3. Before running the server, you need to make sure your Jira ephemeral is up on the Atlassian site. If you don't see your branch name, send a commit to deploy the dev environment.
  4. With an authenticated terminal, run integrates-jira.
  5. Look for the app with your branch name at the bottom of Jira’s left-side menu.
  6. If this is the first time you are going to run Jira locally, you will have to configure the app. First, go to Project Settings (bottom left menu) > Applications > Fluid Attacks - (the name of your branch). You will be prompted for an api token that you must generate in your own Integrates ephemeral.
  7. Edit code files and save them to see your changes reflected as you develop.

Jira Security

This is an integration made using the Jira security feature, which exposes some endpoints used by Atlassian to manage the security view in Jira projects.

The source code for this integration lives in the integrates backend; the endpoints can be found in integrates/back/integrates/jira_security_integration/endpoints.py.

Testing

Unit tests are implemented, using the convention used in all integrates.
  1. Atlassian Security Information
  2. Atlassian Security Information REST API

Forge platform

​Atlassian’s Forge platform provides a variety of APIs that we can use to build and extend features.

For more information on the Forge platform, refer to the official documentation.

Idea
Tip
Have an idea to simplify our architecture or noticed docs that could use some love? Don't hesitate to open an issue or submit improvements.