---
title: Configuring Jira
description: When accessing a direct link to a subpage within Jira with no user session, the login link does not work correctly. This is the workaround.
component: atlassian
page_id: atlassian:atlassian_integration_kit:pf_atlassian_ik_configuring_jira
canonical_url: https://docs.pingidentity.com/integrations/atlassian/atlassian_integration_kit/pf_atlassian_ik_configuring_jira.html
revdate: July 2, 2024
section_ids:
  about-this-task: About this task
  steps: Steps
---

# Configuring Jira

## About this task

When accessing a direct link to a subpage within Jira with no user session, the login link does not work correctly. This is the workaround.

## Steps

1. Copy the following files from the distribution package to the Atlassian jsp directory: `<Atlassian Installation Directory>/Jira/atlassian-jira/`

   * `dist/jira/login.jsp`

   * `dist/jira/default.jsp`

2. Edit the two jsp files copied in the previous step and update the values for the four variables at the top of the file. For information on what these should be, refer to step 3 of [Configuring Seraph](pf_atlassian_ik_configuring_seraph.html).

3. Make a backup copy of `<Installation Directory>/Jira/atlassian-jira/WEB-INF/web.xml`.

4. Open this file in a text editor: `<Installation Directory>/Jira/atlassian-jira/WEB-INF/web.xml`

5. Disable the default and login pages by adding comment blocks around the \<servlet> and \<servlet-mapping> nodes.

   ```
   <!--
       <servlet>
           <servlet-name>jsp.default_jsp</servlet-name>
           <servlet-class>jsp.default_jsp</servlet-class>
       </servlet>
   -->

   <!--
       <servlet>
           <servlet-name>jsp.secure.default_jsp</servlet-name>
           <servlet-class>jsp.secure.default_jsp</servlet-class>
       </servlet>
   -->

   <!--
       <servlet>
           <servlet-name>jsp.secure.project.default_jsp</servlet-name>
           <servlet-class>jsp.secure.project.default_jsp</servlet-class>
       </servlet>
   -->

   <!--
       <servlet>
           <servlet-name>jsp.secure.admin.default_jsp</servlet-name>
           <servlet-class>jsp.secure.admin.default_jsp</servlet-class>
       </servlet>
   -->

   <!--
       <servlet-mapping>
           <servlet-name>jsp.default_jsp</servlet-name>
           <url-pattern>/default.jsp</url-pattern>
       </servlet-mapping>
   -->

   <!--
       <servlet-mapping>
           <servlet-name>jsp.secure.default_jsp</servlet-name>
           <url-pattern>/secure/default.jsp</url-pattern>
       </servlet-mapping>
   -->

   <!--
       <servlet-mapping>
           <servlet-name>jsp.secure.project.default_jsp</servlet-name>
           <url-pattern>/secure/project/default.jsp</url-pattern>
       </servlet-mapping>
   -->

   <!--
       <servlet-mapping>
           <servlet-name>jsp.secure.admin.default_jsp</servlet-name>
           <url-pattern>/secure/admin/default.jsp</url-pattern>
       </servlet-mapping>
   -->

   <!--
           <servlet>
               <servlet-name>jsp.login_jsp</servlet-name>
               <servlet-class>jsp.login_jsp</servlet-class>
           </servlet>
   -->

   <!--
           <servlet-mapping>
               <servlet-name>jsp.login_jsp</servlet-name>
               <url-pattern>/login.jsp</url-pattern>
           </servlet-mapping>
   -->
   ```