Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Préparation à l'utilisation du Catalogue de Logiciels

La section suivante fournit une vue d'ensemble du cycle de vie des versions du package et des informations sur l'utilisation du catalogue de packages AWS IoT Device Management logiciels.

Cycle de vie des versions du package

Une version d'un package peut évoluer selon les états du cycle de vie suivants : draftpublished, et deprecated. Cela peut aussi l'être deleted.

Conventions de dénomination des versions du package

Lorsque vous nommez des versions de package, il est important de planifier et d'appliquer une stratégie de dénomination logique afin que vous et les autres puissiez facilement identifier la dernière version du package et la progression des versions. Vous devez fournir un nom de version lors de la création de la version du package, mais la stratégie et le format dépendent en grande partie de votre analyse de rentabilisation.

À titre de bonne pratique, nous vous recommandons d'utiliser le format de versionnement SemVersémantique. Par exemple, 1.2.3 où 1 se trouve la version majeure pour les modifications fonctionnellement incompatibles, 2 la version majeure pour les modifications fonctionnellement compatibles et 3 la version corrective (pour les corrections de bogues). Pour plus d'informations, veuillez consulter la rubrique Gestion des versions sémantique 2.0.0. Pour plus d'informations sur les exigences relatives au nom de version du package, consultez versionNamele guide de AWS IoT API référence.

Version par défaut

La définition d'une version par défaut est facultative. Vous pouvez ajouter ou supprimer des versions de package par défaut. Vous pouvez également déployer une version de package qui n'est pas nommée version par défaut.

Lorsque vous créez une version de package, elle est placée dans un draft état et ne peut pas être nommée version par défaut tant que vous n'avez pas fait passer la version du package à la version publiée. Le Catalogue de Logiciels ne sélectionne pas automatiquement une version par défaut ni ne met à jour une version de package plus récente par défaut. Vous devez nommer intentionnellement la version du package que vous choisissez via la console ou en lançant l'UpdatePackageVersionAPIopération.

Attributs de version

Les attributs de version et leurs valeurs contiennent des informations importantes sur les versions de vos packages. Nous vous recommandons de définir des attributs généraux pour un package ou une version de package. Par exemple, vous pouvez créer une paire nom-valeur pour la plate-forme, l'architecture, le système d'exploitation, la date de sortie, l'auteur ou Amazon S3. URL

Lorsque vous créez une AWS IoT tâche avec un document de tâche, vous pouvez également choisir d'utiliser une variable de substitution ($parameter) qui fait référence à la valeur d'un attribut. Pour plus d'informations, consultez la section Préparation AWS IoT des tâches.

Les attributs de version utilisés dans les versions de package ne seront pas automatiquement ajoutés à l'ombre nommée réservée et ne peuvent pas être indexés ou interrogés directement via Fleet Indexing. Pour indexer ou interroger les attributs de version d'un package via Fleet Indexing, vous pouvez renseigner l'attribut de version dans l'ombre nommée réservée.

Nous recommandons que le paramètre d'attribut de version figurant dans le périphérique de capture d'ombres réservé indique les propriétés, telles que le système d'exploitation et l'heure d'installation. Ils peuvent également être indexés et interrogés via Fleet Indexing.

Les attributs de version ne sont pas tenus de respecter une convention de dénomination spécifique. Vous pouvez créer des paires nom-valeur pour répondre aux besoins de votre entreprise. La taille combinée de tous les attributs d'une version de package est limitée à 3KB. Pour plus d'informations, veillez consultez Software Package Catalog software package and package versions limits.

Utilisation de tous les attributs dans un document de travail

Vous pouvez faire en sorte que tous les attributs de version du package soient automatiquement ajoutés à votre déploiement de tâches pour les appareils sélectionnés. Pour utiliser automatiquement tous les attributs de version du package par programmation dans une CLI commande API or, reportez-vous à l'exemple de document de tâche suivant :

"TestPackage": "${aws:iot:package:TestPackage:version:PackageVersion:attributes}"

Nomenclature du logiciel

La nomenclature logicielle (SBOM) fournit un référentiel central pour tous les aspects de votre progiciel. Outre le stockage des packages logiciels et des versions des packages, vous pouvez stocker la nomenclature logicielle (SBOM) associée à chaque version de package dans le catalogue des packages AWS IoT Device Management logiciels. Un package logiciel contient une ou plusieurs versions de package et chaque version de package comprend un ou plusieurs composants. Chacun de ces composants prenant en charge la composition d'une version de package spécifique peut être décrit et catalogué à l'aide d'une nomenclature logicielle. Les normes du secteur en matière de nomenclature logicielle prises en charge sont SPDX et CycloneDx. Lorsqu'un SBOM est créé pour la première fois, il est validé par rapport au format standard de l'SPDXindustrie et CycloneDx. Pour plus d'informationsSPDX, voir System Package Data Exchange. Pour plus d'informations sur CycloneDx, voir CycloneDx.

La nomenclature du logiciel décrit tous les aspects des composants d'une version de package spécifique, tels que les informations sur le package, les informations sur les fichiers et les autres métadonnées pertinentes. Consultez l'exemple ci-dessous de structure de document de nomenclature logicielle au SPDX format suivant :

Avantages de la nomenclature logicielle

L'un des principaux avantages de l'ajout de votre nomenclature logicielle pour une version de package dans le catalogue de packages logiciels est la gestion des vulnérabilités.

Gestion des vulnérabilités

L'évaluation et l'atténuation de votre vulnérabilité aux risques de sécurité apparents liés aux composants logiciels restent essentiels pour protéger l'intégrité de votre parc d'appareils. En ajoutant la nomenclature logicielle stockée dans le catalogue des packages logiciels pour chaque version de package, vous pouvez identifier de manière proactive les failles de sécurité en identifiant les appareils à risque en fonction de leur version du package et SBOM en utilisant votre propre solution de gestion des vulnérabilités interne. Vous pouvez déployer des correctifs sur les appareils concernés et protéger votre parc d'appareils.

Stockage de la nomenclature logicielle

La nomenclature logicielle (SBOM) de chaque version du package logiciel est stockée dans un compartiment Amazon S3 à l'aide de la fonctionnalité de gestion des versions d'Amazon S3. Le compartiment Amazon S3 qui stocke le SBOM doit être situé dans la même région que celle où la version du package a été créée. Un compartiment Amazon S3 utilisant la fonctionnalité de gestion des versions conserve plusieurs variantes d'un objet dans le même compartiment. Pour plus d'informations sur l'utilisation de la gestion des versions dans un compartiment Amazon S3, consultez Utilisation de la gestion des versions dans les compartiments Amazon S3.

La clé Amazon S3 et l'ID de version spécifiques à votre compartiment sont utilisés pour identifier de manière unique chaque version d'une nomenclature logicielle pour une version de package.

Politique d'autorisations

Pour AWS IoT agir en tant que principal désigné pour accéder aux fichiers d'archive SBOM zip stockés dans le compartiment Amazon S3, vous avez besoin d'une politique d'autorisation basée sur les ressources. Reportez-vous à l'exemple suivant pour connaître la bonne politique d'autorisation basée sur les ressources :

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "iot.amazonaws.com"
                ]
            },
            "Action": "s3:*",
            "Resource": "arn:aws:s3:::bucketName/*"
        }
    ]
}

Pour plus d'informations sur les politiques d'autorisation basées sur les ressources, voir AWS IoT Politiques basées sur les ressources

Mettre à jour le SBOM

Vous pouvez mettre à jour la nomenclature logicielle aussi souvent que nécessaire pour protéger et améliorer votre parc d'appareils. Chaque fois que la nomenclature logicielle est mise à jour dans votre compartiment Amazon S3, l'ID de version change, le catalogue de packages logiciels est informé de la mise à jour et vous devez associer le nouveau compartiment Amazon S3 URL à la version de package appropriée. Vous verrez le nouvel ID de version dans la colonne Amazon S3 Object version ID sur la page de version du package dans le AWS Management Console. En outre, vous pouvez utiliser l'APIopération GetPackageVersion ou la CLI commande get-package-version pour afficher le nouvel ID de version.

Pour plus d'informations sur les clés d'objet Amazon S3, consultez Création de noms de clés d'objets.

Activation de l'indexation AWS IoT de la flotte

Pour tirer parti de l'indexation du AWS IoT parc avec Software Package Catalog, définissez le nom réservé shadow ($package) comme source de données pour chaque appareil sur lequel vous souhaitez indexer et recueillir des métriques. Pour plus d'informations sur les ombres nommées réservées, consultezOmbre nommée réservée.

L'indexation du parc fournit un support qui permet de regrouper AWS IoT les objets par le biais de groupes d'objets dynamiques filtrés par version de progiciel. Par exemple, l'indexation de la flotte peut identifier les éléments pour lesquels une version de package spécifique est installée ou non, pour laquelle aucune version de package n'est installée ou qui correspondent à des paires nom-valeur spécifiques. Enfin, l'indexation du parc fournit des indicateurs standard et personnalisés que vous pouvez utiliser pour avoir un aperçu de l'état de votre parc d'appareils. Pour de plus amples informations, veuillez consulter Préparation de l'indexation de la flotte.

Ombre nommée réservée

Le Ombre nommée réservée$package, reflète l'état des packages logiciels et des versions de packages installés sur l'appareil. L'indexation de flotte utilise l'ombre nommée réservée comme source de données pour créer des métriques standard et personnalisées afin que vous puissiez interroger l'état de votre flotte. Pour de plus amples informations, veuillez consulter Preparing fleet indexing.

Une ombre nommée réservée est similaire à une ombre nommée, sauf que son nom est prédéfini et que vous ne pouvez pas le modifier. En outre, l'ombre nommée réservée n'est pas mise à jour avec les métadonnées et utilise uniquement les attributes et version mots clés.

Les demandes de mise à jour qui incluent d'autres mots clés, tels que description, recevront une réponse d'erreur dans le rejected sujet. Pour plus d'informations, consultez Device Shadow error messages.

Il peut être créé lorsque vous créez un AWS IoT objet via la console, lorsqu'une AWS IoT tâche se termine avec succès et met à jour l'ombre, et si vous lancez l'UpdateThingShadowAPIopération. Pour plus d'informations, consultez UpdateThingShadowle guide du AWS IoT Core développeur.

Structure de l'$packageombre

L'ombre nommée réservée contient les éléments suivants :

{
    "state": {
        "reported": {
            "<packageName>": {
                "version": "",
                "attributes": {
                }
            }
        }
    },
    "version" : 1
    "timestamp" : 1672531201
}

Les propriétés de l'ombre sont mises à jour avec les informations suivantes :

Pour plus d'informations sur le format et le comportement d'une ombre nommée, consultez Service AWS IoT Device Shadow Ordre des messages.

Suppression d'un package logiciel et de ses versions

Avant de supprimer un package logiciel, effectuez les opérations suivantes :

Tant qu'il n'existe pas de version de package par défaut nommée, vous pouvez utiliser la console pour supprimer un package logiciel et toutes ses versions de package seront également supprimées. Si vous utilisez un API appel pour supprimer des packages logiciels, vous devez d'abord supprimer les versions des packages, puis le package logiciel.