Adding Integration to a Project

You can integrate one or several ticketing systems with a specific Bright project. Therefore, you are able to select any of the repositories available for the specified Bright project when you start a new scan.

Prerequisites

Integration flow is divided into organization and project levels. At the organization level, basic integration settings are performed - in some cases, just turning it on or off. Complete integration setup is done at the project level. This is made in order to simplify and speed up the configuration process in companies with a large number of projects.

Step-by-step guide

Configuring the integration on the Organization level

1. First of all, you need to enable a particular ticketing integration. In the left pane, select the Organization page and scroll down to Integration settings.

   

2. Click the , and then click Settings.
   

3. Click Activate to continue.

4. Next, make sure you have granted all required permissions to the integration app.

   Congratulations! Now, everything is ready to be adjusted at the project level.

Configuring the integration on the Project level

1. Open the Projects page and choose the one project which you want to manage.

   

2. Click Settings and scroll down to Integration settings.

3. Click +Add Integration and choose the integration you have added in the organization-level step.

4. Choose a repository that you want to associate with this integration service.

5. Click Save.
   Now, this service is displayed in the Integration Settings list and successfully integrated.

Filtering the severity level of issues

You can select a certain severity level of issues to be sent to a repository/channel associated with your Bright project. For example, if you set the high severity level for the GitHub integration, then only the detected high severity issues will be displayed in your GitHub repository.

📘

Note

The option to filter issue severity is only available to the users whose roles include the integrations.repos:manage access scope. For more information, see Manage Access Scopes.

1. In the left pane, select Projects.
2. Click next to the project, which is integrated with the required ticketing service, and then select Settings.
3. In the INTEGRATION SETTINGS section, use the Issue severity dropdown menu to filter the issues that will be sent to the associated repository.

How to turn off the integration

1. To disassociate an integrated ticketing service, open the Project settings page and scroll down to the Integration settings.
2. Click and choose Disassociate.
3. Click Yes to continue.