View a markdown version of this page

Ajouter de nouvelles mesures correctives - Réponse de sécurité automatisée sur AWS

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.

Ajouter de nouvelles mesures correctives

Les corrections peuvent être ajoutées manuellement en mettant à jour les fichiers playbook appropriés, ou par programmation en étendant la solution via des constructions CDK, en fonction de votre flux de travail préféré.

Note

Les instructions qui suivent utilisent les ressources installées par la solution comme point de départ. Par convention, la plupart des noms de ressources de solutions contiennent l'ASR and/or SO0111 afin de faciliter leur localisation et leur identification.

Boîte à outils d'IA pour des corrections personnalisées

Pour accélérer les flux de travail décrits dans cette section, la solution fournit le kit d'outils AI pour les corrections personnalisées. La boîte à outils contient les meilleures pratiques de remédiation, les garde-fous et les modèles de développement d'ASR pour un assistant de codage basé sur l'IA. L'assistant peut ensuite vous aider à créer des runbooks de correction, des runbooks de contrôle, des rôles IAM et des constructions CDK. Ils suivent les conventions de dénomination et les étapes d'intégration décrites dans les sections suivantes.

La boîte à outils est facultative et ne modifie pas la façon dont les mesures correctives sont conçues ou déployées ; il s'agit d'une aide au développement qui rend les conventions et les contraintes de la solution visibles à votre assistant IA. Il vous incombe de vérifier et de tester le code généré avant de le déployer.

La boîte à outils se trouve dans le ai-assets/ répertoire du GitHub référentiel de la solution. Il se divise en deux parties :

  • Une compétence partagée de création de corrections (ai-assets/skills/asr-remediation-authoring/) qui contient les instructions, le matériel de référence et les scripts Python groupés utilisés par l'assistant.

  • Adaptateurs hôtes pour Claude Code, Kiro et la CLI OpenAI Codex, installés parallèlement à la compétence partagée, comme décrit dans le répertoire. README.md

Flux de travail

La compétence prend en charge deux flux de travail, le flux de travail Runbook personnalisé et le flux de travail de Built-in correction. Ne mélangez pas leurs règles de dénomination ou de déploiement. Choisissez le flux de travail qui correspond à votre objectif :

Flux de travail Runbook personnalisé

Utilisez ce flux de travail pour combler une lacune de couverture pour un contrôle que la solution ne corrige pas déjà. Vous ne modifiez pas la source de la solution. L'assistant vous aide à créer, valider, tester et déployer le runbook dans vos comptes membres. Ce flux de travail déploie le document selon la convention de dénomination intégrée, de sorte que l'orchestrateur le traite de la même manière qu'une correction intégrée. Pour que la solution enregistre le runbook et bloque sa publication lors d'un test, enregistrez-la plutôt via le serveur MCP. Pour connaître les deux options et la manière dont chacune est résolue au moment de l'exécution, voirRunbooks de remédiation personnalisés.

Built-in flux de travail de remédiation

Utilisez ce flux de travail pour ajouter une correction à la source de la solution. L'assistant vous aide à ajouter la correction aux playbooks lors de l'extraction du référentiel de solutions. Il suit les étapes dePrésentation du flux de travail CDK.

Scripts groupés

La compétence inclut des scripts Python pour les étapes nécessitant un comportement déterministe et répétable. Les scripts nécessitent Python 3.11 ou une version plus récente avec boto3 etPyYAML. Ils effectuent les opérations suivantes :

  • Générez un échafaudage de runbook (handler, SSM Automation YAML et control-runbook). TypeScript

  • Validez un runbook par rapport aux règles de la solution avant de le déployer.

  • Testez un gestionnaire de correction en tant qu'exécution SSM en direct, puis nettoyez le document de test transitoire.

  • Vérifiez le décalage entre un document déployé et sa définition locale.

  • Déployez ou gérez une pile hors production.

Important

Les scripts du kit d'outils écrivent sur AWS. Exécutez-les uniquement sur un compte dont vous avez confirmé de manière indépendante qu'il ne s'agit pas d'une production. Le gardien de compte intégré confirme que les informations d'identification actives correspondent au compte que vous avez nommé. Il analyse également l'ARN de l'appelant à la recherche d'une prd sous-chaîne prod ou. Le gardien découvre un faux compte. Cela ne prouve pas qu'un compte peut être modifié en toute sécurité. Ne stockez jamais d'identifiants de compte, d'informations d'identification, de points de terminaison ou d'autres valeurs spécifiques à l'environnement dans la compétence ou les adaptateurs installés.

Serveur MCP déployé en option

Le flux de travail du kit d'outils local ne nécessite pas de serveur MCP déployé. Il utilise la CLI AWS, ou n'importe quel serveur MCP compatible avec AWS, si votre client en possède déjà un. Si aucune n'est disponible, installez l'interface de ligne de commande AWS avant d'utiliser le kit d'outils. Si vous avez déployé le serveur MCP optionnel de la solution (voirServeur MCP pour clients IA), l'assistant peut également appeler ses opérations ASR gérées. Par exemple, il peut enregistrer, tester et déployer un Runbook personnalisé via le portail de test de la solution. L'assistant ne peut utiliser que les outils qu'un administrateur vous a accordés.

Vue d'ensemble du flux de travail manuel

La réponse de sécurité automatisée sur les runbooks AWS doit suivre la dénomination standard suivante :

ASR- <standard> - <version> - <control>

Standard : Abréviation de la norme de sécurité. Cela doit correspondre aux normes prises en charge par l'ASR. Il doit s'agir de l'une des catégories « CIS », « AFSBP », « PCI », « NIST » ou « SC ».

Version : version de la norme. Encore une fois, cela doit correspondre à la version prise en charge par ASR et à la version figurant dans les données de recherche.

Contrôle : ID du contrôle à corriger. Cela doit correspondre aux données de recherche.

  1. Créez un runbook sur le (s) compte (s) membre (s).

  2. Créez un rôle AWS Identity and Access Management (IAM) dans le ou les comptes membres.

  3. (Facultatif) Activez la correction automatique dans le compte administrateur.

Étape 1. Créez un runbook sur le (s) compte (s) membre (s)

  1. Connectez-vous à la console AWS Systems Manager et obtenez un exemple du JSON trouvé.

  2. Créez un runbook d'automatisation qui corrige le résultat. Dans l'onglet Owned by me, utilisez l'un des ASR- documents de l'onglet Documents comme point de départ.

  3. Les AWS Step Functions du compte administrateur exécuteront votre runbook. Votre runbook doit spécifier le rôle de correction afin d'être transmis lors de l'appel du runbook.

Étape 2. Création d'un rôle IAM dans le ou les comptes membres

  1. Connectez-vous à la console AWS Identity and Access Management.

  2. Obtenez un exemple à partir des rôles IAM SO0111 et créez un nouveau rôle. Le nom du rôle doit commencer par SO0111-Remediate - <standard> - <version> -<control>. Par exemple, si vous ajoutez le contrôle 5.6 du CIS v1.2.0, le rôle doit êtreSO0111-Remediate-CIS-1.2.0-5.6.

  3. À l'aide de cet exemple, créez un rôle correctement défini qui autorise uniquement les appels d'API nécessaires pour effectuer la correction.

À ce stade, votre correction est active et disponible pour une correction automatique à partir de l'action personnalisée ASR dans AWS Security Hub.

Étape 3 : (Facultatif) Activez la correction automatique dans le compte administrateur

La correction automatique (et non « automatisée ») est l'exécution immédiate de la correction dès que le résultat est reçu par AWS Security Hub. Réfléchissez bien aux risques avant d'utiliser cette option.

La solution vérifie la table de configuration de correction Amazon DynamoDB dans le compte administrateur pour décider s'il convient de corriger automatiquement une découverte. Il n'utilise pas de EventBridge règle Amazon par contrôle.

  1. Dans le compte administrateur, ouvrez la table DynamoDB de configuration de correction. Son nom figure dans la RemediationConfigurationDynamoDBTable sortie de la pile d'administration.

  2. S'il n'existe aucun élément pour le contrôle, créez-en un avec un attribut controlId String défini sur l'ID de contrôle de sécurité de votre nouvelle correction. Ajoutez un attribut automatedRemediationEnabled booléen défini sur. true Si un élément existe déjà, définissez son automatedRemediationEnabled attribut surtrue.

Une fois que l'élément existe, vous pouvez également gérer le contrôle et ses filtres de ressources à partir de la page Contrôles de l'interface utilisateur Web ou du serveur MCP.

Présentation du flux de travail CDK

En résumé, les fichiers suivants du dépôt ASR seront modifiés ou ajoutés. Dans cet exemple, une nouvelle correction pour ElastiCache.2 a été ajoutée aux playbooks SC et AFSBP.

Note

Toutes les nouvelles corrections doivent être ajoutées au playbook SC, car il consolide toutes les corrections disponibles dans ASR. Si vous avez l'intention de déployer uniquement un ensemble spécifique de playbooks (tel que l'AFSBP), vous pouvez soit : (1) ajouter la correction uniquement aux playbooks que vous souhaitez, soit (2) ajouter la correction à tous les playbooks pour lesquels elle existe dans le Security Hub Standard correspondant, en plus du playbook SC. La deuxième option est recommandée pour des raisons de flexibilité.

Dans cet exemple, ElastiCache.2 il est inclus dans les normes Security Hub suivantes :

  • AFSBP

  • NIST.800-53.r5 SI-2

  • NIST.800-53.r5 SI-2(2)

  • NIST.800-53.r5 SI-2(4)

  • NIST.800-53.r5 SI-2(5)

  • PCI DSS version 4.0. 1/6.3.3

Étant donné que, par défaut, ASR n'implémente que les playbooks pour l'AFSBP NIST.800-53, nous ajouterons cette nouvelle correction à ces playbooks en plus du SC.

Modify

  • source/lib/remediation-runbook-stack.ts

  • source/playbooks/AFSBP/lib/[nom standard] _remediations.ts

  • source/playbooks/NIST80053/lib/control_runbooks-construct.ts

  • source/playbooks/NIST80053/lib/[nom standard] _remediations.ts

  • source/playbooks/SC/lib/control_runbooks-construct.ts

  • source/playbooks/SC/lib/sc_remediations.ts

  • source/test/regex_registry.ts

Addition

  • source/playbooks/SC/ssmdocs/SC_ElastiCache.2.ts

  • source/playbooks/SC/ssmdocs/descriptions/ElastiCache.2.md

  • source/remediation_runbooks/EnableElastiCacheVersionUpgrades.yaml

Note

Le nom choisi pour le runbook peut être n'importe quelle chaîne, à condition qu'il soit cohérent avec le reste des modifications apportées.

  • source/playbooks/NIST80053/ssmdocs/NIST80053_ElastiCache.2.ts

  • source/playbooks/AFSBP/ssmdocs/AFSBP_ElastiCache.2.yaml

Étapes de développement

  1. Créez le manuel de correction.

  2. Créez les Control Runbooks.

  3. Intégrez chaque Control Runbook à un Playbook.

  4. Créez le rôle IAM de correction et intégrez le manuel de correction

  5. Mettre à jour les tests unitaires

Étape 1 : Création du runbook de correction

Il s'agit du document SSM utilisé pour corriger les ressources. Il doit inclure le AutomationAssumeRole paramètre, qui est le rôle IAM autorisé à exécuter la correction. Affichez le fichier existant source/remediation_runbooks/EnableElastiCacheVersionUpgrades.yaml comme référence lors de la création de nouveaux runbooks de correction.

Tous les nouveaux runbooks doivent être ajoutés au source/remediation_runbooks/ répertoire.

Étape 2 : Création des Control Runbooks

Un runbook de contrôle est un runbook spécifique au playbook qui analyse les données de recherche issues de la norme donnée et exécute le runbook de correction approprié. Puisque nous ajoutons la ElastiCache.2 correction aux playbooks SC, AFSBP et NIST80053, nous devons créer un nouveau runbook de contrôle pour chacun d'entre eux. Les fichiers suivants sont créés :

  • source/playbooks/SC/ssmdocs/SC_ElastiCache.2.ts

  • source/playbooks/NIST80053/ssmdocs/NIST80053_ElastiCache.2.ts

  • source/playbooks/AFSBP/ssmdocs/AFSBP_ElastiCache.2.yaml

Exemple

Le nom de ces fichiers est important et doit suivre le format <PLAYBOOK_NAME>_< CONTROL.ID >. ts/yaml

Certains playbooks en ASR prennent en charge les runbooks de contrôle iAC TypeScript, tandis que d'autres doivent être écrits en YAML brut. Référez-vous aux correctifs existants dans le playbook correspondant à titre d'exemples. Dans cet exemple, nous aborderons le playbook SC, qui utilise IaC.

Dans le playbook SC, votre nouveau runbook de contrôle doit exporter une classe qui étend ControlRunbookDocument et correspond au nom de votre runbook de remédiation. Regardez l'exemple ci-dessous :

export class EnableElastiCacheVersionUpgrades extends ControlRunbookDocument { constructor(scope: Construct, id: string, props: ControlRunbookProps) { super(scope, id, { ...props, securityControlId: 'ElastiCache.2', remediationName: 'EnableElastiCacheVersionUpgrades', scope: RemediationScope.REGIONAL, resourceIdRegex: <Regex>, resourceIdName: 'ClusterId', updateDescription: new StringFormat('Automatic minor version upgrades enabled for cluster %s.', [ StringVariable.of(`ParseInput.ClusterId`), ]), }); } }
  • securityControlIdest l'ID de contrôle pour la correction que vous ajoutez, tel qu'il est défini dans la vue des contrôles consolidés de Security Hub.

  • remediationNameest le nom que vous avez choisi pour votre manuel de remédiation.

  • scopeest l'étendue de la ressource que vous êtes en train de corriger, en indiquant si elle existe dans le monde entier ou dans une région spécifique.

  • resourceIdRegexest l'expression régulière utilisée pour capturer l'ID de ressource que vous souhaitez transmettre au runbook de correction en tant que paramètre. Un seul groupe doit être capturé, tous les autres groupes ne doivent pas être capturés. Si vous souhaitez transmettre l'intégralité de l'ARN, omettez ce champ.

  • resourceIdNameest le nom que vous souhaitez définir pour l'ID de ressource capturé. Il doit correspondre au nom du paramètre d'ID de ressource dans votre manuel de correction. resourceIdRegex

  • updateDescriptionest la chaîne que vous souhaitez attribuer à la section « notes » de la recherche dans Security Hub une fois la correction réussie.

Vous devez également exporter une fonction appelée createControlRunbook qui renvoie une nouvelle instance de votre classe. Car ElastiCache.2 cela ressemble à :

export function createControlRunbook(scope: Construct, id: string, props: PlaybookProps): ControlRunbookDocument {
  return new EnableElastiCacheVersionUpgrades(scope, id, { ...props, controlId: 'ElastiCache.2' });
}

où controlId est l'ID de contrôle tel que défini dans la norme de sécurité associée au playbook sous lequel vous opérez.

Si le contrôle Security Hub contient des paramètres que vous souhaitez transmettre à votre runbook de correction, vous pouvez les transmettre en ajoutant des remplacements aux méthodes suivantes : - getExtraSteps : définit les valeurs par défaut pour chaque paramètre implémenté pour le contrôle dans Security Hub

Note

Une valeur par défaut doit être attribuée à chaque paramètre de Security Hub

  • getInputParamsStepOutput: définit les sorties pour l' GetInputParams étape du runbook de contrôle

  • Chaque sortie possède un nameoutputType, etselector. selectorIl doit s'agir du même sélecteur que celui utilisé dans le remplacement de la getExtraSteps méthode.

  • getRemediationParams: définit les paramètres transmis au runbook de correction, extraits des résultats de l' GetInputParams étape.

Pour voir un exemple, accédez au source/playbooks/SC/ssmdocs/SC_DynamoDB.1.ts fichier.

Étape 3 : Intégrer chaque Control Runbook à un Playbook

Pour chaque runbook de contrôle créé à l'étape précédente, vous devez désormais l'intégrer aux définitions d'infrastructure du playbook associé. Suivez les étapes ci-dessous pour chaque runbook de contrôle.

Important

Si vous avez créé le runbook de contrôle en utilisant du code YAML brut au lieu du texte dactylographié IAc, passez à la section suivante.

Dans /<playbook_name>/control_runbooks-construct.ts Importer votre nouveau fichier runbook de contrôle, tel que :

import * as elasticache_2 from '../ssmdocs/SC_ElastiCache.2';

Ensuite, accédez au tableau pour

const controlRunbooksRecord: Record<string, any>

Et ajoutez une nouvelle entrée mappant l'ID de contrôle (spécifique au playbook) à la createControlRunbook méthode que vous avez créée :

'ElastiCache.2': elasticache_2.createControlRunbook,

Ajoutez l'ID de contrôle spécifique au playbook à la liste des corrections comme ci-dessous : <playbook_name>\_remediations.ts

{ control: 'ElastiCache.2', versionAdded: '2.3.0' },

Le versionAdded champ doit être la dernière version de la solution. Si l'ajout de la correction dépasse la limite de taille du modèle, augmentez leversionAdded. Vous pouvez ajuster le nombre de corrections incluses dans la pile de chaque membre du playbook. solution_env.sh

Étape 4 : Création du rôle IAM de remédiation Integrate Remediation &amp; Runbook

Chaque correction possède son propre rôle IAM avec des autorisations personnalisées requises pour exécuter le runbook de correction. En outre, la RunbookFactory.createRemediationRunbook méthode doit être invoquée pour ajouter le runbook de correction que vous avez créé à l'étape 1 aux modèles de CloudFormation la solution.

Dans leremediation-runbook-stack.ts, chaque correction possède son propre bloc de code dans la RemediationRunbookStack classe. Le bloc de code suivant montre la création d'un nouveau rôle IAM et l'intégration du runbook de correction pour la correction : ElastiCache.2

//----------------------- // EnableElastiCacheVersionUpgrades // { const remediationName = 'EnableElastiCacheVersionUpgrades'; // should match the name of your remediation runbook const inlinePolicy = new Policy(props.roleStack, `ASR-Remediation-Policy-${remediationName}`); const remediationPolicy = new PolicyStatement(); remediationPolicy.addActions('elasticache:ModifyCacheCluster'); remediationPolicy.effect = Effect.ALLOW; remediationPolicy.addResources(`arn:${this.partition}:elasticache:*:${this.account}:cluster:*`); inlinePolicy.addStatements(remediationPolicy); new SsmRole(props.roleStack, 'RemediationRole ' + remediationName, { // creates the remediation IAM role solutionId: props.solutionId, ssmDocName: remediationName, remediationPolicy: inlinePolicy, remediationRoleName: `${remediationRoleNameBase}${remediationName}`, }); RunbookFactory.createRemediationRunbook(this, 'ASR ' + remediationName, { // adds the remediation runbook to the solution's cloudformation templates ssmDocName: remediationName, ssmDocPath: ssmdocs, ssmDocFileName: `${remediationName}.yaml`, scriptPath: `${ssmdocs}/scripts`, solutionVersion: props.solutionVersion, solutionDistBucket: props.solutionDistBucket, solutionId: props.solutionId, namespace: namespace, }); }

Étape 5 : Mettre à jour les tests unitaires

Nous vous recommandons de mettre à jour et d'exécuter les tests unitaires après avoir ajouté une nouvelle correction.

Tout d'abord, vous devez ajouter de nouvelles expressions régulières (qui ne sont pas déjà ajoutées) dans le source/test/regex_registry.ts fichier. Ce fichier impose des tests pour chaque nouvelle expression régulière incluse dans les runbooks de la solution. Regardez l'exemple de la addElastiCacheClusterTestCases fonction, qui est utilisée pour tester les expressions régulières utilisées dans ElastiCache les corrections.

Enfin, vous devez mettre à jour les instantanés pour chaque pile. Les instantanés sont des définitions de CloudFormation modèles contrôlées par version qui sont utilisées pour suivre les modifications apportées à l'infrastructure d'ASR. Mettez à jour les fichiers de capture instantanée en exécutant la commande suivante depuis le deployment répertoire :

./run-unit-tests.sh update

Vous êtes maintenant prêt à déployer votre nouvelle solution ! Accédez à la section Création et déploiement ci-dessous pour obtenir des instructions sur la création et le déploiement de la solution avec vos nouvelles modifications.