Linear
Visualize your Linear organization, projects, teams, and users in the JupiterOne graph and monitor changes to Linear entities by leveraging JupiterOne alerts.
- Installation guide
- Linear data model
Installation
To use this integration, JupiterOne requires an API key created by a user that has permissions to generate a new API key.
Configuration in Linear
- Generate an API key via the settings page.
- Copy the API key and save it for use within JupiterOne.
Configuration in JupiterOne
From the top-bar menu, select Integrations.
Scroll to, or search for, the Linear integration tile and click it.
Click the New Instance button and configure the settings:
- Enter the API Key generated in Linear in the Access Token field.
- Enter the Account Name by which you'd like to identify this Linear
account in JupiterOne. Ingested entities will have this value stored in
tag.AccountName
when Tag with Account Name is checked.
Click the Create button to complete the integration.
Next steps
Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data about your Linear environment within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.
Data Model
Entities
The following entities are created:
Resources | Entity _type | Entity _class |
---|---|---|
Issue | linear_issue | Record, Issue |
Organization | linear_organization | Account |
Project | linear_project | Project |
Team | linear_team | Team, UserGroup |
User | linear_user | User |
Relationships
The following relationships are created:
Source Entity _type | Relationship _class | Target Entity _type |
---|---|---|
linear_issue | CONTAINS | linear_issue |
linear_issue | ASSIGNED | linear_user |
linear_organization | HAS | linear_team |
linear_project | HAS | linear_issue |
linear_project | HAS | linear_user |
linear_team | HAS | linear_issue |
linear_team | HAS | linear_project |
linear_team | HAS | linear_user |
linear_user | CREATED | linear_issue |