Paran Labs

Group Org Sync for Jira Service Management

Keep JSM customer organizations in step with your user groups, automatically.

What it does

You map a user group to a customer organization. Every hour the app checks each mapping and, when it is due, adds the group's members to the organization. In mirror mode it also removes people it added itself once they leave every mapped group. Large groups are handled in small batches across runs, so nothing is lost or duplicated when a run is cut off or rate limited.

Getting started

  1. Install the app from the Atlassian Marketplace. You need to be a Jira administrator.
  2. Open Jira settings → Apps → Group Org Sync.
  3. Under Mappings, choose a user group and a customer organization, then add the mapping. You can map several groups to one organization.
  4. Under Settings, choose the mode and the interval, and add any accounts that must never be removed to the keep list. Save.
  5. Press Sync now to run the first sync at once, or wait for the hourly schedule.

Modes

Add-onlyGroup members are added to the organization. Nobody is ever removed.
MirrorMembers are added when they join a mapped group. The app removes an account only if the app itself added it to that organization and no mapped group still contains it. People you added by hand, and accounts on the keep list, are never removed.

Interval

Each sync runs once a day or once an hour. A settings change starts a fresh sync plan at the next run. A sync that is still in progress continues at the next hourly run.

Report

For each mapping the admin page shows the last check, the last change, and how many members were added, removed, failed or are still pending.

Permissions

manage:jira-configurationRead the members of the mapped user groups
manage:servicedesk-customerAdd members to and remove members from the mapped customer organizations
read:app-data:jira, write:app-data:jiraStore the app's settings and sync state in Forge app storage
report:personal-dataWeekly personal data reporting, so closed accounts are forgotten

Data and privacy

The app runs entirely on Atlassian and stores only account, group and organization IDs in your site's Forge storage. See the privacy policy.

Need help?

See Support or email support@paranlabs.com.