📦 JIRA Assets-integratie

"Breng je Atlassian-CMDB naar Brainframe — blader door Assets-schema’s en objecttypes en importeer live CMDB-records in je GRC-mappen."
Koppel Atlassian Assets met OAuth, kies welke schema’s en objecttypes relevant zijn voor compliance, en houd geïmporteerde assets, documenten en identiteiten actueel zonder te kopiëren uit Jira.

De JIRA Assets-integratie verbindt Brainframe met Atlassian Assets (Insight / CMDB) op Jira Cloud. In tegenstelling tot de JIRA-issues-integratie (API-token + issue tracking) gebruikt Assets OAuth 2.0 (3LO) met een gebruikerscontext, omdat Atlassian Assets app-only- en serviceaccounttokens voor deze API’s weigert.

Na configuratie kun je:

• Schema’s en objecttypes doorbladeren die je expliciet opneemt
• Objecten zoeken met Assets Query Language (AQL)-filters vanuit de UI
• Objecten als Brainframe-documenten importeren (enkel of bulk)
• Geïmporteerde documenten openen en live data ververst vanuit Assets zien

In de integratiecatalogus valt JIRA Assets onder Assets en Documents (naast inventarisconnectors zoals Microsoft Defender-apparaten of Intune). Het is geen Tasks-integratie — je gebruikt voor Assets niet het document-bliksemmenu (⚡) Task from integrations. Gebruik in plaats daarvan Add from integrations vanuit mappen en tabelweergaven.

💡 De klassieke JIRA-integratie (issues / taken) is apart. Je kunt beide op dezelfde Atlassian-site gebruiken. Assets heeft een eigen OAuth-app, scopes en configuratie nodig.

1️⃣ Voordat je begint

Om de integratie te configureren heb je nodig:

• 🛠 Een Brainframe-workspacebeheerder (configuratie is alleen voor beheerders).
• 🔐 Een Atlassian Cloud-site waarop Assets beschikbaar is (meestal via een Jira Service Collection- / Assets-licentie).
• 🪪 Toegang tot de Atlassian developer console om een OAuth 2.0 (3LO)-app te maken.
• 👤 Een Atlassian-gebruiker die de app kan goedkeuren en die de Assets-schema’s en -objecten mag lezen die je wilt doorbladeren.
• 📂 Brainframe-documenttypes klaar voor import (bijv. Workstation, Application, Supplier) — tijdens de setup map je elk opgenomen objecttype naar een standaarddocumenttype.

⚠️ Brainframe richt zich op Atlassian Cloud Assets. Self-hosted Jira Server / Data Center Assets wordt door deze connector niet ondersteund.

⚠️ Assets moet op de site geprovisioned en gelicentieerd zijn. Als de workspace-ID na OAuth niet kan worden opgelost, geeft Brainframe aan dat Assets op die site niet beschikbaar is.

2️⃣ De integratie configureren

Ga naar Workspace Settings → Integrations → JIRA Assets → Configure (/integrations/jira-assets/config).

Open je JIRA Assets voordat credentials en verbinding klaar zijn, dan stuurt Brainframe je automatisch naar deze configuratiepagina.

De configuratie is een wizard in vijf stappen. Latere stappen verschijnen pas nadat eerdere stappen zijn geslaagd.

Stap 1 — Atlassian OAuth-app

Maak een OAuth 2.0 (3LO)-app in gebruikerscontext en plak Client ID en Client secret in Brainframe.

1. Open de Atlassian developer console en maak een OAuth 2.0 (3LO)-app.
2. Onder Authorization stel je de Callback URL / Redirect URL exact in op de waarde die Brainframe toont (kopieerbaar veld). Formaat:

https://<your-brainframe-host>/integrations/jira-assets/callback

3. Onder Permissions voeg je Jira API toe/configureer je die, daarna:

4. Voeg User identity API toe/configureer die met:

5. Onder Settings kopieer je Client ID en Client secret.
6. Plak ze in Brainframe en klik op Save OAuth app.

📌 Client secrets en access tokens verlaten na opslag nooit de Brainframe-backend. De browser ontvangt alleen gemaskeerde metadata (verbonden site, account-e-mail, workspace-id, hints over ontbrekende scopes).

Stap 2 — Verbinden met Atlassian (OAuth 3LO)

Klik op Enable connection (later Reconnect). Je wordt doorgestuurd naar Atlassian om de gevraagde scopes te verlenen en daarna teruggebracht naar de Brainframe-callbackpagina.

Na toestemming:

• Brainframe slaat de tokens in gebruikerscontext op.
• Het ontdekt de Assets workspace van de geselecteerde site.
• Als je Atlassian-account toegang heeft tot meerdere sites, word je gevraagd Select Atlassian site.
• Het configuratiescherm toont daarna Site, Account en de Assets workspace-id wanneer die is opgelost.

Gebruik Disconnect om de OAuth-sessie in Brainframe te wissen bij het roteren van apps of wisselen van site.

⚠️ Assets vereist een verbinding in gebruikerscontext. App-only- / serviceaccounttokens worden geweigerd — Brainframe meldt dit duidelijk als de capability-check het detecteert.

Stap 3 — Schema’s selecteren

Zodra je verbonden bent met een opgeloste Assets-workspace, toont Brainframe beschikbare object schemas.

• Vink elk schema aan dat je als tab in de browser wilt tonen.
• Alleen geselecteerde schema’s worden in de workspaceconfiguratie opgeslagen.

Stap 4 — Objecttypes configureren

Voor elk geselecteerd schema laadt Brainframe object types. Voor elk relevant type:

Klik op Save configuration wanneer de mapping klaar is.

📌 Neem alleen objecttypes op die je compliance- of assetprogramma’s nodig hebben. Grote schema’s blijven bruikbaar als je types en kolommen beperkt.

Stap 5 — Testen & activeren

De integratie wordt actief wanneer aan alles hieronder is voldaan:

1. Atlassian is verbonden via OAuth 3LO
2. De Assets-workspace-ID is opgelost
3. Minstens één schema met minstens één opgenomen objecttype is opgeslagen

Gebruik Test connection voor een capability-check. Typische uitkomsten:

Als de integratie actief is, klik op Open Jira Assets om te bladeren.

3️⃣ De JIRA Assets-integratiepagina gebruiken

Open Workspace Settings → Integrations → JIRA Assets (of het Integrations-item in de zijbalk wanneer ingeschakeld).

Headeracties:

📊 KPI-kaarten

🗂 Schematabs en filters

• Elk geselecteerd schema wordt een tab (verborgen als er maar één is geconfigureerd).
• Object type-filter: All types of één opgenomen type.
• Search: matcht object-Name met AQL Name LIKE "…".
• Open Jira Assets dashboard: opent de Assets-UI van de site in een nieuw tabblad.

📋 Objecttabel

4️⃣ Assets-objecten importeren in Brainframe

Import maakt een native Brainframe-document dat aan het Assets-object is gekoppeld.

Bij import slaat Brainframe op:

• Titel uit het objectlabel (en key indien verschillend)
• Een HTML-snapshot van kernattributen (fallback als een latere live fetch faalt)
• Een integratie-URL naar de live Assets-viewer in Brainframe
• Bronmetadata (objecttype, schema, workspace, Assets-URL, payload)

Live data op geïmporteerde documenten

Wanneer je een geïmporteerd document opent, haalt Brainframe het nieuwste object uit Assets op en toont:

• Label, object key, type, schema, status
• Created- / updated-tijdstempels
• Attribuutraster (inclusief gerefereerde objecten en meervoudige waarden)
• Open in Jira Assets wanneer een externe Assets-URL beschikbaar is

Faalt de live fetch, dan valt Brainframe terug op de HTML-snapshot van het importmoment.

📌 Brainframe leest Assets-data voor bladeren en importeren. Via deze integratie worden geen Assets-objecten in Atlassian aangemaakt of gewijzigd.

5️⃣ Add from Integrations — Mappen en tabelweergaven

Je hebt niet voor elke import de volledige integratiepagina nodig.

Mapmenu NEW

1. Open een map → NEW → Add from integrations.
2. Selecteer JIRA Assets (filter de catalogus desgewenst op Assets of Documents).
3. Gebruik dezelfde schematabs, filters en tabel als op de hoofdpagina.
4. Importeer één of meer objecten in de map.

Tabelweergave — cloudknop

In een documenttypetabel klik je op het cloud-icoon (Add from integrations). De Assets-browser opent met het documenttype van de huidige tabel voorgeselecteerd voor import — handig voor een assetregistertabel.

📌 JIRA Assets verschijnt niet onder Task from integrations (bliksemmenu). Dat menu is voor taakleveranciers (JIRA-issues, Asana, Monday.com, Azure DevOps, enz.).

6️⃣ Zijbalkmenu Integrations

Wanneer JIRA Assets in de menüinstellingen van je workspace geconfigureerd en ingeschakeld is, verschijnt het onder Integrations in de linker zijbalk.

• Opent /integrations/jira-assets wanneer de integratie actief is.
• Grijze items betekenen: zichtbaar in de menuconfiguratie, maar voor jouw gebruiker niet ingeschakeld of niet toegankelijk — vraag een beheerder onder Workspace Settings → Menu interface.

Configuratie blijft onder Integrations → JIRA Assets → Configure (workspacebeheerders).

7️⃣ Typisch gebruik door CISO’s en compliance teams in Brainframe

Voorbeeldprogramma’s

• ISO 27001-assetinventaris (A.5 / A.8) — Workstation-/servertypes opnemen → importeren in een beheerde assetmap → koppelen aan risicobehandelingen.
• NIS2 / kritieke diensten — Service- en dependency-objecttypes mappen → importeren in een register van “essentiële entiteiten”.
• Leveranciersrisico — Leveranciersobjecttypes met Documents-theme mappen → importeren naast vragenlijsten / contracten.
• Auditsteekproeven — Recent bijgewerkte objecten filteren → steekproef bulkimporteren met live refresh voor walkthroughs.

Combineren met andere Atlassian-integraties

8️⃣ Overzicht rechten

📌 Alle Assets-API-aanroepen lopen via de Brainframe-backend. Client secrets en tokens worden na opslag nooit naar de browser teruggestuurd.

9️⃣ Probleemoplossing

Gerelateerde integraties

• JIRA — Issuetracking en Task from integrations-workflows (aparte credentials / API-token).
• Confluence — Kennispagina’s als Documents.
• Microsoft Defender / Intune / Entra ID — Andere Assets- / Identities-inventarissources met hetzelfde Add from integrations-patroon.

Voor de gedeelde catalogus, credentialoverzicht en menugedrag, zie het algemene artikel Integrations.

Bijgewerkt op: 17/08/2026