📦 Intégration JIRA Assets

"Intégrez votre CMDB Atlassian dans Brainframe — parcourez les schémas et types d’objets Assets, puis importez des enregistrements CMDB en direct dans vos dossiers GRC."
Connectez Atlassian Assets avec OAuth, choisissez les schémas et types d’objets utiles à la conformité, et gardez à jour les actifs, documents et identités importés sans copier-coller depuis Jira.

L’intégration JIRA Assets connecte Brainframe à Atlassian Assets (Insight / CMDB) sur Jira Cloud. Contrairement à l’intégration JIRA (tickets / suivi avec jeton API), Assets utilise OAuth 2.0 (3LO) avec un contexte utilisateur, car Atlassian Assets refuse les jetons « app-only » et comptes de service pour ces API.

Une fois configurée, vous pouvez :

• Parcourir les schémas et types d’objets que vous incluez explicitement
• Rechercher des objets avec des filtres Assets Query Language (AQL) construits depuis l’interface
• Importer des objets comme documents Brainframe (unitaire ou en masse)
• Ouvrir les documents importés et voir les données en direct actualisées depuis Assets

Dans le catalogue d’intégrations, JIRA Assets est classé sous Assets et Documents (aux côtés de connecteurs d’inventaire comme les appareils Microsoft Defender ou Intune). Ce n’est pas une intégration Tasks — vous n’utilisez pas le menu éclair (⚡) Task from integrations du document pour Assets. Utilisez plutôt Add from integrations depuis les dossiers et les vues tableau.

💡 L’intégration classique JIRA (tickets / tâches) est distincte. Vous pouvez utiliser les deux sur le même site Atlassian. Assets nécessite sa propre application OAuth, ses scopes et sa configuration.

1️⃣ Avant de commencer

Pour configurer l’intégration, vous aurez besoin de :

• 🛠 Un administrateur d’espace de travail Brainframe (la configuration est réservée aux administrateurs).
• 🔐 Un site Atlassian Cloud où Assets est disponible (généralement via une licence Jira Service Collection / Assets).
• 🪪 Accès à la console développeur Atlassian pour créer une application OAuth 2.0 (3LO).
• 👤 Un utilisateur Atlassian pouvant consentir à l’application et ayant le droit de lire les schémas et objets Assets à parcourir.
• 📂 Des types de documents Brainframe prêts pour l’import (p. ex. Workstation, Application, Supplier) — vous mappez chaque type d’objet inclus vers un type de document par défaut lors de la configuration.

⚠️ Brainframe cible Atlassian Cloud Assets. Assets sur Jira Server / Data Center auto-hébergé n’est pas pris en charge par ce connecteur.

⚠️ Assets doit être provisionné et licencié sur le site. Si l’ID d’espace de travail ne peut pas être résolu après OAuth, Brainframe indique qu’Assets n’est pas disponible sur ce site.

2️⃣ Configurer l’intégration

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

Si vous ouvrez JIRA Assets avant que les identifiants et la connexion soient prêts, Brainframe vous redirige automatiquement vers cette page de configuration.

La configuration est un assistant en cinq étapes. Les étapes suivantes n’apparaissent qu’après la réussite des précédentes.

Étape 1 — Application OAuth Atlassian

Créez une application OAuth 2.0 (3LO) en contexte utilisateur, puis collez le Client ID et le Client secret dans Brainframe.

1. Ouvrez la console développeur Atlassian et créez une application OAuth 2.0 (3LO).
2. Sous Authorization, définissez l’Callback URL / Redirect URL exactement sur la valeur affichée dans Brainframe (champ copiable). Elle a la forme :

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

3. Sous Permissions, ajoutez/configurez Jira API, puis :

4. Ajoutez/configurez User identity API avec :

5. Sous Settings, copiez le Client ID et le Client secret.
6. Dans Brainframe, collez-les et cliquez sur Save OAuth app.

📌 Les Client secrets et jetons d’accès ne quittent jamais le backend Brainframe après enregistrement. Le navigateur ne reçoit que des métadonnées masquées (site connecté, e-mail du compte, id d’espace de travail, indices de scopes manquants).

Étape 2 — Connecter Atlassian (OAuth 3LO)

Cliquez sur Enable connection (ou Reconnect plus tard). Vous êtes redirigé vers Atlassian pour accorder les scopes demandés, puis renvoyé vers la page de callback Brainframe.

Après consentement :

• Brainframe stocke les jetons en contexte utilisateur.
• Il découvre l’Assets workspace du site sélectionné.
• Si votre compte Atlassian peut accéder à plusieurs sites, vous devez Select Atlassian site.
• L’écran de configuration affiche alors Site, Account et l’id Assets workspace une fois résolu.

Utilisez Disconnect pour effacer la session OAuth de Brainframe lors du renouvellement d’applications ou du changement de site.

⚠️ Assets exige une connexion en contexte utilisateur. Les jetons app-only / compte de service sont refusés — Brainframe le signalera clairement si le contrôle de capacité le détecte.

Étape 3 — Sélectionner les schémas

Une fois connecté avec un Assets workspace résolu, Brainframe liste les object schemas disponibles.

• Cochez chaque schéma à exposer comme onglet dans le navigateur.
• Seuls les schémas sélectionnés sont enregistrés dans la configuration de l’espace de travail.

Étape 4 — Configurer les types d’objets

Pour chaque schéma sélectionné, Brainframe charge les object types. Pour chaque type pertinent :

Cliquez sur Save configuration lorsque le mapping est prêt.

📌 N’incluez que les types d’objets nécessaires à vos programmes de conformité ou d’actifs. Les grands schémas restent utilisables si vous limitez types et colonnes.

Étape 5 — Tester et activer

L’intégration devient active lorsque toutes les conditions suivantes sont remplies :

1. Atlassian est connecté via OAuth 3LO
2. L’ID d’espace de travail Assets est résolu
3. Au moins un schéma avec au moins un type d’objet inclus est enregistré

Utilisez Test connection pour lancer une sonde de capacité. Résultats typiques :

Une fois active, cliquez sur Open Jira Assets pour parcourir.

3️⃣ Utiliser la page d’intégration JIRA Assets

Ouvrez Workspace Settings → Integrations → JIRA Assets (ou l’élément Integrations de la barre latérale lorsqu’il est activé).

Actions d’en-tête :

📊 Cartes KPI

🗂 Onglets de schéma et filtres

• Chaque schéma sélectionné devient un onglet (masqué s’il n’y en a qu’un).
• Filtre Object type : All types ou un type inclus.
• Search : correspond au Name de l’objet avec AQL Name LIKE "…".
• Open Jira Assets dashboard : ouvre l’UI Assets du site dans un nouvel onglet.

📋 Tableau d’objets

4️⃣ Importer des objets Assets dans Brainframe

L’import crée un document Brainframe natif lié à l’objet Assets.

Lors de l’import, Brainframe stocke :

• Le titre à partir du libellé de l’objet (et de la clé si distincte)
• Un instantané HTML des attributs clés (repli si un fetch live ultérieur échoue)
• Une URL d’intégration pointant vers le visualiseur Assets en direct dans Brainframe
• Les métadonnées source (type d’objet, schéma, espace de travail, URL Assets, payload)

Données en direct sur les documents importés

Lorsque vous ouvrez un document importé, Brainframe récupère l’objet le plus récent depuis Assets et affiche :

• Libellé, clé d’objet, type, schéma, statut
• Horodatages de création / mise à jour
• Grille d’attributs (y compris objets référencés et multi-valeurs)
• Open in Jira Assets lorsqu’une URL Assets externe est disponible

Si le fetch live échoue, Brainframe utilise l’instantané HTML stocké à l’import.

📌 Brainframe lit les données Assets pour la navigation et l’import. Il ne crée ni ne modifie d’objets Assets dans Atlassian via cette intégration.

5️⃣ Add from Integrations — Dossiers et vues tableau

Vous n’avez pas besoin de la page d’intégration complète pour chaque import.

Menu NEW du dossier

1. Ouvrez un dossier → NEW → Add from integrations.
2. Sélectionnez JIRA Assets (filtrez le catalogue par Assets ou Documents si utile).
3. Parcourez les mêmes onglets de schéma, filtres et tableau que sur la page principale.
4. Importez un ou plusieurs objets dans le dossier.

Vue tableau — bouton cloud

Dans une vue tableau par type de document, cliquez sur l’icône cloud (Add from integrations). Le navigateur Assets s’ouvre avec le type de document de la table courante présélectionné pour l’import — utile pour remplir un registre d’actifs.

📌 JIRA Assets n’apparaît pas sous Task from integrations (menu éclair). Ce menu est réservé aux fournisseurs de tâches (tickets JIRA, Asana, Monday.com, Azure DevOps, etc.).

6️⃣ Menu latéral Integrations

Lorsque JIRA Assets est configuré et activé dans les paramètres de menu de l’espace de travail, il apparaît sous Integrations dans la barre latérale gauche.

• Ouvre /integrations/jira-assets lorsque l’intégration est active.
• Les entrées grisées indiquent que l’élément est visible dans la configuration du menu mais non activé ou non accessible pour votre utilisateur — demandez à un administrateur sous Workspace Settings → Menu interface.

La configuration reste dans Integrations → JIRA Assets → Configure (administrateurs d’espace de travail).

7️⃣ Comment les CISO et équipes conformité utilisent typiquement Assets dans Brainframe

Exemples de programmes

• Inventaire d’actifs ISO 27001 (A.5 / A.8) — Inclure les types workstation/server → importer dans un dossier d’actifs gouverné → lier aux traitements de risque.
• NIS2 / services critiques — Mapper les types service et dépendances → importer dans un registre d’« entités essentielles ».
• Risque fournisseur — Mapper les types fournisseur avec le thème Documents → importer à côté des questionnaires / contrats.
• Échantillonnage d’audit — Filtrer les objets récemment mis à jour → import en masse d’un échantillon avec rafraîchissement live pour les revues.

Associer d’autres intégrations Atlassian

8️⃣ Résumé des permissions

📌 Tous les appels API Assets transitent par le backend Brainframe. Les Client secrets et jetons ne sont jamais renvoyés au navigateur après enregistrement.

9️⃣ Dépannage

Intégrations associées

• JIRA — Suivi des tickets et workflows Task from integrations (identifiants / jeton API séparés).
• Confluence — Pages de connaissance comme Documents.
• Microsoft Defender / Intune / Entra ID — Autres sources d’inventaire Assets / Identities via le même modèle Add from integrations.

Pour le catalogue partagé, l’aperçu des identifiants et le comportement des menus, consultez l’article général Integrations.

Mis à jour le : 17/08/2026