View a markdown version of this page

Hinzufügen AWS Config Regeln - AWS Config

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Hinzufügen AWS Config Regeln

Sie können das verwenden AWS Config Konsole oder die AWS SDKs zum Hinzufügen von Regeln.

Regeln hinzufügen (Konsole)

Auf der Seite Regeln werden Ihre Regeln und deren aktuelle Compliance-Ergebnisse in einer Tabelle dargestellt. Das Ergebnis für jede Regel ist Bewertung von... bis AWS Config beendet die Bewertung Ihrer Ressourcen anhand der Regel. Sie können die Ergebnisse über die Aktualisieren-Schaltfläche aktualisieren. Wann AWS Config Wenn die Evaluierungen abgeschlossen sind, können Sie sehen, welche Regeln und Ressourcentypen konform sind oder nicht. Weitere Informationen finden Sie unter Anzeige von Compliance-Informationen und Bewertungsergebnissen für Ihre AWS Ressourcen mit AWS Config.

Anmerkung

Wenn Sie eine neue Regel hinzufügen, AWS Config bewertet die entsprechenden Ressourcen in Ihrem Ressourceninventar, einschließlich zuvor aufgezeichneter Ressourcen. Zum Beispiel, wenn Sie aufgezeichnet haben AWS::IoT::Policy Ressourcen, die sie aber später von der Aufnahme ausgeschlossen haben, AWS Config behält die Elemente der Erstkonfiguration (CIs) in Ihrem Inventar bei. Obwohl AWS Config aktualisiert diese CIs nicht mehr, wenn die zugehörigen Ressourcentypen von der Aufzeichnung ausgeschlossen werden. Ihr zuletzt aufgezeichneter Status wird beibehalten und beim Hinzufügen entsprechender Regeln ausgewertet.

AWS Config bewertet keine Ressourcen, die nicht im Ressourceninventar enthalten sind. Wenn Sie beispielsweise das hinzufügen mit Amplify-Branch-Tag Regel, aber nimm nicht auf und habe noch nie aufgenommen AWS::Amplify::Branch Ressourcen, AWS Config kann nicht beurteilen, ob AWS Amplify Filialen in Ihrem Konto sind konform oder nicht konform.

Weitere Informationen finden Sie unter AWS Ressourcen aufzeichnen mit AWS Config.

So fügen Sie eine Regel hinzu
  1. Loggen Sie sich ein bei AWS-Managementkonsole und öffne das AWS Config Konsole bei https://console.aws.amazon.com/config/home.

  2. In der AWS-Managementkonsole Vergewissern Sie sich, dass die Regionsauswahl auf eine Region eingestellt ist, die Folgendes unterstützt AWS Config Regeln. Die Liste der unterstützten Regionen finden Sie unter AWS Config -Regionen und -Endpunkte im Allgemeine Amazon Web Services-Referenz.

  3. Klicken Sie im linken Navigationsbereich auf die Option Regeln.

  4. Wählen Sie auf der Seite Rules (Regeln) die Option Add Rule (Regel hinzufügen) aus.

  5. Geben Sie auf der Seite Regeltyp angeben den Regeltyp an, indem Sie die folgenden Schritte ausführen:

    1. Geben Sie einen Begriff in das Suchfeld ein, um die Liste der verwalteten Regeln nach Regelname, Beschreibung und Bezeichnung zu filtern. Geben Sie beispielsweise EC2 ein, damit Regeln zurückgegeben werden, die EC2-Ressourcentypen bewerten, oder geben Sie periodic ein, damit Regeln zurückgegeben werden, die in regelmäßigen Abständen ausgelöst werden.

    2. Zudem können Sie Ihre eigene benutzerdefinierte Regel erstellen. Wählen Erstellen Sie eine benutzerdefinierte Regel mit Lambda oder Erstellen Sie eine benutzerdefinierte Regel mit Guard, und folgen Sie dem Verfahren unter Erstellen AWS Config Benutzerdefinierte Lambda-Regeln oder Erstellen AWS Config Benutzerdefinierte Richtlinienregeln.

  6. Auf der Seite Regel konfigurieren konfigurieren Sie die Regel, indem Sie die folgenden Schritte ausführen:

    1. Geben Sie unter Name einen eindeutigen Namen für die Regel ein.

    2. Geben Sie unter Beschreibung eine Beschreibung für die Regel ein.

    3. Für Bewertungsmodus, wählen Sie aus, wann Sie sich im Prozess der Ressourcenerstellung und -verwaltung befinden AWS Config um Ihre Ressourcen zu evaluieren. Abhängig von der Regel AWS Config kann Ihre Ressourcenkonfigurationen vor der Bereitstellung einer Ressource, nach der Bereitstellung einer Ressource oder beidem auswerten.

      1. Wählen Sie Proaktive Auswertung einschalten aus, damit Auswertungen der Konfigurationseinstellungen Ihrer Ressourcen ausgeführt werden können, bevor diese bereitgestellt werden.

        Nachdem Sie die proaktive Evaluierung aktiviert haben, können Sie StartResourceEvaluation API und GetResourceEvaluationSummary API, um zu überprüfen, ob die Ressourcen, die Sie in diesen Befehlen angeben, von den proaktiven Regeln in Ihrem Konto in Ihrer Region als NON_COMPLIANT gekennzeichnet würden.

        Weitere Informationen zur Verwendung dieser Befehle finden Sie unter Evaluieren Sie Ihre Ressourcen mit AWS Config Regeln. Eine Liste der verwalteten Regeln, die eine proaktive Bewertung unterstützen, finden Sie unter Liste von AWS Config Verwaltete Regeln nach Testmodus.

      2. Wählen Sie Detektivische Auswertung einschalten aus, um die Konfigurationseinstellungen Ihrer vorhandenen Ressourcen auszuwerten.

        Für die detektivische Auswertung gibt es zwei Arten von Auslösern: Wenn sich die Konfiguration ändert und Regelmäßig.

        1. Wenn die Triggertypen für Ihre Regel Folgendes beinhalten Änderungen an der Konfiguration, geben Sie eine der folgenden Optionen an für Umfang der Änderungen mit welchem AWS Config ruft deine Lambda-Funktion auf:

          • Ressourcen: Wenn eine Ressource, die dem angegebenen Ressourcentyp oder dem Typ und dem Bezeichner entspricht, erstellt, geändert oder gelöscht wird

          • Tags: Wenn eine Ressource mit einem bestimmten angegebenen Tag erstellt, geändert oder gelöscht wird

          • Alle Änderungen — Wenn eine Ressource aufgezeichnet wurde von AWS Config wird erstellt, geändert oder gelöscht.

          AWS Config führt die Auswertung aus, wenn eine Änderung an einer Ressource erkannt wird, die dem Geltungsbereich der Regel entspricht. Sie können den Umfang verwenden, um zu definieren, welche Ressourcen Auswertungen auslösen.

        2. Wenn die Triggertypen für Ihre Regel Folgendes beinhalten Periodisch, geben Sie die an Frequenz mit welcher AWS Config ruft Ihre Lambda-Funktion auf.

    4. Unter Parameter können Sie die Werte für die bereitgestellten Schlüssel anpassen, falls Ihre Regel Parameter enthält. Ein Parameter ist ein Attribut, über das Ihre Ressourcen verfügen müssen, damit sie als regelkonform gelten.

  7. Auf der Überprüfen und erstellen Seite, überprüfe alle deine Auswahlen, bevor du die Regel zu deinem hinzufügst AWS-Konto. Wenn die Regel oder Funktion nicht wie erwartet funktioniert, wird eine der folgenden Meldungen bei Compliance angezeigt:

    • Keine Ergebnisse gemeldet - AWS Config hat Ihre Ressourcen anhand der Regel bewertet. Die Regel galt nicht für AWS Ressourcen in ihrem Geltungsbereich, die angegebenen Ressourcen wurden gelöscht, oder die Bewertungsergebnisse wurden gelöscht. Um die Evaluierungsergebnisse zu erhalten, aktualisieren Sie die Regel, ändern Sie ihren Geltungsbereich oder wählen Sie Re-evaluate.

      Diese Meldung wird ggf. auch dann angezeigt, wenn die Regel keine Auswertungsergebnisse gemeldet hat.

    • Keine Ressourcen im Geltungsbereich - AWS Config kann deine Aufnahme nicht auswerten AWS Ressourcen, die gegen diese Regel verstoßen, da keine Ihrer Ressourcen in den Geltungsbereich der Regel fällt. Um Evaluierungsergebnisse zu erhalten, bearbeiten Sie die Regel und ändern Sie ihren Geltungsbereich, oder fügen Sie Ressourcen hinzu für AWS Config zum Aufzeichnen mit dem Einstellungen Seite.

    • Evaluations failed (Auswertungen fehlgeschlagen) – Weitere Informationen, mit denen Sie das Problem bestimmen können, finden Sie, indem Sie den Regelnamen auswählen und die Detailseite öffnen, um die Fehlermeldung anzuzeigen.

Regeln hinzufügen (AWS SDKs)

Die folgenden Code-Beispiele zeigen, wie PutConfigRule verwendet wird.

CLI
AWS CLI

Beispiel 1: Um ein hinzuzufügen AWS verwaltete Config-Regel

Folgendes put-config-rule Das Beispiel enthält JSON-Code zum Hinzufügen eines AWS verwaltete Config-Regel.

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

RequiredTagsForEC2Instances.json ist eine JSON-Datei, die die Regelkonfiguration enthält.

Inhalt von 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\"}" }

Für die ComplianceResourceTypes Attribut, dieser JSON-Code begrenzt den Geltungsbereich auf Ressourcen von AWS::EC2::Instance tippe, also AWS Config bewertet nur EC2-Instanzen anhand der Regel. Da es sich bei der Regel um eine verwaltete Regel handelt, ist das Owner-Attribut auf AWS und das SourceIdentifier-Attribut auf den Regelbezeichner REQUIRED_TAGS festgelegt. Für das InputParameters-Attribut werden die Tag-Schlüssel, Owner und CostCenter, die die Regel benötigt, angegeben.

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um die Regelkonfiguration zu überprüfen, führen Sie den Befehl aus Beschreiben Sie die Konfigurationsregeln Befehl und geben Sie den Regelnamen an.

Weitere Informationen finden Sie unter AWS Verwaltete Regeln konfigurieren in der AWS Config-Entwicklerhandbuch.

Beispiel 2: Um eine vom Kunden verwaltete Config-Regel hinzuzufügen

Folgendes put-config-rule Das Beispiel enthält JSON-Code zum Hinzufügen einer vom Kunden verwalteten Config-Regel.

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

InstanceTypesAreT2micro.json ist eine JSON-Datei, die die Regelkonfiguration enthält.

Inhalt von 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\"}" }

Für die ComplianceResourceTypes Attribut, dieser JSON-Code begrenzt den Geltungsbereich auf Ressourcen von AWS::EC2::Instance tippe, also AWS Config bewertet nur EC2-Instanzen anhand der Regel. Da es sich bei dieser Regel um eine vom Kunden verwaltete Regel handelt, Owner Das Attribut ist auf gesetzt CUSTOM_LAMBDA, und der SourceIdentifier Das Attribut ist auf den ARN des gesetzt AWS Lambda-Funktion. Das SourceDetails-Objekt ist erforderlich. Die Parameter, die für den angegeben sind InputParameters Das Attribut wird an den übergeben AWS Lambda-Funktion wenn AWS Config ruft es auf, um Ressourcen anhand der Regel zu bewerten.

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um die Regelkonfiguration zu überprüfen, führen Sie den Befehl aus Beschreiben Sie die Konfigurationsregeln Befehl und geben Sie den Regelnamen an.

Weitere Informationen finden Sie unter AWS Konfigurieren Sie benutzerdefinierte Regeln in der AWS Config-Entwicklerhandbuch.

  • Einzelheiten zur API finden Sie unter PutConfigRule in AWS CLI Befehlsreferenz.

Python
SDK für Python (Boto3)
Anmerkung

Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das AWS -Code-Beispiel- einrichten und ausführen.

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
  • Einzelheiten zur API finden Sie unter PutConfigRule in AWS API-Referenz für das SDK für Python (Boto3).

SAP ABAP
SDK für SAP ABAP
Anmerkung

Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das AWS -Code-Beispiel- einrichten und ausführen.

" 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'.
  • Einzelheiten zur API finden Sie unter PutConfigRule in AWS SDK für SAP ABAP API-Referenz.