# Feature JIM-239 - Jira connection test and run should check that PAT is an admin PAT

Project: Stream Jira to OpenProject data Migrator
Status: merged
URL: https://community.openproject.org/work_packages/JIM-239

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | 18.0.0 |
| Sprint |  |
| Backlog bucket |  |
| Votes |  |
| List |  |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

_No work packages_

## Features and Chunks

_No work packages_

## Bugs and other work packages

_No work packages_

## Technical Details

| Attribute | Value |
| --- | --- |
| Module | Integrations / Jira |
| Feature Flag |  |
| Requires doc change | No |
| Enterprise plan | Community (COM) |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |
| Product manager |  |
| Developers | Alfonso Mancilla |
| Designer |  |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| PD (min) |  |
| PD (max) |  |
| Work |  |
| Labor costs |  |

## Description

**As** an admin  
**I want to** have feedback about bad configuration as soon as possible  
**so that** I have proper guidance when connecting Jira for a migration and avoid errors later in the migration process

**Acceptance criteria**

*   When clicking Test connection and the PAT is from a user, it displays the following error: "Personal Access Token must be an admin token."
    
*   The caption for the "Personal Access Token" field mentions that it needs to be an admin token.
    
*   Add an information section about the PAT requirements
    
    *   PAT user must be an admin, mentioned like in [our documentation](https://www.openproject.org/docs/installation-and-operations/jira-migration/#:~:text=the%20migration%20tool,admin%20permissions)
        
    *   PAT user must be a member of the projects which should be migrated.
        
*   When starting an import run with a user PAT, display a similar error "Jira configuration uses a user Personal Access Token. Migration needs an admin Personal Access Token to run successfully. Please edit configuration with an admin token and try again."
    

**Technical notes**

*   <br>
    

**Permissions and visibility considerations**

*   _To whom is this feature visible?_
    
*   _When is it not visible?_
    

**Translation considerations**

*   _Key terms and phrases in the key languages_&nbsp;
    

**Out of scope**

*   <br>
    

_Set the_ **To be informed/consulted teams** _field to include all teams necessary to be informed of the changes._