Linear
The Linear integration allows you to:
- Connect Coana with your Linear workspace
The integration allows Coana to create and update issues in Linear. - Create configurations that integrate with Linear
Configurations hold information about the Linear team, priority, labels and other settings.
You can have multiple configurations, and configurations can be used by multiple projects. - Create Linear issues from any vulnerability by manual request
Automatic creation of Linear issues is not yet supported, but you can create Linear issues manually from any vulnerability.
Installation
Authorize the Coana app for Linear
Go to Settings → Integrations (opens in a new tab) page and click the "Add to Linear" button.
A new window will open the Linear authorization page.
Click the "Authorize" button to connect Coana with your Linear workspace. You'll be redirected back to Coana where the connection is confirmed.
Configuration
When the Linear integration is listed as "connected", you can create configurations for your Linear teams.
Click the "Configuration" button or go to Dashboard → Issue Tracking (opens in a new tab)
Click the "Create Configuration" button and fill in all the necessary fields.
Note: "Automatic actions" are not yet available.
See the Configuration options section below for more details.
Enable Linear integration for a project
Once you have a configuration, you can enable it for a project.
Find the project settings for the project you want to edit, and click the "Enable Issue Tracking" button. Select the configuration to use, and remember to click "Save".
Create issues
For any vulnerability, you can now create a Jira issue by clicking the "Actions" and "Create issue...".
The dialog will preview the issue that will be created. Click "Create issue" to create the issue in Jira.
When there's an issue related to the vulnerability, you can see the issue on the left side. There's a link to the issue in Jira, and you can also see the status of the issue.
Linear issue
Here's an example of a Linear issue created from Coana.
Issues created through the integration are tracked, and will automatically have their status updated in Coana. Additionally, if the issue is deleted in Linear, the issue will also be deleted in Coana.
Configuration options
Additional fields
You might have additional fields in Linear that you want to populate when creating an issue from Coana. You can add these fields in the configuration.
See the Linear developer documentation to get a picture of the fields available in Linear. https://developers.linear.app/docs/guides/how-to-create-new-issues-using-linear.new (opens in a new tab)
Click the "Additional fields" button to open the dialog.
Click "Add entry".
Fill in the key and value for the field you want to add.
Click "OK" when you are done.
Remember to press "Save & Close" to save the configuration.