> For the complete documentation index, see [llms.txt](https://docs.medcrypt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.medcrypt.com/fr/helm/get-started-with-helm/upload-your-first-sbom.md). # Importez votre premier SBOM Prêt à téléverser votre premier SBOM, ou vous ne savez pas ce qu’est un SBOM ? Nous sommes là pour vous aider ! Helm prend en charge les formats SBOM CycloneDX et SPDX, ce qui vous permet de gérer facilement vos composants logiciels. ## **Comprendre le contexte de l’espace de travail lors du téléversement d’un SBOM** Un espace de travail correspond essentiellement à une division de votre organisation, par exemple un service ou une unité opérationnelle. Lors du téléversement de SBOM : * **Les produits sont propres à chaque espace de travail**: Tous les produits que vous créez pendant le téléversement appartiennent à votre espace de travail actuel. Les produits ne peuvent pas être déplacés vers un autre espace de travail après leur création. Pour créer un produit dans un autre espace de travail, [changez d’espace de travail](/fr/helm/get-started-with-helm/get-familiar-with-the-helm-ui.md#selected-workspace) au préalable, à l’aide du menu déroulant du fil d’Ariane ou du menu du compte. * **Gestion des versions**: Les versions des produits sont également associées à un espace de travail * **Visibilité des composants**: Les composants téléversés et leurs vulnérabilités sont visibles uniquement dans l’espace de travail Cela garantit une isolation adéquate des données entre les différentes unités opérationnelles ou équipes. ## Téléverser un SBOM CycloneDX ou SPDX 1. Si vous n’avez encore ajouté aucun SBOM, cliquez sur le bouton **Upload SBOM** . * Si votre équipe a déjà téléversé des SBOM, cliquez sur **Manage SBOMs > Upload SBOM**. 2. Si vous téléversez un fichier SBOM SPDX compressé, [suivez ces étapes](#upload-a-compressed-spdx-file). {% hint style="success" %} **Versions et formats SBOM pris en charge** **Versions :** * **CycloneDX :** 1.3 (importation uniquement), 1.4 (importation et exportation), 1.5 (importation uniquement) * **SPDX :** 2.2, 2.3 **Formats :** * **CycloneDX :** .json, .xml * **Fichiers SPDX individuels :** .spdx, .json, .yaml, .xml * **Fichiers SPDX compressés :** .gz, .tgz, .zip, .zst, .tzst * **Excel :** .xlsx, .xls * **CSV** **Taille du fichier :** 50MB {% endhint %} 2. Dans la liste déroulante **SBOM type** , sélectionnez **Document**. 3. Sélectionnez un fichier ou faites-le glisser dans le champ **SBOM file** . 1. [**Excel ou CSV**](#upload-a-csv-or-excel-sbom): Le téléversement de l’un de ces fichiers affichera un bouton **Generate CycloneDX** . 4. Cliquez sur **Upload SBOM**. 1. **Vous devez inclure des informations EOS/EOL ?** Vous pouvez importer votre SBOM CycloneDX avec les informations EOS/EOL renseignées dans [ces propriétés](#including-lifecycle-information). 2. Vous devez inclure des informations sur les correctifs Windows KB ? Vous pouvez importer votre SBOM CycloneDX avec les WinKBs renseignés dans [cette propriété](#including-windows-kb-patch-information). 5. Si les composants de votre SBOM ne s’affichent pas, vérifiez que l’option **Auto-refresh** est activée, ou actualisez manuellement la page. Le chargement des SBOM volumineux prend un peu plus de temps. 1. Si votre SBOM ne s’affiche toujours pas, cliquez sur **Manage SBOMs > View file upload status**. Si le statut **Failed** s’affiche, cliquez sur l’icône située à côté pour obtenir plus d’informations. 2. Si vous ne parvenez pas à résoudre le problème, [contactez-nous](mailto:support@medcrypt.com) pour obtenir de l’aide. 6. Une fois votre SBOM téléversé, tous les composants contenus dans ce produit s’affichent sur la page. La mise en correspondance commence immédiatement à partir des données de la NVD, notamment les Package URLs (PURL) des gestionnaires de paquets Cargo, NPM, Nuget ou Pypi, les chaînes CPE, la combinaison du nom, de la version et du fournisseur du composant, ainsi que les correspondances d’alias. 7. Si vous devez agréger et fusionner d’autres SBOM avec ce SBOM, cliquez sur **Manage SBOMs > Upload SBOM**. Les composants du SBOM téléversé seront ajoutés à votre SBOM existant. 8. Si des icônes d’avertissement ou d’erreur s’affichent à côté de la version de votre composant, cliquez dessus pour obtenir plus d’informations. 1. En cas d’avertissement, vous devriez pouvoir simplement modifier la version, mais vous devrez [nous contacter](mailto:support@medcrypt.com) en cas d’erreur. 2. Vous devez résoudre ce problème avant que nous puissions établir une correspondance pour ce composant et renvoyer les éventuelles vulnérabilités. ### **Téléverser un fichier SPDX compressé** Si vous disposez d’un fichier SBOM SPDX compressé, procédez comme suit pour le téléverser : 1. **Préparer vos fichiers**: * Créez un répertoire portant le nom que vous souhaitez donner à votre fichier zip. * Accédez à ce répertoire et créez un sous-répertoire nommé `packages` dans ce répertoire. * Copiez vos fichiers SBOM individuels dans le répertoire `packages` . 2. **Compresser vos fichiers**: * Utilisez les commandes suivantes pour compresser vos fichiers au format `.tar.gz` ou `.zip` : * **Créer un fichier .tar.gz**: `COPYFILE_DISABLE=1 tar -zcvf yourfilename.tar.gz yourdirectory` * **Créer un fichier .zip**: `zip -r yourfilename.zip yourdirectory -x '**/.*'` 3. **Téléverser votre fichier**: * Une fois le fichier compressé, accédez à Helm et téléversez votre fichier `.tar.gz` ou `.zip` fichier compressé en suivant le [processus de chargement](#have-a-cyclonedx-or-spdx-sbom) ci-dessus. Pour inclure des informations sur le cycle de vie, voici les propriétés prises en charge que vous pouvez utiliser dans votre SBOM CycloneDX. Ces informations seront renseignées dans les colonnes correspondantes du tableau **Produits** , ainsi que dans les détails des composants. Notez que si votre SBOM contient des propriétés en double pour un même composant, Helm conservera la première propriété et supprimera les autres. Pour chaque champ, vous ne pouvez inclure qu’une valeur de date ou de texte ; si vous incluez les deux, seule la date sera renseignée dans l’interface utilisateur de Helm. ### **Charger un SBOM au format CSV ou Excel** {% hint style="warning" %} **Cette fonctionnalité est en version bêta.** Faites-nous part de vos commentaires et dites-nous comment améliorer cette expérience ! {% endhint %} Vous pouvez importer directement des fichiers CSV et Excel dans Helm, où ils seront automatiquement convertis en SBOM CycloneDX. Vous n’aurez ainsi plus besoin d’outils ou de scripts de conversion [manuelle](/fr/helm/get-started-with-helm/dont-have-an-sbom/convert-your-sbom-from-csv-to-cyclonedx.md). 1. Cliquez sur le bouton **Upload SBOM** . 2. Dans la fenêtre modale qui s’affiche, indiquez le nom et la version du produit. 3. Dans la liste déroulante **SBOM type** , sélectionnez **Document**. 4. Sélectionnez un fichier ou faites-le glisser dans le champ **SBOM file** . 5. Cliquez sur **Generate CycloneDX SBOM**. 6. Prévisualisez vos données avant l’importation. Vérifiez les informations sur les composants pour vous assurer que tout est correct et repérer les éventuels problèmes de formatage. 7. Cliquez sur **Upload** pour convertir et importer votre SBOM. 8. Une fois importé, votre SBOM sera prêt pour l’analyse et la correction des vulnérabilités. Vous pourrez l’exporter aux formats [CycloneDX, SPDX ou CSV](/fr/helm/ensure-fda-readiness/fda-ready-sbom-and-vulnerability-reports.md), ainsi que dans notre format [SBOM FDA élaboré par nos experts](/fr/helm/ensure-fda-readiness/fda-ready-sbom-and-vulnerability-reports/meet-fda-requirements-with-your-fda-sbom-report.md). Vous pouvez également exporter des rapports [VEX et VDR](/fr/helm/ensure-fda-readiness/fda-ready-sbom-and-vulnerability-reports/vex-and-vdr-reports.md). ## Inclure des informations sur le cycle de vie ? Pour inclure des informations sur le cycle de vie, voici les propriétés prises en charge que vous pouvez utiliser dans votre SBOM CycloneDX. Ces informations seront renseignées dans les colonnes correspondantes du tableau **Produits** , ainsi que dans les détails des composants. Notez que si votre SBOM contient des propriétés en double pour un même composant, Helm conservera la première propriété et supprimera les autres. Pour chaque champ, vous ne pouvez inclure qu’une valeur de date ou de texte ; si vous incluez les deux, seule la date sera renseignée dans l’interface utilisateur de Helm. Pour utiliser l’une de ces propriétés, vous devez inclure la valeur complète de l’espace de noms (par exemple, `cdx:lifecyle:milestone.endOfSupport` ou `medcrypt:lifecycle:milestone:endOfLifeText)` dans le champ `name` et la valeur correspondante dans la propriété `value` . L’importation et l’exportation se feront à partir du tableau`component` et/ou `metadata > components` de votre SBOM CycloneDX. 1. **Niveau de prise en charge (date) :** L’importation prend en charge la propriété `cdx:lifecycle:milestone:endOfSupport` dans le champ name ou `eos_date` (nom de propriété spécifique à Medcrypt). L’exportation utilisera la propriété native de CycloneDX. 2. **EOS/EOL (date) :** L’importation prend en charge la propriété `cdx:lifecycle:milestone:endOfLife` dans le champ name ou `eol_date` (nom de propriété spécifique à Medcrypt). L’exportation utilisera la propriété native de CycloneDX. 3. **Niveau de prise en charge (texte) :** L’importation prend en charge la propriété `medcrypt:lifecycle:milestone:endOfLifeText` ou `eol_text` dans le champ name. L’exportation utilisera \``medcrypt:lifecycle:milestone:endOfLifeText`. 4. **EOS/EOL (texte) :** L’importation prend en charge la propriété `medcrypt:lifecycle:milestone:levelOfSupportText` ou `eos_text` dans le champ name. L’exportation utilisera \``medcrypt:lifecycle:milestone:levelOfSupportText`. **Exemple de fin de prise en charge avec un tableau de composants** ``` ... "component" : { "name" : "[PRODUCT_NAME]", "version" : "2.2.3". "type" : "application", "bom-ref" : "dd8fc70b-767a-4398-885c-bbd0e8f6c68", "properties" : [ { "name" : "cdx:lifecycle:milestone:endOfSupport", "value" : "2026-02-07T22:00:0Z" }, {{ "name" : "medcrypt:lifecycle:milestone:levelOfSupportText", "value" : "Q1 2026" } ... ``` Consultez le [dépôt GitHub de CycloneDX ](https://github.com/CycloneDX/cyclonedx-property-taxonomy/blob/479acf89cc0595995ad20d7fa9439f007250b050/cdx/lifecycle.md)pour en savoir plus sur leurs propriétés natives. **Exemple de fin de prise en charge avec un tableau de composants** ``` ... "component" : { "name" : "[PRODUCT_NAME]", "version" : "2.2.3". "type" : "application", "bom-ref" : "dd8fc70b-767a-4398-885c-bbd0e8f6c68", "properties" : [ { "name" : "cdx:lifecycle:milestone:endOfSupport", "value" : "2026-02-07T22:00:0Z" }, {{ "name" : "medcrypt:lifecycle:milestone:levelOfSupportText", "value" : "Q1 2026" } ... ``` Consultez le [dépôt GitHub de CycloneDX ](https://github.com/CycloneDX/cyclonedx-property-taxonomy/blob/479acf89cc0595995ad20d7fa9439f007250b050/cdx/lifecycle.md)pour en savoir plus sur leurs propriétés natives. ## **Inclure les informations sur les correctifs Windows KB ?** CycloneDX ne prend pas en charge nativement les informations Windows KB. Pour inclure ces informations sur les correctifs Windows KB, vous pouvez utiliser cette propriété spécifique à Medcrypt dans votre SBOM CycloneDX. Pour utiliser cette propriété, vous devez inclure la valeur complète de l’espace de noms (par exemple, `medcrypt:vulnerability:remediation:mskb` dans le champ `name` et la valeur correspondante dans le champ `value` de la propriété, dans le tableau `component` ou `metadata > components` de votre SBOM CycloneDX. Nous importerons et exporterons les données à partir du`component` et/ou du `metadata > components` tableau de votre SBOM CycloneDX. * L’importation et l’exportation prennent en charge la propriété `medcrypt:vulnerability:remediation:mskb` nommée ainsi. Toutefois, quelle que soit l’emplacement des KB dans le SBOM d’origine, ils seront exportés uniquement vers `metadata > component` . **Exemple de Windows KB avec le tableau component** ``` ... "component" : { "name" : "[PRODUCT_NAME]", "version" : "2.2.3". "type" : "application", "bom-ref" : "dd8fc70b-767a-4398-885c-bbd0e8f6c68", "properties" : [ { "name" : "medcrypt:vulnerability:remediation:mskb", "value" : "KB12849" }, {{ "name" : "medcrypt:vulnerability:remediation:mskb", "value" : "KB994849" } ... ``` ## Inclure des informations sur le cycle de vie ? Pour inclure les informations de cycle de vie, voici les propriétés prises en charge. Ces informations seront renseignées dans les colonnes correspondantes du tableau **Products** ainsi que dans les détails du composant. Si votre SBOM contient des propriétés en double pour un même composant, Helm conservera la première et ignorera les autres. Pour chaque champ, vous ne pouvez inclure qu’une date ou une valeur textuelle. Si vous incluez les deux, une seule sera importée. 1. **Niveau de prise en charge (date) :** L’importation prend en charge la propriété `cdx:lifecycle:milestone:endOfSupport` ou `eos_date` (propriété spécifique à Medcrypt). L’exportation utilisera la propriété native de CycloneDX. 2. **EOS/EOL (date) :** L’importation prend en charge la propriété `cdx:lifecycle:milestone:endOfLife` ou `eol_date` (propriété spécifique à Medcrypt). L’exportation utilisera la propriété native de CycloneDX. 3. **Niveau de prise en charge (texte) :** L’importation prend en charge `medcrypt:lifecycle:milestone:endOfLifeText` ou `eol_text`. L’export sera \``medcrypt:lifecycle:milestone:endOfLifeText`. 4. **Fin du support/fin de vie (texte) :** L’importation prendra en charge `medcrypt:lifecycle:milestone:levelOfSupportText` ou `eos_text`. L’export sera \``medcrypt:lifecycle:milestone:levelOfSupportText`. ## **Inclure les données de dépendances ?** Si votre SBOM CycloneDX contient des données de dépendances pour vos composants, Helm capture et conserve ces relations de dépendance, puis les inclut lors de l’export au format CycloneDX. Cela garantit la fidélité et l’exhaustivité des SBOM CycloneDX qui comportent des données sur les relations entre les composants. ## **Que se passe-t-il après le téléversement ?** Une fois votre SBOM téléversé, Helm commence automatiquement à associer vos composants aux logiciels connus dans la NVD (National Vulnerability Database). Pour ce faire, il utilise plusieurs [sources de correspondance](/fr/helm/match-unmatched-components/understand-match-sources.md), telles que les Package URL (PURL), les chaînes CPE, les noms de composants et les correspondances d’alias. Pour en savoir plus, consultez les pages « Statuts des correspondances » et « Résoudre les statuts des correspondances ». Consultez [Sources de correspondance](/fr/helm/match-unmatched-components/understand-match-sources.md) pour en savoir plus sur les sources que nous consultons, et [Statuts des correspondances](/fr/helm/match-unmatched-components/understand-match-statuses.md) pour comprendre comment nous déterminons les statuts des correspondances et proposons des correspondances possibles. ## **Créer des produits et des versions sans SBOM** 1. Dans la liste déroulante **Select product** , choisissez **Create product**, indiquez le nom du produit, puis cliquez sur **Save**. Ce produit sera créé dans votre espace de travail actuel et ne pourra pas être déplacé vers un autre espace de travail après sa création. Pour le créer dans un autre espace de travail, vous devez d’abord [changer d’espace de travail](/fr/helm/get-started-with-helm/get-familiar-with-the-helm-ui.md#selected-workspace) . 2. Dans la liste déroulante **Select version** , choisissez **Create version**, indiquez la version, puis cliquez sur **Save**. 3. Lorsque votre SBOM est prêt, cliquez simplement sur le bouton de liste déroulante **Add SBOM** (**Manage SBOM** si vous avez déjà téléversé d’autres SBOM), puis sélectionnez **Upload SBOM** lorsque vous êtes prêt à ajouter votre fichier SBOM. ## **Dépannage et assistance** L’actualisation automatique est peut-être désactivée. Vous pouvez la réactiver à l’aide du bouton **Auto-refresh** situé au-dessus du tableau, ou cliquer sur Refresh pour actualiser la page manuellement. ### **Vous ne voyez pas les composants de votre SBOM ?** L’actualisation automatique est peut-être désactivée. Vous pouvez la réactiver à l’aide du bouton **Actualisation automatique** situé au-dessus du tableau, ou cliquez sur **Actualiser** pour actualiser manuellement la page. Si votre SBOM ne s’affiche toujours pas, vérifiez l’état du téléversement de votre fichier SBOM à l’aide du bouton de menu déroulant **Manage SBOMs** > **View file upload status**. Dans la fenêtre modale d’état, cliquez sur l’icône à côté de l’état Failed pour obtenir plus d’informations. Si vous avez besoin d’aide, [contactez-nous](mailto:support@medcrypt.com). ### **Aucune correspondance exacte** Si Helm ne trouve aucune correspondance exacte dans la NVD, consultez [Résoudre les états de correspondance ](/fr/helm/match-unmatched-components.md)pour obtenir des instructions supplémentaires. ### Problèmes de téléversement **Votre fichier SBOM est volumineux ?** Le téléversement d’un fichier SBOM volumineux peut prendre un peu plus de temps. Prenez un café ou un thé pendant que nous traitons votre SBOM ! Dès que le téléversement est terminé, nous lançons automatiquement la mise en correspondance avec les logiciels connus dans la NVD. **Vous pensez que le téléversement de votre SBOM a échoué ?** Si votre SBOM ne s’affiche toujours pas, vérifiez l’état du téléversement de votre fichier SBOM à l’aide du bouton de menu déroulant **Manage SBOMs** > **View file upload status**. Dans la fenêtre modale d’état, cliquez sur l’icône à côté de l’état **Failed** pour obtenir plus d’informations. Si vous avez besoin d’aide, [contactez-nous](mailto:support@medcrypt.com). **La SBOM contient des hachages de composants** Bien que vous ne puissiez pas encore afficher les hachages de composants masqués dans Helm, soyez assuré que les informations sur les hachages de composants de votre SBOM ont été conservées et seront exportées sans modification dans tout [rapport SBOM](/fr/helm/ensure-fda-readiness/fda-ready-sbom-and-vulnerability-reports.md). ## Besoin d’aide pour démarrer ? ### **Vous utilisez un autre format de SBOM ?** Si vous utilisez un autre format (par exemple, Word ou CSV), [contactez-nous](mailto:support@medcrypt.com) afin que nous puissions le convertir pour vous. Nous travaillons à améliorer la prise en charge de l’ensemble des données de votre SBOM au format CycloneDX et à ajouter la prise en charge du format SBOM SPDX. Ne vous inquiétez pas : nous sommes là pour vous aider ! Nous pouvons [vous proposer une évaluation experte, des conseils et une conception](https://www.medcrypt.com/services/overview) sur tous les sujets, de l’intégration de la cybersécurité et de l’amélioration continue au cycle de développement de vos produits à la cryptographie de votre infrastructure à clés publiques, en passant par les lettres de la FDA, et bien d’autres encore. ### **Besoin de générer une SBOM ?** Nous avons nous-mêmes utilisé de nombreux outils open source et pouvons également vous recommander d’autres outils que nous connaissons pour générer une [SBOM CycloneDX](/fr/helm/get-started-with-helm/dont-have-an-sbom/generate-cyclonedx-sbom-with-open-source-tools.md) ou une [SBOM SPDX](/fr/helm/get-started-with-helm/dont-have-an-sbom/generate-spdx-sbom-with-open-source-tools.md). ### **Vous ne savez pas ce qu’est une SBOM ou par où commencer ?** Répondez à notre [questionnaire d’évaluation de la préparation aux exigences de la FDA](https://docs.google.com/forms/d/1REk-QXwY4JM3gYg87xXp7z-iddW1-m87ynn2HmWvkTo/viewform?edit_requested=true) pour commencer à préparer le processus de soumission à la FDA. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.medcrypt.com/fr/helm/get-started-with-helm/upload-your-first-sbom.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.