Jira Integration – Technical & Review Documentation

Overview

Genchi Jira Integration is an OAuth 2.0 (3LO) app credential for secure, user-consented access to Jira Cloud data within the Genchi project status app. It allows Genchi admins to import Jira projects, epics, issues, and users for sentiment tracking.

No standalone install — it's embedded in Genchi's admin integrations screen. Handles Personal Data Report (PDR) compliance for stored data (account IDs, emails). No iframes, Connect descriptors, or Forge modules are used. All interaction occurs via the standard Jira Cloud REST API after user consent.

OAuth 2.0 (3LO) Details

• Client ID: 6J0HKYr0ln5FUBNMyEDA15wft0teQiHN
• App ID: 90e3c995-c075-46da-a175-03c1dcb368e0
• Authorization URL:
  https://auth.atlassian.com/authorize?audience=api.atlassian.com &client_id=6J0HKYr0ln5FUBNMyEDA15wft0teQiHN &scope=read%3Ajira-work%20write%3Ajira-work%20read%3Ajira-user%20offline_access &redirect_uri=https%3A%2F%2Fgenchi.com%2Fapi%2Fjira%2Fcallback &response_type=code &prompt=consent Copy Copied!
• Redirect URI: https://genchi.com/api/jira/callback
• Requested Scopes: read:jira-work write:jira-work read:jira-user offline_access

Functionality

• Admin-only connection from Genchi → Admin → Integrations → Connect Jira
• One-time import of selected projects, epics, issues, subtasks → Genchi Initiatives
• Admin option to automatically create/link Genchi users from Jira assignees
• Duplicate-name handling with auto-rename
• One-way sync only — Genchi reads from Jira; no data is written back to Jira issues, projects, or any other resource. The write:jira-work scope is requested for compatibility with a planned future feature but is not exercised by this release.
• Weekly Personal Data Report (PDR) via /app/report-accounts

Security & Compliance

• Access & refresh tokens encrypted at rest with AES-256-CBC
• Automatic token refresh on 401 responses
• Personal Data Report enabled weekly
• No data exported back to Jira
• Privacy Policy: https://www.genchi.com/privacy-policy.html
• Terms of Service: https://www.genchi.com/terms-of-service.html

Test Instructions for Reviewers

1. Create a free Genchi trial account at app.genchi.com/create-account
2. Log into Genchi → Admin → Integrations → "Connect" next to Jira
3. Authorize with any Jira Cloud site (we can provide a dedicated test site on request)
4. Open the import modal, select a project or individual items, and click Import
5. Verify Initiatives appear in Genchi with correct hierarchy and assignees from Jira
6. (Optional) To simulate a check-in, double-click on the initiative and set an appropriate Cadence and channel under the Cadence tab. Check-ins are scheduled and run on the chosen day(s) — they do not fire immediately.
7. (Optional) To receive a check-in via Slack, the Slack workspace must also be connected (Admin → Integrations) and your user must be linked (auto-linked when Genchi and Slack emails match, or manually via Admin → Integrations → "Sync Slack IDs"). Once connected, you can also use /checkin [initiative_name] in Slack to trigger an on-demand check-in outside of the scheduled cadence.
8. (Optional) Trigger Personal Data Report (PDR) manually or wait for weekly run — confirm deletions/updates are reflected.

Contact

For any questions, test accounts, demo environment access, or review support, please contact:
support@genchi.com