Installation and setup
Junban Desk comes in two editions. The Cloud edition is available now; the Marketplace edition is coming soon.
Cloud edition — available now
The Cloud edition is hosted, so there is nothing to install into Jira.
- Go to app.junbandesk.com and choose Sign in.
- You are sent to Atlassian to authorize Junban Desk (a standard OAuth consent screen). This happens once; approve the requested scopes (listed below).
- Back in the app, pick a project from the project picker.
That’s it — the workspace opens on the project’s needs-action queue. The Cloud edition works with both classic Jira Service Management and Customer Service Management projects.
Marketplace edition — coming soon
Once the Atlassian Marketplace listing is live:
- In Jira, go to Apps → Explore more apps (you need Jira admin permission).
- Search for Junban Desk and choose Install (or start a free trial).
- Accept the requested permissions (listed below).
There is nothing to configure. Open any Jira Service Management project and choose Junban Desk in the project sidebar, under Queues.
Requirements
- Jira Service Management (Cloud). Agents need the usual JSM agent permissions in the project (browse issues, add comments, transition issues, assign issues). Junban Desk enforces nothing of its own — see Permissions.
- Marketplace edition: the workspace appears in JSM projects only.
- Cloud edition: a one-time Atlassian OAuth authorization, and a modern browser. No admin install is required — any agent can sign in.
Permissions
Both editions request the minimum OAuth scopes needed for the workspace, and every Jira API call runs as the logged-in user — so Jira’s own permission checks always apply. An agent can never see or do anything through Junban Desk that they couldn’t do in Jira directly.
| Scope | Why | Editions |
|---|---|---|
read:jira-work |
Load the queue, ticket details, and comment threads | Both |
write:jira-work |
Post replies and internal notes, transition and assign tickets | Both |
read:jira-user |
Show reporter/assignee names and the assignable-user dropdown | Both |
read:servicedesk-request |
Look up the “Time to resolution” SLA for the optional SLA column | Marketplace |
offline_access |
Refresh the session token so you stay signed in between visits | Cloud |
Marketplace edition runs on the Atlassian Forge Platform (asUser()); it makes no external network calls and
stores no data outside Atlassian — see the privacy policy.
Cloud edition is hosted outside Atlassian and connects to your Jira site over Atlassian’s REST API; its data handling differs — see app.junbandesk.com/privacy.
Installing from source (self-managed)
The Open Source Forge edition (Apache 2.0) — run your own copy on your own Forge app id; see the README. Self-hosting instructions are included.
Test without any installation or admin action: The Cloud edition runs as a hosted service at app.junbandesk.com.