diff options
Diffstat (limited to 'doc/development/integrations/jira_connect.md')
-rw-r--r-- | doc/development/integrations/jira_connect.md | 36 |
1 files changed, 35 insertions, 1 deletions
diff --git a/doc/development/integrations/jira_connect.md b/doc/development/integrations/jira_connect.md index 66a93f8c947..408b0e6068e 100644 --- a/doc/development/integrations/jira_connect.md +++ b/doc/development/integrations/jira_connect.md @@ -1,7 +1,7 @@ --- stage: Create group: Ecosystem -info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers +info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments --- # Set up a development environment @@ -47,3 +47,37 @@ To install the app in Jira: You can also click **Getting Started** to open the configuration page rendered from your GitLab instance. _Note that any changes to the app descriptor requires you to uninstall then reinstall the app._ + +### Troubleshooting + +If the app install failed, you might need to delete `jira_connect_installations` from your database. + +1. Open the [database console](https://gitlab.com/gitlab-org/gitlab-development-kit/-/blob/master/doc/howto/postgresql.md#access-postgresql). +1. Run `TRUNCATE TABLE jira_connect_installations CASCADE;`. + +## Add a namespace + +To add a [namespace](../../user/group/index.md#namespaces) to Jira: + +1. Make sure you are logged in on your GitLab development instance. +1. On the GitLab app page in Jira, click **Get started**. +1. Open your browser's developer tools and navigate to the **Network** tab. +1. Try to add the namespace in Jira. +1. If the request fails with 401 "not authorized", copy the request as a cURL command + and paste it in your terminal. + + ![Example Vulnerability](img/copy_curl.png) + +1. Go to your development instance (usually at: <http://localhost:3000>), open developer + tools, navigate to the Network tab and reload the page. +1. Copy all cookies from the first request. + + ![Example Vulnerability](img/copy_cookies.png) + +1. Append the cookies to the cURL command in your terminal: + `--cookies "<cookies from the request>"`. +1. Submit the cURL request. +1. If the response is `{"success":true}`, the namespace was added. +1. Append the cookies to the cURL command in your terminal `--cookies "PASTE COOKIES HERE"`. +1. Submit the cURL request. +1. If the response is `{"success":true}` the namespace was added. |