Git Integration for Jira Self-Managed (Data Center/Server) Documentation

Contact Support
GitKraken Status  

Setting up webhooks

Before you can use webhooks, it needs to be enabled in the Git Integration for Jira webhook settings.

Access the Git Integration for Jira app webhook configuration page:

  1. Go to Jira dashboard menu Git ➜ Manage repositories.

  2. On the sidebar under Git Integration for Jira, click Webhooks.

  3. Enable the webhook feature by setting it to Enabled.

On this page, you can also find the Webhook URL and the Secret key for use with your git host webhook configuration.


Secret key

The secret key is a secure random-generated alphanumeric string at the time of the Git Integration for Jira app installation.

Disabling, reinstalling or even installing another version of the Git Integration for Jira app does not change the value of the key (for security purposes and unique identity). Administrators can manually change this key to a different value by generating another secret token according to your Git host and organization policies. For instance:

ruby -rsecurerandom -e 'puts SecureRandom.hex(32)'

The secret key also has the same restrictions on the valid set of characters as a regular URL. Invalid characters such as spaces, slashes, colon, etc. are not allowed. The default recommended length for the secret key is 32 chars and the maximum length is 255 chars.


More information on webhooks configuration

For detailed information on setting up webhooks for supported git hosts, see Git Integration for Jira: Integration webhooks.

The Git Integration for Jira app supports GitHub and GitLab push events to define individual repository to index. For more information, see Creating reindex triggers manually.


Prev: Setting up web linking

Next: Increasing timeout threshold for large repositories while doing a Git pull


More related articles on Git for Jira administrators

Setup GitLab Server to respond to incoming network API calls

New GitLab v10+ authentication

General settings: Improving Jira performance

Adding a repository hosted on Windows Servers or Windows Network Share (Admins)

Setting up repository root not located in Jira Home directory (Admins)

Reindex API to trigger indexing

Recommended reindex interval setting

Setting up web linking

Setting up webhooks (this page)

Increasing timeout threshold for large repositories while doing a Git pull

Working with Tracked folders

Recommended upgrade method for Git Integration for Jira

Discard cloned files in Jira Home directory (General setting)

Have feedback about this article? Did we miss something? Let us know!
On this page