View a markdown version of this page

Aggiungendo AWS Config Regole - AWS Config

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Aggiungendo AWS Config Regole

Puoi usare AWS Config console o AWS SDK per aggiungere regole.

Aggiungere regole (console)

Nella pagina Regole puoi visualizzare una tabella con le regole e i relativi risultati di conformità correnti. Il risultato per ogni regola è Valutando... fino a AWS Config termina la valutazione delle tue risorse rispetto alla regola. È possibile aggiornare i risultati con il pulsante di aggiornamento. Quando AWS Config al termine delle valutazioni, è possibile visualizzare le regole e i tipi di risorse conformi o non conformi. Per ulteriori informazioni, consulta Visualizzazione delle informazioni sulla conformità e dei risultati della valutazione per AWS Risorse con AWS Config.

Nota

Quando aggiungi una nuova regola, AWS Config valuta le risorse applicabili nell'inventario delle risorse, incluse le risorse registrate in precedenza. Ad esempio, se hai registrato AWS::IoT::Policy risorse ma in seguito le hanno escluse dalla registrazione, AWS Config mantiene gli elementi della configurazione iniziale (CI) nel tuo inventario. Sebbene AWS Config non aggiorna più questi CI quando i tipi di risorse associati vengono esclusi dalla registrazione, mantiene l'ultimo stato registrato e li valuta quando si aggiungono regole applicabili.

AWS Config non valuta le risorse che non sono presenti nell'inventario delle risorse. Ad esempio, se aggiungi etichettato amplify-branch regola ma non registra e non ho mai registrato AWS::Amplify::Branch risorse, AWS Config non è in grado di valutare se il AWS Amplify Le filiali del tuo account sono conformi o non conformi.

Per ulteriori informazioni, consulta AWS Risorse di registrazione con AWS Config.

Per aggiungere una regola
  1. Accedi al Console di gestione AWS e apri il AWS Config console in https://console.aws.amazon.com/config/home.

  2. Nel Console di gestione AWS menu, verificate che il selettore di regione sia impostato su una regione che supporti AWS Config regole. Per un elenco delle regioni supportate, consultaRegioni ed endpoint di AWS Config nei Riferimenti generali di Amazon Web Services.

  3. Nel riquadro di navigazione di sinistra seleziona Rules (Regole).

  4. Nella pagina Rules (Regole) scegli Add rule (Aggiungi regola).

  5. Nella pagina Specifica il tipo di regola, specifica il tipo di regola completando i seguenti passaggi:

    1. Nel campo di ricerca, indica se filtrare l'elenco delle regole gestite in base al nome, alla descrizione o all'etichetta della regola. Ad esempio, digita EC2 per visualizzare le regole che valutano i tipi di risorse di EC2 oppure digita periodic (periodico) per ottenere le regole con trigger periodici.

    2. Puoi anche creare regole personalizzate. Scegli Crea una regola personalizzata usando Lambda o Crea una regola personalizzata usando Guarde segui la procedura in Creando AWS Config Regole Lambda personalizzate o Creando AWS Config Regole politiche personalizzate.

  6. Nella pagina Configura la regola, configura la regola con la seguente procedura:

    1. In Name (Nome), digita un nome univoco per la regola.

    2. In Descrizione, digita una descrizione per la regola.

    3. Per Modalità di valutazione, scegli il momento del processo di creazione e gestione delle risorse che desideri AWS Config per valutare le tue risorse. A seconda della regola, AWS Config è in grado di valutare le configurazioni delle risorse prima che una risorsa sia stata distribuita, dopo la distribuzione di una risorsa o entrambe le cose.

      1. Scegli Attivazione della valutazione proattiva per eseguire valutazioni sulle impostazioni di configurazione delle risorse prima che vengano implementate.

        Dopo aver attivato la valutazione proattiva, puoi utilizzare StartResourceEvaluation API e GetResourceEvaluationSummary API per verificare se le risorse specificate in questi comandi verranno contrassegnate come NON_COMPLIANT dalle regole proattive del tuo account nella tua regione.

        Per ulteriori informazioni sull'utilizzo di questi comandi, consulta Valutazione delle risorse con AWS Config Regole. Per un elenco delle regole gestite che supportano la valutazione proattiva, vedi Elenco di AWS Config Regole gestite in base alla modalità di valutazione.

      2. Seleziona Attivazione della valutazione dei test per valutare le impostazioni di configurazione delle risorse esistenti.

        Per la valutazione dei test, esistono due tipi di trigger: Quando cambia la configurazione e Periodica.

        1. Se i tipi di trigger per la tua regola includono Modifiche alla configurazione, specificare una delle seguenti opzioni per Ambito delle modifiche con cui AWS Config richiama la tua funzione Lambda:

          • Risorse: quando viene creata, modificata o eliminata una risorsa che corrisponde al tipo o al tipo più identificatore specificato.

          • Tag: quando viene creata, modificata o eliminata una risorsa con il tag specificato.

          • Tutte le modifiche — Quando una risorsa è registrata da AWS Config viene creata, modificata o eliminata.

          AWS Config esegue la valutazione quando rileva una modifica a una risorsa che corrisponde all'ambito della regola. Puoi utilizzare l'ambito per definire le risorse che avviano le valutazioni.

        2. Se i tipi di trigger per la regola includono Periodico, specificare Frequenza con cui AWS Config richiama la tua funzione Lambda.

    4. Se la regola include parametri, puoi personalizzare i valori delle chiavi fornite in Parametri. Un parametro è un attributo a cui le risorse devono aderire per essere considerate conformi alla regola.

  7. Sul Rivedi e crea pagina, rivedi tutte le tue selezioni prima di aggiungere la regola alla tua Account AWS. Se la regola non funziona come previsto, puoi visualizzare uno dei risultati seguenti in Conformità:

    • Nessun risultato riportato - AWS Config ha valutato le tue risorse rispetto alla regola. La regola non si applicava al AWS risorse incluse nel suo ambito, le risorse specificate sono state eliminate o i risultati della valutazione sono stati eliminati. Per ottenere i risultati della valutazione, aggiorna la regola, modificane l'ambito o scegli Re-evaluate.

      Questo messaggio potrebbe essere visualizzato anche nel caso in cui non vengano segnalati risultati di valutazione per la regola.

    • Nessuna risorsa nell'ambito - AWS Config non posso valutare la tua registrazione AWS risorse non conformi a questa regola perché nessuna delle tue risorse rientra nell'ambito della regola. Per ottenere i risultati della valutazione, modifica la regola e cambiane l'ambito oppure aggiungi risorse per AWS Config per registrare utilizzando Impostazioni pagina.

    • Evaluations failed (Valutazioni non riuscite) Per le informazioni che possono aiutare a determinare il problema, scegli il nome della regola per aprire la relativa pagina dei dettagli e visualizzare il messaggio di errore.

Aggiungere regole (AWS SDK)

I seguenti esempi di codice mostrano come usare PutConfigRule.

CLI
AWS CLI

Esempio 1: aggiungere un AWS regola di configurazione gestita

Quanto segue put-config-rule l'esempio fornisce il codice JSON per aggiungere un AWS regola di configurazione gestita.

aws configservice put-config-rule \ --config-rule file://RequiredTagsForEC2Instances.json

RequiredTagsForEC2Instances.json è un file JSON che contiene la configurazione delle regole.

Contenuto di RequiredTagsForEC2Instances.json:

{ "ConfigRuleName": "RequiredTagsForEC2Instances", "Description": "Checks whether the CostCenter and Owner tags are applied to EC2 instances.", "Scope": { "ComplianceResourceTypes": [ "AWS::EC2::Instance" ] }, "Source": { "Owner": "AWS", "SourceIdentifier": "REQUIRED_TAGS" }, "InputParameters": "{\"tag1Key\":\"CostCenter\",\"tag2Key\":\"Owner\"}" }

Per ComplianceResourceTypes attributo, questo codice JSON limita l'ambito alle risorse di AWS::EC2::Instance tipo, quindi AWS Config valuterà solo le istanze EC2 rispetto alla regola. Poiché si tratta di una regola gestita, l’attributo Owner è impostato su AWS e l’attributo SourceIdentifier è impostato sull’identificatore della regola, ovvero REQUIRED_TAGS. Per l’attributo InputParameters, vengono specificate le chiavi di tag (CostCenter e Owner) richieste dalla regola.

Questo comando non produce output. Per verificare la configurazione della regola, esegui describe-config-rules comando e specificare il nome della regola.

Per ulteriori informazioni, vedere AWS Regole gestite di configurazione nel AWS Guida per sviluppatori di Config.

Esempio 2: aggiungere una regola di configurazione gestita dal cliente

Quanto segue put-config-rule L'esempio fornisce il codice JSON per aggiungere una regola di configurazione gestita dal cliente.

aws configservice put-config-rule \ --config-rule file://InstanceTypesAreT2micro.json

InstanceTypesAreT2micro.json è un file JSON che contiene la configurazione delle regole.

Contenuto di InstanceTypesAreT2micro.json:

{ "ConfigRuleName": "InstanceTypesAreT2micro", "Description": "Evaluates whether EC2 instances are the t2.micro type.", "Scope": { "ComplianceResourceTypes": [ "AWS::EC2::Instance" ] }, "Source": { "Owner": "CUSTOM_LAMBDA", "SourceIdentifier": "arn:aws:lambda:us-west-2:123456789012:function:InstanceTypeCheck", "SourceDetails": [ { "EventSource": "aws.config", "MessageType": "ConfigurationItemChangeNotification" } ] }, "InputParameters": "{\"desiredInstanceType\":\"t2.micro\"}" }

Per ComplianceResourceTypes attributo, questo codice JSON limita l'ambito alle risorse di AWS::EC2::Instance tipo, quindi AWS Config valuterà solo le istanze EC2 rispetto alla regola. Poiché questa regola è una regola gestita dal cliente, Owner l'attributo è impostato su CUSTOM_LAMBDAe SourceIdentifier l'attributo è impostato sull'ARN di AWS funzione Lambda. L’oggetto SourceDetails è obbligatorio. I parametri specificati per InputParameters l'attributo viene passato a AWS funzione Lambda quando AWS Config lo richiama per valutare le risorse rispetto alla regola.

Questo comando non produce output. Per verificare la configurazione della regola, esegui describe-config-rules comando e specificare il nome della regola.

Per ulteriori informazioni, vedere AWS Regole personalizzate di configurazione nel AWS Guida per sviluppatori di Config.

  • Per i dettagli sull'API, consulta PutConfigRule nel AWS CLI Riferimento al comando.

Python
SDK per Python (Boto3)
Nota

C'è di più su GitHub. Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel repository di esempi di codice AWS.

class ConfigWrapper: """ Encapsulates AWS Config functions. """ def __init__(self, config_client): """ :param config_client: A Boto3 AWS Config client. """ self.config_client = config_client def put_config_rule(self, rule_name): """ Sets a configuration rule that prohibits making Amazon S3 buckets publicly readable. :param rule_name: The name to give the rule. """ try: self.config_client.put_config_rule( ConfigRule={ "ConfigRuleName": rule_name, "Description": "S3 Public Read Prohibited Bucket Rule", "Scope": { "ComplianceResourceTypes": [ "AWS::S3::Bucket", ], }, "Source": { "Owner": "AWS", "SourceIdentifier": "S3_BUCKET_PUBLIC_READ_PROHIBITED", }, "InputParameters": "{}", "ConfigRuleState": "ACTIVE", } ) logger.info("Created configuration rule %s.", rule_name) except ClientError: logger.exception("Couldn't create configuration rule %s.", rule_name) raise
  • Per i dettagli sull'API, consulta PutConfigRule nel AWS Riferimento alle API SDK per Python (Boto3).

SAP ABAP
SDK per SAP ABAP
Nota

C'è di più su GitHub. Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel repository di esempi di codice AWS.

" Create a config rule for S3 bucket public read prohibition lo_cfs->putconfigrule( io_configrule = NEW /aws1/cl_cfsconfigrule( iv_configrulename = iv_rule_name iv_description = |S3 Public Read Prohibited Bucket Rule| io_scope = NEW /aws1/cl_cfsscope( it_complianceresourcetypes = VALUE /aws1/cl_cfscplncresrctypes_w=>tt_complianceresourcetypes( ( NEW /aws1/cl_cfscplncresrctypes_w( |AWS::S3::Bucket| ) ) ) ) io_source = NEW /aws1/cl_cfssource( iv_owner = |AWS| iv_sourceidentifier = |S3_BUCKET_PUBLIC_READ_PROHIBITED| ) iv_inputparameters = '{}' iv_configrulestate = |ACTIVE| ) ). MESSAGE 'Created AWS Config rule.' TYPE 'I'.
  • Per i dettagli sull'API, consulta PutConfigRule nel AWS Riferimento all'API SDK per SAP ABAP.