Connect a Site Wizard

Accessible Site

1. Follow the instructions to install the ‘Jira Integration’ plugin on your Jenkins site.
2. Click Next.
3. Provide a Name.
4. Provide the Site URL.
5. Select Accessible accessibility.
   • • For security purposes, only ports 80 8080, 443 and 8443, http and https respectively, are supported on Jira Cloud.
     • The Jenkins counterpart plug-in is required to be installed before the site can be added on Jira Cloud.
     • You may need to update your firewall rules to allow traffic from the cloud app, see Security section for details.
6. Click Next. If you don’t want to alter the defaults, click on Save and Connect to jump to step 13.
7. Optionally, provide a Display URL in case the Site URL is not accessible by users and a different URL should be used in the UI features.
8. Optionally, as Jira site administrator, provide a Scope in case you want to limit the site integration to a specific Jira project.
9. Optionally, un-check the Enabled for Synchronization checkbox if you want to connect the site but not enable it for job and build synchronization.
10. Optionally, un-check the Auto enable new Jobs checkbox if you don’t want to enable all Jobs on the site by default, including future new jobs. You will be required to manually select the jobs you want to synchronize once the site in added and connected.
11. Optionally, un-check the CSRF Protection checkbox if the Jenkins site doesn’t use CSRF protection.
12. Click Next
13. Select you preferred method of registering the Jira site with your Jenkins site.
    • Select Automatic to let the app register itself with Jenkins. You will need to provide Jenkins administrative credentials to use this.
    • Select Manual to use the provided Registration Secret and Token to manually register the Jira site in Jenkins.
    • Select Configuration as Code to use the Jenkins Configuration as Code feature to register the Jira site through configuration code.
14. Click Connect to finalise the connection. Alternatively click Connect latest to complete the registration at a later point in time.

Inaccessible Site

1. Follow the instructions to install the ‘Jira Integration’ plugin on your Jenkins site.
2. Click Next.
3. Provide a Name.
4. Provide the Site URL.
5. Select Inaccessible accessibility option.
6. Click Next. If you don’t want to alter the defaults, click on Save and Connect to jump to step 11.
7. Optionally, as Jira site administrator, provide a Scope in case you want to limit the site integration to a specific Jira project.
8. Optionally, un-check the Enabled for Synchronization checkbox if you want to connect the site but not enable it for job and build synchronization just yet.
9. Optionally, un-check the Auto enable new Jobs checkbox if you don’t want to enable all Jobs on the site by default, including future new jobs. You will be required to manually select the jobs you want to synchronize once the site in added and connected.
10. Click Next
11. Select you preferred method of registering the Jira site with your Jenkins site.
    • Select Manual to use the provided Registration Secret and Token to manually register the Jira site in Jenkins.
    • Select Configuration as Code to use the Jenkins Configuration as Code feature to register the Jira site through configuration code.
12. Click Connect to finalise the connection.