Overview

The Atlassian platform is a project management and issue tracking solution designed to optimize workflows and enhance collaboration. Its flagship product, Jira Software enables teams to plan, track, and manage tasks efficiently by offering customizable workflows, agile planning features, and real-time reporting.

Available Integrations

Product(s)	Supported Asset Type(s)	Integration Type
Jira Software	Devices	Action

Why You Should Integrate

Integrating with Atlassian will allow you to send Sevco findings about your Device assets back to your instance of Jira Software as an issue.

How Does the Integration Work

When a user creates an issue in Sevco, it is sent to their instance of Jira via API. From there, Atlassian processes the data and generates a functional Jira issue with the provided details.

This data is only used internally; we do not share it with any parties outside of Sevco. Refer to our privacy policy for details.

⚠️
Please review the configuration instructions in the section below before setting up permissions for apps.

Configuration

Configure the Access Schema

Basic Auth w/ URL

Field	Description	Example
`URL`*	The URL for your instance of Atlassian	`https://company.atlassian.net`
`Skip TLS Certification Validation`	Skip certificates validation when using a certificate that is self-signed or unable to be validated through a proper certificate authority	n/a
`Username`*	The Username associated with the Jira account you will be using	`[email protected]`
`Password`*	The Password associated with the Jira account you will be using	`***********************`

OAuth2

Field	Description	Example
`URL`*	The URL for your instance of Atlassian	`https://company.atlassian.net`

Add an Action: Select the integration(s) you'd like to add.
- Create Jira Issue
Configure General Information: OPTIONAL: You can use the following fields to provide additional information about your configuration.

Field	Description	Example
`Name (optional)`	Uniquely identifiable attribute of the configuration to delineate other similar configurations with the existing organization.	`DMZ network`
`Contact Person (optional)`	A placeholder to input a name or email address of a contact associated with the integration.	`Jane Doe`
`Link to Console (optional)`	A placeholder to input a link to the console of the product Sevco is integrating with for quick reference and access when configuring or editing the integration.	`www.product.com/devices`
`Email me about frequent errors`	Select this toggle to receive an email whenever an Integration has a ≥30% error rate in a 24-hour period.	n/a

Activate Config: Select "Activate" to enable this configuration and begin pulling data.

External Documentation

Creating credentials

You will be asked to provide credentials that Sevco will use for the Atlassian integration. The following link will step you through creating an account to configure the Access Schema. Atlassian Support – Create, edit, or remove a user

Required Permissions

Before configuring your Atlassian integration, make sure your API Token Access permissions are set to Allow

Basic Auth

The account used to integrate Sevco with Atlassian must have the following permissions:

Browse Projects
Create Issues
Assign Issues

OAuth2

To integrate Sevco with Atlassian, the OAuth2 schema will request the following scopes:

write:jira-work
read:jira-work

The account used to integrate Sevco with Atlassian must also have the following permissions:

Browse Projects
Create Issues
Assign Issues

API Documentation

Jira REST APIs

Contact Us

If you're having problems configuring an Integration, or if you've found something wrong in this document, please email us at [email protected] or suggest edits directly by selecting the Suggest Edits link located in the upper right hand corner of the documentation.