> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://docs.brainframe.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Intégrations

# 🔗 **Intégrations**

> **« Connectez Brainframe GRC aux outils que vos équipes utilisent déjà — et travaillez avec ces données dans votre espace de conformité. »**
> *Parcourez les connecteurs disponibles, configurez les identifiants une fois, puis importez ou liez des enregistrements en direct dans des dossiers, documents et tableaux sans quitter Brainframe.*

Brainframe prend en charge un catalogue croissant d'intégrations tierces. Depuis **Workspace Settings → Integrations** (également disponible comme zone **Integrations** autonome), vous connectez des plateformes externes afin que leurs données puissent être parcourues, importées comme documents Brainframe ou liées comme tâches — selon le connecteur.

Cet article est une **vue d'ensemble générale**. Pour la configuration propre à chaque plateforme (jetons API, applications OAuth, permissions, filtres et mapping de champs), ouvrez l'article de documentation dédié via le badge **Show documentation** de chaque intégration, ou depuis l'entrée de changelog correspondante lorsqu'elle est publiée.

---

## 1️⃣ Où trouver les intégrations

| Point d'entrée | Ce que vous obtenez |
| ---- |
| **Workspace Settings → Integrations** | Catalogue complet des connecteurs avec statut, recherche et filtres par catégorie |
| **Integrations** dans la barre latérale gauche | Raccourci vers les intégrations configurées activées pour votre utilisateur/groupe |
| **NEW → Add from integrations** (dossier) | Navigateur d'import pour amener des enregistrements externes dans un dossier |
| Bouton **Cloud** sur une vue tableau | Même navigateur d'import, avec le type de document de la table courante présélectionné le cas échéant |
| Document **bolt (⚡) → Task from integrations** | Lier ou créer des éléments de travail de catégorie **task** sur le document ouvert |

Les écrans de configuration des identifiants sont généralement accessibles via l'action **⚙️ / Configure** sur une carte ou page d'intégration (administrateurs d'espace de travail pour la configuration partagée ; certains connecteurs autorisent aussi des identifiants individuels).

---

## 2️⃣ Parcourir le catalogue

![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-06-16-at-22081_auqxuy.png)
La vue d'ensemble des intégrations répertorie chaque connecteur connu de Brainframe. Utilisez les onglets en haut pour filtrer :

**All · Active · Assets · Documents · Identities · Incidents · Misconfigurations · Tasks · Vulnerabilities**

Vous pouvez aussi **rechercher** par nom. Chaque carte affiche :

* Le **nom** et le **logo** de la plateforme
* Les **catégories** (badges) — un connecteur peut en appartenir à plusieurs (par ex. Assets + Documents)
* Une courte **description** de ce que l'intégration apporte
* Le **statut** par rapport à votre espace de travail et votre utilisateur

### Statuts typiques des cartes

| Statut | Signification |
| ---- |
| **Setup required** | Les identifiants ou la connexion ne sont pas encore configurés — ouvrez la configuration pour continuer |
| **Enabled / available** | Prêt à l'emploi (le libellé exact dépend de la portée et de la licence) |
| **Coming soon** | Répertorié dans le catalogue mais pas encore configurable dans votre version Brainframe |

Les cartes marquées **Setup required** vous invitent à configurer les identifiants. Les intégrations déjà activées exposent un contrôle de paramètres pour consulter ou renouveler la connexion.

---

## 3️⃣ Configurer une intégration (général)
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-06-16-at-22081_1gove4f.png =705xauto)

Ouvrir **Configure** pour une intégration vous guide dans l'assistant de configuration ou le formulaire d'identifiants de cette plateforme. Les détails varient selon le produit, mais le schéma est le même :

1. Fournissez les identifiants ou les détails de l'application OAuth dont Brainframe a besoin (domaine, e-mail + jeton API, client ID/secret, permissions d'application Azure, …).
2. Effectuez les étapes de consentement ou de permissions dans l'outil externe.
3. Mappez éventuellement ce qui doit être parcouru (projets, schémas, types d'objets, modules, …) lorsque le connecteur le prend en charge.
4. Enregistrez et testez — Brainframe valide la connexion via son backend avant de considérer l'intégration comme active.

> 📌 Les secrets et jetons sont stockés sur le serveur Brainframe. Après enregistrement, le navigateur ne voit que des métadonnées sûres (site connecté, ID masqués, statut de capacité). Les appels API vers le tiers sont **proxifiés** — les identifiants ne sont pas réexposés au client.

### Portée des identifiants

De nombreuses intégrations prennent en charge deux portées :

| Portée | Qui configure | Qui peut utiliser |
| ---- |
| **Individual** | Tout utilisateur authentifié (lorsque proposé) | Uniquement cet utilisateur, avec ses propres identifiants |
| **Workspace** | Administrateurs d'espace de travail | Tous ceux qui ont accès à l'intégration activée |

**Les identifiants individuels sont prioritaires** sur les identifiants d'espace de travail lorsque les deux existent pour le même utilisateur.

Certains connecteurs modernes utilisent **OAuth** (consentement utilisateur) ou partagent une inscription d'application existante (par ex. Microsoft Defender réutilisant Entra ID). L'écran de configuration indique quel modèle s'applique ; l'article dédié à la plateforme décrit les champs exacts et les étapes dans la console externe.

> || ⚠️ Supprimer ou renouveler des identifiants à portée **workspace** affecte tous les utilisateurs de cette intégration. La portée individuelle n'affecte que votre propre accès.

### Finaliser la configuration hors Brainframe

De nombreuses plateformes exigent une étape supplémentaire avant que Brainframe puisse les appeler avec succès — création d'un jeton API, octroi du consentement administrateur, activation d'un module de licence ou enregistrement d'une URL de redirection. Ces étapes figurent dans le guide propre à chaque intégration. Utilisez **Show documentation** sur la page d'intégration lorsque disponible.

---

## 4️⃣ Comment les intégrations sont utilisées au quotidien

Les intégrations suivent des modèles selon leurs **catégories** du catalogue. Vous n'avez pas besoin de chaque modèle pour chaque connecteur.

### Page d'intégration dédiée

Une fois configurés, la plupart des connecteurs ont une page principale sous **Integrations → [Platform]** avec recherche, filtres, KPI (le cas échéant) et actions d'import. Utilisez **Refresh** pour recharger les données et **Configure** pour revenir à la configuration.

### Import dans dossiers et tableaux — **Add from integrations**

Utilisez ceci pour **Assets**, **Documents**, **Identities**, **Vulnerabilities**, **Incidents**, **Misconfigurations** et enregistrements similaires de type inventaire :

1. Depuis un dossier : **NEW → Add from integrations**
2. Ou depuis une vue tableau : bouton **cloud**
3. Choisissez le connecteur dans le catalogue (filtrez éventuellement par catégorie)
4. Parcourez et **importez** un ou plusieurs enregistrements dans le dossier / type de document choisi

Les documents importés restent généralement **liés** à la source, de sorte que les ouvrir peut afficher des données **live** du système externe (lorsque le connecteur le prend en charge).

### Tâches sur un document — **Task from integrations**

Utilisez ceci uniquement pour les connecteurs de catégorie **Tasks** (par ex. tickets JIRA, Asana, Monday.com, Azure DevOps, tâches SolarWinds Service Desk) :

1. Ouvrez un document enregistré
2. Menu bolt (⚡) → **Task from integrations**
3. Sélectionnez le fournisseur de tâches, puis **liez** un élément existant ou créez-en un nouveau

Les tâches liées apparaissent dans le contexte tâches / activités du document et peuvent ouvrir un visualiseur inline pour l'élément externe live.

> 📌 **Add from integrations** et **Task from integrations** partagent la même coque de navigateur, mais le menu bolt est filtré sur **Tasks**. Les connecteurs Asset/CMDB et Documents sont accessibles depuis les dossiers et tableaux, pas depuis le menu bolt des tâches.

### Raccourcis dans la barre latérale

Lorsqu'une intégration est configurée et **activée** dans **Workspace Settings → Menu interface**, elle peut apparaître sous **Integrations** dans la barre latérale gauche pour les utilisateurs autorisés. Les entrées grisées signifient généralement que l'élément de menu est visible dans la configuration mais non activé ou non accessible pour votre compte.

---

## 5️⃣ Intégrations disponibles

Le catalogue ci-dessous reflète les connecteurs actuellement listés dans Brainframe. **Configurable** signifie que vous pouvez configurer les identifiants et utiliser le produit aujourd'hui ; d'autres peuvent apparaître en **Coming soon** jusqu'à activation pour votre espace de travail ou votre version.

| Integration | Categories | Description |
| ---- |
| Aikido.dev | Vulnerabilities | Sécurité du code, des conteneurs, du cloud et des applications |
| **Asana** | Tasks | Gestion des tâches et des projets |
| **Azure DevOps** | Tasks | Gestion du cycle de vie de développement et CI/CD |
| **Confluence** | Documents | Collaboration d'équipe et gestion des connaissances |
| **Google Drive** | Documents | Stockage cloud et partage de fichiers |
| **JIRA** | Tasks | Suivi des problèmes et gestion de projet |
| **JIRA Assets** | Assets, Documents | CMDB et registre d'actifs défini par schéma depuis Atlassian Assets |
| **Microsoft Defender** | Vulnerabilities, Incidents, Assets, Misconfigurations, Tasks | Protection des terminaux et détection des menaces |
| **Microsoft Defender for Cloud** | Assets, Misconfigurations, Vulnerabilities, Incidents, Tasks, Documents | Posture de sécurité cloud, conformité et protection des charges de travail |
| **Microsoft Entra ID** | Identities | Identité cloud, gestion des accès et services d'annuaire |
| **Microsoft Intune** | Assets, Misconfigurations | Gestion des terminaux, conformité et configuration des appareils |
| Monday.com | Tasks | Plateforme de gestion du travail et de collaboration |
| **SharePoint** | Documents | Lier des documents depuis OneDrive et SharePoint vers des dossiers Brainframe |
| **Solarwinds Service Desk** | Tasks, Assets, Incidents | Gestion des incidents, problèmes, changements et CMDB |

Intégrations prévues (Contactez-nous si vous souhaitez d'autres intégrations : support@brainframe.com)

| Integration | Categories | Description |
| **CrowdStrike Falcon** | Incidents, Vulnerabilities | Détection et réponse sur les terminaux, renseignement sur les menaces |
| **Google Workspace** | Identities | Identité cloud, annuaire, SSO et gestion des appareils |
| **Lansweeper** | Assets | Découverte, inventaire et gestion des actifs IT |
| **Linear** | Tasks | Gestion des tâches et listes de choses à faire |
| **Microsoft Todo** | Tasks | Gestion des tâches et listes de choses à faire |
| **Nessus** | Vulnerabilities | Sécurité du code, des conteneurs, du cloud et des applications |
| **Outkept** | Compliance | Vérifier la protection anti-phishing et la conformité de la formation |
| **Okta** | Identities | Gestion des identités et des accès, SSO et MFA |
| **SentinelOne** | Vulnerabilities | Sécurité des terminaux alimentée par l'IA et renseignement sur les menaces |
| **ServiceNow** | Vulnerabilities, Incidents, Assets, Misconfigurations, Tasks | Intégration complète avec les informations pertinentes du service |
| **Tenable** | Vulnerabilities | Sécurité du code, des conteneurs, du cloud et des applications |

Pour la configuration pas à pas, le mapping de champs et le dépannage, ouvrez l'**article dédié** à cette plateforme (via **Show documentation** sur la page d'intégration lorsqu'il est publié).

---

## 6️⃣ Gérer les intégrations actives

Revenez à **Workspace Settings → Integrations** à tout moment pour :

* Filtrer **Active** pour voir ce qui est actuellement connecté
* Ouvrir une intégration pour parcourir les données ou importer des enregistrements
* Mettre à jour ou renouveler les identifiants via **Configure** / ⚙️
* Déconnecter ou effacer les identifiants lorsqu'une connexion ne doit plus être utilisée
* Contrôler la visibilité dans la barre latérale sous **Menu interface** (qui voit quel raccourci d'intégration)

Les documents Brainframe importés restent dans vos dossiers si vous déconnectez ultérieurement une intégration ; le rafraîchissement live dépend simplement de la capacité de Brainframe à appeler l'API externe avec des identifiants valides.

---

## 7️⃣ Conseils pour les programmes GRC

| Objectif | Approche typique |
| ---- |
| Tenir un **registre d'actifs / CMDB** à jour | Utiliser les connecteurs de catégorie Assets (JIRA Assets, appareils Defender, Intune, …) via **Add from integrations** |
| Attacher du **travail de remédiation** à un risque ou une constatation | Utiliser un connecteur Tasks via **Task from integrations** |
| Récupérer des **politiques ou preuves** depuis des outils de collaboration | Utiliser les connecteurs Documents (Confluence, SharePoint, …) |
| Suivre **vulnérabilités et incidents** pour les audits | Utiliser les connecteurs Vulnerabilities / Incidents ; importer dans des dossiers gouvernés avec rafraîchissement live |
| Aligner les **identités** avec les revues d'accès | Utiliser les connecteurs Identities (Entra ID, …) aux côtés des enregistrements de propriété d'actifs |

Préférez les identifiants **workspace** pour un compte de service partagé lorsque toute l'équipe GRC doit voir les mêmes données ; utilisez les identifiants **individual** lorsque l'accès doit rester personnel ou limité aux consultants.

---

## Lectures associées

Ouvrez l'article de documentation propre à chaque plateforme pour les détails de configuration. L'article général **Menu interface** explique comment les raccourcis d'intégration apparaissent dans la barre latérale pour les utilisateurs et groupes.
