https://github.com/jupiterone-archives/graph-jira

A graph conversion tool for https://www.atlassian.com/software/jira
https://github.com/jupiterone-archives/graph-jira

jira saas security-audit security-tools

Last synced: about 2 months ago
JSON representation

A graph conversion tool for https://www.atlassian.com/software/jira

• Host: GitHub
• URL: https://github.com/jupiterone-archives/graph-jira
• Owner: JupiterOne-Archives
• License: mpl-2.0
• Archived: true
• Created: 2019-03-05T21:24:04.000Z (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2024-07-22T15:21:34.000Z (5 months ago)
• Last Synced: 2024-11-06T00:15:18.459Z (about 2 months ago)
• Topics: jira, saas, security-audit, security-tools
• Language: TypeScript
• Homepage:
• Size: 1.6 MB
• Stars: 1
• Watchers: 10
• Forks: 8
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Codeowners: CODEOWNERS

Awesome Lists containing this project

README

        
# JupiterOne Integration

Learn about the data ingested, benefits of this integration, and how to use it

with JupiterOne in the [integration documentation](docs/jupiterone.md). The

askJ1 community also has documentation on Jira integrations here:

[Jira integration with JupiterOne](https://community.askj1.com/kb/articles/1009-jira-integration-with-jupiterone)

## Prerequisites

### Steps to running the graph-jira locally

1. Install [Node.js](https://nodejs.org/) using the

   [installer](https://nodejs.org/en/download/) or a version manager such as

   [nvm](https://github.com/nvm-sh/nvm) or [fnm](https://github.com/Schniz/fnm).

   Be sure to use Node version 18.x.

2. Install [`yarn`](https://yarnpkg.com/getting-started/install) or

   [`npm`](https://github.com/npm/cli#installation) to install dependencies.

3. Install dependencies with `yarn install`.

4. Register an account in the system this integration targets for ingestion and

   obtain API credentials.

5. `cp .env.example .env` and add necessary values for runtime configuration.

   When an integration executes, it needs API credentials and any other

   configuration parameters necessary for fetching data from the provider. The

   names of these parameters are defined in `src/instanceConfigFields.ts`. When

   executed in a development environment, values for these parameters are read

   from Node's `process.env`, loaded from `.env`. That file has been added to

   `.gitignore` to avoid committing credentials.

## Development

### Running the integration

1. `yarn start` to run integration and collect data

2. `yarn graph` to show a visualization of the collected data

3. `yarn j1-integration -h` for additional commands

### Making Contributions

Start by taking a look at the source code. The integration is basically a set of

functions called steps, each of which ingests a collection of resources and

relationships. The goal is to limit each step to as few resource types as

possible so that should the ingestion of one type of data fail, it does not

necessarily prevent the ingestion of other, unrelated data. That should be

enough information to allow you to get started coding!

See the

[SDK development documentation](https://github.com/JupiterOne/sdk/blob/main/docs/integrations/development.md)

for a deep dive into the mechanics of how integrations work.

See [docs/development.md](docs/development.md) for any additional details about

developing this integration.

### Versioning this project

This project is versioned using [auto](https://intuit.github.io/auto/).

Versioning and publishing to NPM are now handled via adding GitHub labels to

pull requests. The following labels should be used for this process:

- patch

- minor

- major

- release

For each pull request, the degree of change should be registered by applying the

appropriate label of patch, minor, or major. This allows the repository to keep

track of the highest degree of change since the last release. When ready to

publish to NPM, the PR should have both its appropriate patch, minor, or major

label applied as well as a release label. The release label will denote to the

system that we need to publish to NPM and will correctly version based on the

highest degree of change since the last release, package the project, and

publish it to NPM.

### Changelog

The history of this integration's development can be viewed at

[CHANGELOG.md](CHANGELOG.md).

[def]:

  https://community.askj1.com/kb/articles/1009-jira-integration-with-jupiterone