--- title: "Jira konnektor" description: "Teljes Jira Cloud integrációs útmutató hibajegyek, projektek és csapataktivitás-adatok Brevóval való szinkronizációjához a Tajo segítségével." url: https://tajo.io/hu/docs/connectors/custom/jira/ markdown: https://tajo.io/hu/docs/connectors/custom/jira.md lang: hu-HU robots: noindex --- Kérj korai hozzáférést Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét. # Jira konnektor Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort. | Forrásmező | Célmező | Mintaérték | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Csatlakoztasd a Jira Cloud példányodat a Brevóhoz ügyfél-oldali hibajegy-követéshez, support jegy láthatósághoz és projekt mérföldkő-értesítésekhez a Tajo segítségével. ## Áttekintés | Tulajdonság | Érték | | --- | --- | | **Platform** | Jira Cloud | | **Kategória** | Egyéni | | **Telepítés bonyolultsága** | Közepes | | **Hivatalos integráció** | Nem | | **Szinkronizált adatok** | Hibajegyek, Projektek, Felhasználók, Események | | **API típus** | REST API v3 | | **Hitelesítés** | OAuth 2.0 (3LO) / API Token (Basic Auth) | | **Alap URL** | `https://your-domain.atlassian.net/rest/api/3/` | ## Funkciók - **Hibajegy-esemény szinkronizáció** – Hibajegy létrehozási, frissítési és megoldási események továbbítása Brevo kapcsolati idővonalakra - **Ügyfél jegykövetés** – Jira hibajegyek összekapcsolása Brevo kapcsolatokkal support láthatóságért - **Projekt mérföldkő riasztások** – Brevo kampányok indítása verziókon és sprint befejezéseken - **Csapatkapacitás-adatok** – Munkaterhelési mutatók szinkronizálása operatív dashboardokhoz - **Státuszváltozási események** – Hibajegy munkafolyamat-átmenetek követése Brevo eseményekként - **Megjegyzés-szinkronizáció** – Ügyfél-oldali megjegyzések továbbítása Brevo tevékenységnaplókba ## Előfeltételek Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel: 1. Egy Jira Cloud példánnyal (Jira Software, Jira Service Management vagy Jira Work Management) 2. Adminisztrátori hozzáféréssel OAuth alkalmazások létrehozásához vagy API tokenek generálásához 3. Az API tokenhez tartozó Atlassian fiók e-mail-jével 4. Egy Brevo fiókkal API-hozzáféréssel 5. Egy Tajo fiókkal aktív előfizetéssel ## Hitelesítés A Jira Cloud több hitelesítési módszert támogat. ### 1. lehetőség: OAuth 2.0 (3LO) – ajánlott 1. Menj a [developer.atlassian.com](https://developer.atlassian.com/console/myapps/) oldalra 2. Kattints a **Create** > **OAuth 2.0 integration** gombra 3. Konfiguráld a callback URL-t: `https://app.tajo.io/callbacks/jira` 4. Add hozzá ezeket a hatóköröket: ``` read:jira-work read:jira-user write:jira-work read:me ``` Az OAuth 2.0 API URL struktúra: ``` https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/{resource} ``` ### 2. lehetőség: API Token (Basic Auth) 1. Menj az [id.atlassian.com/manage/api-tokens](https://id.atlassian.com/manage/api-tokens) oldalra 2. Kattints a **Create API token** gombra 3. Nevezd el „Tajo Integration”-nek ```bash # Basic Auth: email as username, API token as password curl -X GET "https://your-domain.atlassian.net/rest/api/3/myself" \ -u "email@example.com:$JIRA_API_TOKEN" \ -H "Accept: application/json" ``` API Token korlátok Az API tokenek egyéni felhasználói fiókokhoz kötöttek. Ha a felhasználó deaktiválódik, az integráció megszakad. Éles telepítésekhez használj OAuth 2.0-t. ### Csatlakozás a Tajóhoz ```bash # Using OAuth 2.0 tajo connectors install jira \ --client-id $JIRA_CLIENT_ID \ --client-secret $JIRA_CLIENT_SECRET \ --cloud-id $JIRA_CLOUD_ID # Using API Token tajo connectors install jira \ --site-url your-domain.atlassian.net \ --email admin@example.com \ --api-token $JIRA_API_TOKEN ``` ## Konfiguráció ### Alapbeállítás ```yaml connectors: jira: enabled: true site_url: "your-domain.atlassian.net" auth_type: "oauth2" # or "basic" sync: issues: true projects: true users: true comments: true worklogs: false projects: - key: "SUPPORT" sync_to_list: 22 - key: "PRODUCT" sync_to_list: 23 issue_types: - Bug - Story - Task - Support Request ``` ### Mezőleképezés Képezd le a Jira hibajegy és felhasználói mezőket Brevo attribútumokhoz: ```yaml field_mapping: # User fields accountId: JIRA_ACCOUNT_ID emailAddress: email displayName: FIRSTNAME # Issue fields mapped to contact events issue_key: LAST_TICKET_KEY issue_status: LAST_TICKET_STATUS issue_priority: LAST_TICKET_PRIORITY issue_created: LAST_TICKET_DATE resolution: LAST_TICKET_RESOLUTION ``` ## API végpontok A Tajo az alábbi Jira Cloud REST API v3 végpontokkal integrálódik: | Végpont | Módszer | Cél | | --- | --- | --- | | `/rest/api/3/search` | POST | Hibajegyek keresése JQL-lel | | `/rest/api/3/issue/{issueIdOrKey}` | GET | Hibajegy részletek lekérése | | `/rest/api/3/issue` | POST | Hibajegy létrehozása | | `/rest/api/3/project` | GET | Az összes projekt listázása | | `/rest/api/3/project/{projectIdOrKey}` | GET | Projekt részletek lekérése | | `/rest/api/3/user/search` | GET | Felhasználók keresése | | `/rest/api/3/myself` | GET | Jelenlegi felhasználó lekérése | | `/rest/api/3/issue/{issueIdOrKey}/comment` | GET | Hibajegy megjegyzések lekérése | | `/rest/api/3/webhook` | POST | Webhookok regisztrálása | | `/rest/api/3/status` | GET | Az összes státusz lekérése | | `/rest/api/3/priority` | GET | Az összes prioritás lekérése | ## Kódpéldák ### A konnektor inicializálása ```javascript import { TajoClient } from '@tajo/sdk'; const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY }); await tajo.connectors.connect('jira', { clientId: process.env.JIRA_CLIENT_ID, clientSecret: process.env.JIRA_CLIENT_SECRET, cloudId: process.env.JIRA_CLOUD_ID }); ``` ### Support hibajegyek szinkronizálása ```javascript // Sync Jira support issues to Brevo contacts await tajo.connectors.sync('jira', { type: 'incremental', resources: ['issues'], jql: 'project = SUPPORT AND updated >= -24h', batchSize: 50 }); const status = await tajo.connectors.status('jira'); console.log(status); // { // connected: true, // lastSync: '2024-03-15T12:00:00Z', // issuesTracked: 4560, // projectsMonitored: 3, // usersLinked: 890 // } ``` ### Jira webhookok kezelése ```javascript app.post('/webhooks/jira', async (req, res) => { const event = req.body; await tajo.connectors.handleWebhook('jira', { event: event.webhookEvent, payload: { issueKey: event.issue?.key, issueType: event.issue?.fields?.issuetype?.name, status: event.issue?.fields?.status?.name, reporter: event.issue?.fields?.reporter?.emailAddress, assignee: event.issue?.fields?.assignee?.emailAddress } }); res.status(200).send('OK'); }); ``` ### Hibajegyek keresése ügyfél szerint ```javascript // Find all issues reported by a specific customer const issues = await tajo.connectors.query('jira', { jql: 'reporter = "customer@example.com" ORDER BY created DESC', maxResults: 20, fields: ['summary', 'status', 'priority', 'created'] }); ``` ## Ráta-korlátok A Jira Cloud ráta-korlátokat alkalmaz a platform stabilitása érdekében: | Kontextus | Ráta-korlát | | --- | --- | | **REST API** | ~100 kérés/10 másodperc felhasználónként | | **Egyidejű kérések** | 10 egyidejű hosszan futó kérés | | **Tömeges műveletek** | Végpontonként változó | Oldalazás A Jira `startAt` és `maxResults` paraméterekkel végzett eltolás alapú oldalazást használ. Az alapértelmezett oldalméret 50, maximum 100. A Tajo az oldalazást automatikusan kezeli. A Jira `429 Too Many Requests` választ ad vissza a ráta-korlátok túllépésekor, a `Retry-After` fejléc jelzi az újrapróbálkozás idejét. ## Hibaelhárítás ### Gyakori problémák | Probléma | Ok | Megoldás | | --- | --- | --- | | 401 Unauthorized | Érvénytelen token vagy lejárt OAuth | Frissítsd az OAuth tokent vagy generálj újra API tokent | | 403 Forbidden | Elégtelen engedélyek | Ellenőrizd, hogy a felhasználónak hozzáférése van-e a kért projekthez | | JQL hibák | Érvénytelen lekérdezési szintaxis | Először érvényesítsd a JQL-t a Jira hibajegy keresőjében | | Webhook nem érkezik meg | Tűzfal blokkolja | Győződj meg róla, hogy a webhook URL nyilvánosan elérhető | | Hiányzó mezők | Mező nincs a válaszban | Add a mezőt a `fields` paraméterhez vagy használd az `expand` paramétert | ### Hibakeresési mód ```yaml connectors: jira: debug: true log_level: verbose log_api_calls: true ``` ### Kapcsolat tesztelése ```bash tajo connectors test jira # ✓ API authentication successful # ✓ Project access verified # ✓ Issue search operational # ✓ User lookup available # ✓ Webhook registration active ``` ## Legjobb gyakorlatok 1. **Éles alkalmazásokhoz használj OAuth 2.0-t** – Elkerüli az egyéni felhasználói fióktól való függést 2. **Szűrj JQL-lel** – Csak a releváns hibajegyeket szinkronizáld az API hívások csökkentéséhez 3. **Valós idejűséghez használj webhookokat** – Kerüld a lekérdezést; regisztrálj webhookokat a hibajegy-változásokhoz 4. **Tartsd tiszteletben az ADF formátumot** – A Jira v3 Atlassian Document Formatot használ a formázott szöveges mezőkhöz 5. **Képezd le projektet listára** – Hozz létre különálló Brevo listákat Jira projektenként 6. **Kezelj oldalazást** – Mindig iterálj az összes oldalon az adatok teljességéhez ## Biztonság - **OAuth 2.0 (3LO)** – Biztonságos token alapú hitelesítés refresh tokenekkel - **API Token + Basic Auth** – Base64 kódolt hitelesítő adatok HTTPS-en keresztül - **Csak HTTPS** – Minden API kommunikáció TLS 1.2+-on keresztül titkosítva - **Hatókörrel korlátozott hozzáférés** – Az OAuth hatókörök az API hozzáférést a szükséges erőforrásokra korlátozzák - **Atlassian Cloud biztonság** – SOC 2 Type II tanúsított infrastruktúra - **Titkosított tárolás** – A hitelesítő adatok titkosítva tárolódnak a Tajóban ## Kapcsolódó források - [GitHub konnektor](https://tajo.io/hu/docs/connectors/custom/github) - [Linear konnektor](https://tajo.io/hu/docs/connectors/custom/linear) - [Gorgias konnektor](https://tajo.io/hu/docs/connectors/support/gorgias) - [Brevo Contacts API](https://tajo.io/hu/docs/contact-management)