Some key tips for setting up Jira and iobeya via OAuth 2.0 (Behind network security for onsite clients)

If you are setting up Jira addon integration with iObeya via OAuth 2.0 protocol and your company has implemented security components in your network frontline (DMZ/proxy/firewall) , please consider these tips:

 

  • DMZ Compatibility: make sure your DMZ configuration supports OAuth 2.0
  • Firewall and Ports: Allow traffic through necessary ports (usually 80 and 443).
  • Proxy: Ensure proxies don't prevent Jira-iObeya communication.
  • User Permissions and scope: Ensure user accounts have admin privilege in Jira and iobeya
  • Client IDs and Secrets: Ensure that the client IDs and secrets used in the OAuth 2.0 flow are accurate and match between Jira and iObeya.
  • Redirect URLs: Verify that the redirect URLs specified in your Jira and iObeya configurations are correctly configured and accessible from your DMZ.

 

By following these steps, you'll facilitate the communication between Jira and iObeya.

 

Jira

Some key tips for setting up Jira and iobeya via OAuth 2.0 (Behind network security for onsite clients)

IObeya is based on the domain name, so changing the IP address of your Jira server will have no impact
 
ApplicationJira

Some key tips for setting up Jira and iobeya via OAuth 2.0 (Behind network security for onsite clients)

It is possible that a Jira project will change its name, its key or its workflow. If it is used in iObeya, what are the impacts and how to manage them?

Warning: To avoid any problems, we recommend testing beforehand on a test project

1°) Change of key

Impact : The jira cards are considered archived and therefore no longer linked to the project.

 

Actions to be taken:

  • Reconfigure the Jira tool set in the docks
  • Do a mass import to recreate the cards.
  • Delete the cards with the old key

 

Related documentation :

2°) Change of workflow

  • Special case of the Kanban board :

 

Impact : The board being based on the workflow states, we do not benefit from the changes on the iObeya side (more or less states, name changes, etc)

 

Action to be taken : The board must be recreated in order to use the new workflow

 

Related documentation : Create a Kanban board

 

  • Other cases : For any other case, you just need to update the jira cards.


Related documentation :
Update jiras cards

3°) Change of name

If there is only a name change, the only impact will be in the name of the board, once entered in (top left).

Unfortunately, to correct this, the only possibility is to recreate the board.

Jira

Some key tips for setting up Jira and iobeya via OAuth 2.0 (Behind network security for onsite clients)

The Jira connector for iObeya uses the Jira REST API services to query and update data in your Jira instance. The connector uses OAuth as recommended by Atlassian when integrating with their product.

 

Depending on the version of Jira you use (e.g Cloud, Server, Data Center), here are the supported versions of OAuth that you can use when configuring the Jira connector:

  • Jira Cloud: OAuth 1.0
  • Jira Server: OAuth 1.0 & OAuth 2.0
  • Jira Data Center: OAuth 1.0 & OAuth 2.0
 
To use OAuth 2.0 you need iObeya 4.16 or any upper versions.
 

Beware, with the latest versions of Jira Data Center, OAuth 1.0 does not appear listed when creating a new application link in Jira. However, as explained the Jira DC documentation, select Atlassian Product to create an app link for iObeya using OAuth 1.0.

AdministrationJira

I think I found a bug in iObeya, can you help me?

The iObeya Support Team will do its best to find a solution. So we need as much information as possible to be as efficient as possible and make basic, initial checks:

  • If an error message occurs, copy it (in text format)
  • Take a screenshot of your entire iObeya page. Make as much readable as possible
  • The context is important:
    • If you remember, explain to us the different steps you went through before encountering the issue.
    • If a screenshot/video is relevant, send it. Please note that a global view is the best, not just a focus of the situation.

If possible, ask your iObeya platform administrator to:

  • Download the logs from the menu "Tools/Download logs" in the administration, send them by telling us approximately the date & hour the issue happened.
  • Download the system information of your server from the menu "Tools/System information" in the administration (the button is at the bottom of the page).

 

Finally contact the iObeya Support Team to provide the collected information and we will help you.

AdministrationApplicationDebugJiraMobile appQCDSetup and maintenance