Creating an App Link for Jira Server and DC

Once you've added the Playbook for Jira app to your workspace and you want to connect to a Jira Server or Data Center instance, you first need to set up an application link with your Jira instance. Remember, you must have admin access in your Jira instance to set up an app link!

1. From Slack, click Playbook for Jira in the Apps section.
   
   The app opens to the Home tab.

   If the app isn't in your list of apps, click Add apps and search for it by name.

2. On the app Home tab, click Jira Server/DC.
   
   
   

3. Click Create App Link (or, if you already have an existing Jira connection, click Add New Instance).
   
   The Configure New Instance wizard opens. 
   
   
4. Wizard Step 1:
   
   1. Enter a Jira instance name.

   2. Enter the base URL for the Jira instance you want to connect to your Slack workspace.

      While base URLs usually end in .com, yours may extend beyond that.
   3. Click Next.
      
      
5. Wizard Step 2:
   1. Click Application Links.
      A new browser tab opens to a Jira Administration page. (You may have to log in to your Jira instance.)
   2. In Jira, click Create Link.
      
      The Create Link dialog appears.
   3. Ensure Atlassian Product is selected for the application type.
   4. Enter https://playbook-for-jira.slack.apps.adaptavist.com  for the Application URL.
   5. Click Continue.
      
      The Configure Application URL dialog appears.
      
      
6. Wizard Step 3:
   
   1. Click Continue when the "No response was received from the URL entered" message appears.
      
      The Link Applications dialog appears. 
   2. Enter  Playbook for Jira  in the Application Name field, check the Create incoming link checkbox, and click Continue.
      
      The second Link Applications dialog appears. 
   3. Return to the wizard and click Next.
      
      
7. Wizard Step 4:
   1. On the second Link Applications dialog:
      1. Type PB4J in the Consumer Key field.
      2. Type PB4J in the Consumer Name field.
      3. Copy/paste the public key text from Step 4 of the wizard into the Public Key field, including the begin/end public key text.
      4. Click Continue.
         
         A successfully configured app link looks similar to this. You can ignore and dismiss the warning message about the app being offline.
         
   2. Return to the wizard and click Finish.
      A congratulatory message appears—and deservedly so!