Jira Integration

📘

The Jira integration is available on Business and Enterprise plans.

Connect your Jira Cloud instance to Socket to create and manage Jira tickets directly from Socket alerts. Create tickets manually from individual alerts, or set up automated ticketing rules that create, update, and resolve Jira issues based on alert events in your organization.

The integration is powered by the Socket for Jira Atlassian Forge app, which is installed in your Jira Cloud instance and connected to your Socket organization.

Key capabilities

• Manual ticket creation — Create a Jira ticket from alerts in the Socket dashboard.
• Automated ticketing rules — Define rules that automatically create Jira tickets when specific alert events occur, with configurable conditions, issue types, priorities, labels, assignee and additional fields.
• Two-way sync — When Jira issues are updated, resolved, or deleted, Socket is notified and can update the alert accordingly.
• Multi-organization support — A single Jira site can optionally be connected to multiple Socket organizations.

Prerequisites

• Confirm your Socket account is on a Business or Enterprise plan.
• Have a Jira Cloud instance ready (Jira Server and Data Center are not supported).
• Hold an Owner or Admin role in your Socket organization (required to connect the integration).

Connect Jira to Socket

Step 1: Install the Socket for Jira app

Go to Dashboard → Settings for your organization and select "Jira" in the menu (under “Integrations”).

1. Click the "Connect" button.
2. Click the installation link. This will open a new window in Atlassian.
3. Click "Get app", select the site and click "Install".

📘

You must have Jira admin permissions to complete the installation.

If you cannot install apps directly, request installation from your Jira administrator.

Step 2: Open the app configuration page

Once installed, navigate to the app's configuration page:

1. Go to Atlassian Administration → Apps → Sites → select your Jira site.
2. In the list of Connected apps, find Socket for Jira.
3. Click the three-dot menu (⋯) on the right side and select Configure.

Step 3: Connect the app to Socket

On the configuration page:

1. Click the Connect to Socket button. This opens the Socket dashboard in a new window.
2. If you are not already logged in, sign in to your Socket account.
3. Confirm which Socket organization to connect to your Jira site.
4. Click Connect to complete the setup.

Once connected, the configuration page in Jira shows a success message confirming the connection.

📘

Only Socket administrators (Owner or Admin role) can complete the connection step. If you are not an administrator, copy the connection link from the Jira configuration page and share it with your Socket administrator.

Step 4: Verify the connection

In the Socket dashboard, go to Settings → Integrations → Jira. You should see your Jira site listed with a Connected status badge, along with details about who connected it and when.

Disconnect Jira

To disconnect a Jira site from your Socket organization:

1. Go to Settings → Integrations → Jira in the Socket dashboard.
2. Find the Jira site you want to disconnect.
3. Click Disconnect.

This removes the link between the Jira site and your Socket organization. The Socket for Jira app remains installed in Jira and can be reconnected later.

Multi-organization support

By default, a Jira site can be connected to a single Socket organization. To connect the same Jira site to multiple Socket organizations:

1. Open the Socket for Jira configuration page in Jira (see Step 2 above).
2. Enable the Allow this app installation to be used with multiple organizations toggle.
3. Use the Connect to Socket button again to link additional Socket organizations.

Create Jira tickets from alerts

Once the integration is connected, you can create Jira tickets directly from alerts in the Socket dashboard.

1. Open an alert in the Socket dashboard.
2. Click the Create Ticket button.
3. Select the Jira site, project, issue type, and fill in any additional fields.
4. Submit to create the ticket.

The created ticket is linked to the alert. A link to the Jira ticket appears on the alert, allowing you to navigate directly to it.

Automated ticketing rules

Automated ticketing rules let you define conditions under which Jira tickets are automatically created, updated, or resolved. Configure these rules from Settings → Integrations → Ticketing in the Socket dashboard.

📘

Ticketing is available on Business and Enterprise plans.

Create a ticketing rule

Click Create Configuration to start the 5-step wizard:

1. Select events

Choose which events should trigger the rule.

2. Select conditions

Optionally define conditions to filter which alerts match this rule. This lets you target specific alert types, priority levels, repositories or other attributes.

3. Select project

Choose the Jira connection and project where tickets should be created:

• Integration — Select which connected Jira site to use.
• Project — Seach and select the Jira project where tickets will be created.

4. Configure issue

Define how the Jira issue should be created:

• Issue type — Select the Jira issue type (e.g., Bug, Task, Story).
• Priority — Set a specific priority, or use Auto to have Socket map the alert priority to a Jira priority automatically.
• Labels — Optionally add labels to created issues.
• Assignee — Optionally assign the issue to a specific team member.
• Additional fields — Configure any other fields supported by your Jira project.

5. Configure actions

Define what happens when alert state changes:

• Create issue — Automatically create a new Jira issue when the rule conditions are met.
• Update issue — Update the linked Jira issue when the alert is updated. Additionally you can transition the Jira issue to a specific status when the alert is cleared in Socket.
• Dismiss on ticket closure — Optionally triage-ignore the Socket alert when the linked Jira ticket is closed.

After reviewing the summary, click Create to activate the rule.

Permissions

Socket roles

Jira app permissions

The Socket for Jira app requests the following Jira permissions:

• Read Jira work — Required to read issue data such as projects, issue types, priorities, statuses, and labels.
• Write Jira work — Required to create and update Jira issues on behalf of the integration.

The app does not access or modify any other Jira data.

Troubleshooting

The 'Connect to Socket' button is not visible

The connection URL is only available after the Socket for Jira app has been installed and has completed its initial setup. If the button is missing, try refreshing the configuration page.

Connection token is invalid or expired

Connection tokens expire after 7 days. If you see a warning that the token is invalid or expired, go back to the Jira configuration page and click Connect to Socket again to generate a fresh token.

I cannot complete the connection

Only users with Owner or Admin roles in the Socket organization can complete the connection. If you have a different role, copy the connection link from the Jira configuration page and share it with an administrator.

Tickets are not being created automatically

Verify the following:

1. The ticketing rule is set to Active status.
2. The Jira site is still connected (check Settings → Integrations → Jira).
3. The alert event matches the rule's event and condition filters.
4. The Jira project and issue type are still valid in your Jira instance.

I have another problem

If you encounter problems or have questions not explained here, please do not hesitate to contact support.

Next steps

• Webhooks — Set up webhooks to receive real-time notifications for alert events.
• Customizable Security Policies — Configure which alert types trigger warnings and blocks across your organization.
• Organization Alerts — Review and manage alerts across all repositories in your organization.