> 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/match-unmatched-components/create-and-manage-alias-rules-to-match-and-rematch-components-across-all-products.md). # Créer et gérer des règles d’alias ## Présentation Pour afficher les vulnérabilités d’un composant donné, chaque composant doit être associé à un logiciel connu dans la NVD. Le gestionnaire de règles d’alias vous permet de définir des conditions d’association robustes pour les alias, ce qui simplifie la recherche de logiciels connus et fait ressortir davantage d’informations pour vous aider à choisir le logiciel connu correspondant. * Les règles d’alias ne remplacent pas les associations effectuées manuellement par les utilisateurs. * Seuls les propriétaires de compte peuvent créer et gérer des règles d’alias et de cycle de vie ### Comprendre le contexte de l’espace de travail pour les règles d’alias Lors de la création et de la gestion des règles d’alias : * **Avantage à l’échelle de l’organisation**: Les règles d’alias s’appliquent aux composants de tous les espaces de travail * **Gestion des règles**: Tous les administrateurs d’espace de travail peuvent consulter les règles d’alias de l’organisation, quel que soit l’espace de travail dans lequel ils se trouvent ### Avantages du gestionnaire de règles d’alias * **Gestion centralisée des règles** : Gérez les règles d’alias et les règles de cycle de vie EOS/EOL depuis un emplacement unique * **Capacités de mise en correspondance améliorées** : Créez des conditions à partir des **noms des composants, fournisseurs, CPE, PURL et versions** informations * **Transparence améliorée** : Consultez des informations détaillées sur les correspondances potentielles, notamment le nombre de vulnérabilités, les versions connues, les CPE, les PURL et les références * **Visibilité sur l’impact** : Consultez le nombre de produits, de versions et de composants concernés dans tous les espaces de travail avant de modifier les règles existantes. * **Gestion des conflits**: Le système détecte les conflits potentiels entre les règles * **Application automatique**: Les règles sont automatiquement appliquées aux SBOM existantes et futures ### Comprendre l’impact des règles d’alias Lorsque des règles d’alias sont appliquées, elles ont les effets suivants : * **SBOM existantes**: La règle d’alias est appliquée à tous les composants correspondants des SBOM précédemment téléversées * **SBOM futures**: La règle est automatiquement appliquée à tout nouveau téléversement contenant des composants correspondants * **État de correspondance**: Les composants passeront d’un état non correspondant à l’état « Correspondance établie », avec un badge « ALIAS » * **Données sur les vulnérabilités**: Si le logiciel identifié présente des vulnérabilités dans la NVD, celles-ci seront désormais associées à vos composants * **Rapports**: Les composants associés à l’aide de règles d’alias apparaîtront dans les rapports sur les vulnérabilités avec les correspondances qui leur ont été attribuées * **Hiérarchie des remplacements**: Les correspondances manuelles ont toujours priorité sur les règles d’alias Lorsque vous modifiez ou supprimez une règle d’alias : * Les composants précédemment associés par cette règle retrouveront leur état antérieur de non-correspondance * Toutes les données de vulnérabilité associées à la suite de cette correspondance ne seront plus liées au composant * Vous devrez créer une nouvelle règle d’alias ou associer manuellement les composants concernés pour rétablir les données de vulnérabilité ### Afficher les correspondances par alias Pour afficher les alias, cliquez sur l’élément **Rules** dans la barre latérale. Si vous disposez des [permissions](broken://pages/3f16990f30eaa8eed6269ae5b7894342bab99677), vous verrez les règles d’alias existantes dans l’onglet **Alias rules** . Pour tous les composants associés à un alias, le statut **Associé** sera accompagné d’un badge **ALIAS** dans la colonne **Statut de correspondance** de la page **Produits** . ### Ajouter une règle d’alias Pour résoudre les statuts de correspondance [**Correspondance sélectionnée**](/fr/helm/match-unmatched-components.md#resolve-select-match-or-not-found-status), [**Introuvable**](/fr/helm/match-unmatched-components.md#resolve-select-match-or-not-found-status), ainsi que les autres [statuts de correspondance](/fr/helm/match-unmatched-components.md), le propriétaire du compte Helm peut créer des règles d’alias directement à partir du composant inconnu ou de l’élément **Règles** de la barre latérale. ### **Créer une règle d’alias depuis le gestionnaire de règles** Lorsque vous créez une règle d’alias depuis le **Gestionnaire de règles**, vous devez spécifier les conditions de correspondance du composant auxquelles la règle d’alias s’appliquera. 1. Cliquez sur l’élément **Règles** dans la barre latérale. La page **Règles** s’affiche et vous permet de gérer les règles d’alias et de cycle de vie. 2. Cliquez sur le bouton **Ajouter un alias** **de règle** dans l’onglet **Règles d’alias** . L’assistant **Créer une règle d’alias** s’affiche. 3. À la première étape, indiquez les conditions auxquelles cette règle d’alias doit être appliquée automatiquement. Vous pouvez ajouter une condition pour chaque champ de métadonnées. * Les conditions sont combinées avec l’opérateur ET : elles doivent donc toutes être satisfaites pour que les effets s’appliquent. * Si une règle d’alias existante correspond exactement à vos critères, vous serez invité à annuler cette modification en attente ou à modifier les critères. 4. À la deuxième étape, indiquez le nom du composant connu et/ou son fournisseur, puis cliquez sur **Rechercher un logiciel connu**. * Si vous savez quel logiciel vous recherchez, cliquez sur le bouton d’option correspondant, puis cliquez sur **Créer une règle d’alias**. * Si vous ne savez pas avec certitude quel logiciel correspond le mieux, cliquez sur le bouton d’option pour examiner les détails du composant logiciel connu, notamment les informations sur les vulnérabilités, les CPE et PURL associés, ainsi que les références. Après avoir identifié et sélectionné la correspondance appropriée, cliquez sur **Créer une règle d’alias**. 5. La nouvelle règle d’alias apparaîtra au bas de votre liste de règles. Pour lui donner une priorité supérieure, vous pouvez la faire glisser vers le haut de la liste. 6. Le **statut de correspondance** des composants correspondant à ce critère passera à **Associé** avec un badge **ALIAS** badge. Cette opération peut prendre un certain temps, car Helm applique cette nouvelle règle d’alias à tous vos SBOM et l’évalue par rapport à toutes les règles d’alias existantes. Si le logiciel connu figure dans la NVD ou dans un gestionnaire de paquets contenant des vulnérabilités connues, les vulnérabilités associées lui seront attribuées. ### **Créer une règle d’alias à partir d’un composant** Lorsque vous créez une règle d’alias à partir d’un composant sur la page **Products** page, les conditions de correspondance du composant sont automatiquement renseignées. Vous pouvez les modifier au besoin. Le propriétaire du compte Helm peut créer des règles d’alias directement à partir du composant inconnu ou de l’élément **Rules** dans la barre latérale. 1. Cliquez sur **Products** dans la barre latérale. La page **Products** s’affiche. Elle répertorie tous les composants de ce SBOM. 2. Pour tout composant dont le statut indique l’absence de correspondance, cliquez sur le badge de la colonne **Match status** ou sur le bouton principal de la colonne **Actions** Vous pouvez également sélectionner **View match suggestions** dans le bouton **... actions overflow** . Le panneau **Select match suggestions** s’affiche. 3. Pour modifier les conditions de correspondance du composant, vous pouvez le faire à l’étape 1, puis cliquer sur **Continue** pour mettre à jour les correspondances possibles à l’étape 2. Si une règle d’alias existante correspond exactement à vos critères, vous serez invité à abandonner cette modification en attente ou à changer les critères. 4. Dans le champ **Component name** saisissez au moins trois caractères pour commencer à filtrer la liste. Toutes les règles de condition doivent être alphanumériques. Saisissez toute autre information dont vous disposez sur le composant, puis cliquez sur **Continue**. Si une règle d’alias existante correspond exactement à vos critères, vous serez invité à conserver la règle existante ou à la remplacer par la nouvelle. 5. Dans la section suivante, saisissez le nom du composant logiciel connu et/ou son fournisseur, puis cliquez sur **Search known software** pour afficher les correspondances possibles. * Si vous savez quel logiciel vous recherchez, cliquez sur le bouton d’option correspondant, puis cliquez sur **Créer une règle d’alias**. * Si vous ne savez pas avec certitude quel logiciel correspond le mieux, cliquez sur le bouton d’option pour examiner les détails du composant logiciel connu, notamment les informations sur les vulnérabilités, les CPE et PURL associés, ainsi que les références. Après avoir identifié et sélectionné la correspondance appropriée, cliquez sur **Créer une règle d’alias**. 6. La nouvelle règle d’alias apparaîtra au bas de votre liste de règles. Pour lui donner une priorité supérieure, vous pouvez la faire glisser vers le haut de la liste. 7. Le **Match status** de ce composant et de tous les composants correspondant à ces critères sera défini sur **Matched** avec un badge **ALIAS** . La mise à jour de tous les composants peut prendre un certain temps, car Helm applique cette nouvelle règle d’alias à tous vos SBOM et l’évalue par rapport à toutes les règles d’alias existantes. Si le logiciel connu figure dans la NVD ou dans un gestionnaire de paquets contenant des vulnérabilités connues, les vulnérabilités associées lui seront attribuées. #### **Conventions de nommage des règles** Les règles sont nommées en fonction des critères qui leur sont spécifiés, par exemple : `[Supplier name]/[Component name]/[Version]`. Vous ne pouvez actuellement pas modifier le nom des règles. Si cette fonctionnalité est importante pour vous, [faites-le-nous savoir](mailto:support@medcrypt.com). ### Modifier une règle d’alias Si vous devez modifier une règle d’alias, notez que toute modification s’appliquera aux SBOM existants et futurs. 1. Cliquez sur l’élément **Rules** dans la barre latérale. 2. Cliquez sur l’onglet **Alias rules** . 3. Dans l’onglet **Alias rules** , cliquez sur **Edit** pour toute règle que vous souhaitez modifier. L’assistant **Manage alias rule** s’affiche. Il présente les conditions actuelles de correspondance du composant ainsi que le logiciel connu sélectionné comme correspondance. 4. Pour modifier les conditions de correspondance du composant, vous pouvez le faire à l’étape 1, puis cliquer sur **Continue** pour mettre à jour les correspondances possibles à l’étape 2. * Si une règle d’alias existante correspond exactement à vos critères, vous serez invité à annuler cette modification en attente ou à modifier les critères. 5. À la deuxième étape, vous verrez la correspondance actuellement sélectionnée, ainsi que d’autres correspondances possibles selon les critères de recherche. La section des détails de la correspondance sélectionnée comporte plusieurs onglets qui vous aideront à comprendre l’impact de la règle existante sur l’ensemble de votre portefeuille, les vulnérabilités connues, les CPE et PURL connus, ainsi que des références supplémentaires. 6. Pour modifier les critères de correspondance, saisissez une partie ou la totalité du nom du logiciel connu recherché, puis cliquez sur **Search known software**. 7. Si vous modifiez les conditions de correspondance ou la correspondance connue sélectionnée, vous ne pourrez voir l’impact de cette modification qu’après l’avoir appliquée et être retourné à la modification de la règle. 8. Cliquez sur **Save & apply changes**. Une notification de réussite s’affichera une fois la modification appliquée. La modification d’une règle ne change pas sa position dans la liste. Faites-la donc glisser vers le haut ou vers le bas pour modifier sa priorité. ### Définir l’ordre de priorité des règles d’alias Les règles d’alias sont appliquées en fonction de leur position dans la liste des règles. 1. Faites-les glisser vers le haut pour augmenter leur priorité ou vers le bas pour la diminuer. 2. Si vous avez uniquement modifié l’ordre de priorité des règles, sans en marquer aucune pour suppression, cliquez sur **Save & apply changes**. Les changements de priorité seront appliqués. 3. Si vous avez marqué des règles pour suppression en plus de modifier leur ordre de priorité, ce bouton sera intitulé **Review changes** afin de vous permettre d’examiner l’impact de ces suppressions en attente avant de les confirmer. ### Supprimer une règle d’alias Si votre équipe a ajouté une règle d’alias incorrecte, vous pouvez facilement la supprimer si vous êtes **Administrator**. 1. Cliquez sur l’élément **Rules** dans la barre latérale. 2. Cliquez sur l’onglet **Alias rules** . 3. Cliquez sur **Mark for deletion** pour les règles d’alias que vous souhaitez supprimer. 4. Si vous devez modifier la priorité de certaines règles en raison de ces suppressions à venir, faites glisser les règles concernées vers le haut ou vers le bas de la liste. 5. Cliquez sur **Review changes** . 6. Un panneau de confirmation s’affichera et présentera l’impact des suppressions envisagées sur l’ensemble de votre portefeuille. Si plusieurs suppressions sont en attente, cliquez sur **Continue** pour passer à la suivante. Vous pouvez également cliquer sur **Save & apply changes** si vous n’avez pas besoin d’examiner l’impact des suppressions. Vous ne pouvez actuellement pas modifier cet impact. [Faites-nous savoir](mailto:support@medcrypt.com) si cette fonctionnalité vous est nécessaire ! 7. Après avoir effectué vos modifications, cliquez sur le bouton global **Save & apply** **changes** situé en bas de la liste des règles d’alias. La règle ne sera plus associée aux SBOM existants et ne sera pas appliquée aux futurs SBOM. ### Dépannage et bonnes pratiques * **Nommage des règles**: Vous ne pouvez pas modifier les noms des règles pour le moment. Ils sont générés automatiquement en fonction des conditions. * **Conflits entre règles**: Lorsque vous créez des règles avec des conditions similaires, veillez à ce qu’elles ne se chevauchent pas involontairement. Le système vous avertit en cas de doublons exacts. * **Persistance de la session**: Enregistrez toujours vos modifications avant de quitter la page, car toute modification non enregistrée sera perdue. * **Priorisation des règles**: Placez les règles les plus spécifiques en haut de la liste, car elles prévalent sur les règles plus générales. * **Considérations relatives aux performances**: * La création de nombreuses règles comportant des conditions complexes peut augmenter le temps de traitement. * La propagation de modifications de règles à grande échelle à l’ensemble des SBOM peut prendre du temps. * **Vérification**: Après avoir appliqué les règles, vérifiez un échantillon de composants pour vous assurer qu’elles fonctionnent comme prévu. * **Maintenance**: Passez régulièrement en revue vos règles d’alias pour vérifier qu’elles correspondent toujours à vos besoins actuels en matière de correspondance logicielle. ### Autorisations des alias * [**Propriétaire du compte**](/fr/helm/administration/manage-access.md#account-owner-role)**:** Cet utilisateur peut consulter et modifier tous les produits, créer des alias et utiliser les alias existants pour associer les logiciels de ses SBOM aux logiciels connus dans la NVD. Il n’y a qu’un seul propriétaire de compte. * [Administrateur de l’espace de travail](/fr/helm/administration/manage-access.md#workspace-admin-role): Cet utilisateur peut consulter et modifier tous les produits, ainsi qu’utiliser les alias existants. * [**Utilisateur :**](/fr/helm/administration/manage-access.md#user-role) Seuls les utilisateurs disposant des autorisations de modification des SBOM peuvent utiliser les alias existants. Les utilisateurs disposant d’un accès en lecture aux SBOM peuvent voir les alias, mais pas les utiliser. --- # 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/match-unmatched-components/create-and-manage-alias-rules-to-match-and-rematch-components-across-all-products.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.