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.
Voraussetzungen für die Einrichtung AWS Config mit dem AWS CLI
Vor der Einrichtung AWS mit dem AWS CLI, müssen Sie einen Amazon S3-Bucket, ein Amazon SNS-Thema und eine IAM-Rolle mit angehängten Richtlinien als Voraussetzungen erstellen. Sie können dann das verwenden AWS CLI um den Bucket, das Thema und die Rolle anzugeben für AWS Config. Gehen Sie wie folgt vor, um Ihre Voraussetzungen für AWS Config einzurichten.
Themen
Schritt 1: Einen Amazon S3-Bucket erstellen
Wenn Sie in Ihrem Konto bereits über einen Amazon-S3-Bucket verfügen und diesen verwenden möchten, überspringen Sie diesen Schritt und gehen zu Schritt 2: Ein Amazon SNS-Thema erstellen über.
So erstellen Sie einen Bucket
Öffnen Sie die Amazon S3-Konsole unter https://console.aws.amazon.com/s3/
. -
Wählen Sie Create Bucket (Bucket erstellen) aus.
-
In Name des Eimers, geben Sie einen ein DNS-compliant Name für Ihren Eimer.
Der Bucket-Name ...:
-
überall in Amazon S3 eindeutig sein.
-
zwischen 3 und 63 Zeichen lang sein,
-
Enthält keine Großbuchstaben.
-
mit einem Kleinbuchstaben oder einer Zahl beginnen.
Der Name eines einmal erstellten Buckets kann nicht nachträglich geändert werden. Stellen Sie sicher, dass der von Ihnen gewählte Bucket-Name unter allen in Amazon S3 vorhandenen Bucket-Namen eindeutig ist. Weitere Informationen zu Namensregeln und -konventionen für Buckets finden Sie unter Beschränkungen und Einschränkungen von Buckets im Benutzerhandbuch für Amazon Simple Storage Service.
WichtigVermeiden Sie es, vertrauliche Informationen in den Bucket-Namen aufzunehmen. Der Bucket-Name wird in der URL angezeigt, die auf die Objekte im Bucket verweist.
-
-
In Region, wähle die AWS Region, in der sich der Bucket befinden soll.
Wählen Sie eine Region in der Nähe aus, um Latenz und Kosten auf einem Minimum zu halten und behördliche Vorschriften zu erfüllen. In einer Region gespeicherte Objekte verbleiben so lange in der Region, bis sie explizit in eine andere Region verschoben werden. Für eine Liste von Amazon S3 AWS Regionen finden Sie unter AWS Service-Endpunkte in der Allgemeine Amazon Web Services-Referenz.
-
Wählen Sie unter Bucket settings for Block Public Access (Bucket-Einstellungen für den öffentlichen Zugriff) die Einstellungen für den öffentlichen Zugriff aus, die Sie auf den Bucket anwenden möchten.
Es wird empfohlen, alle Einstellungen aktiviert zu belassen, es sei denn, Sie wissen, dass Sie eine oder mehrere dieser Einstellungen für Ihren Anwendungsfall deaktivieren müssen, z. B. um eine öffentliche Website zu hosten. Einstellungen für den öffentlichen Zugriff, die Sie für den Bucket aktivieren, werden auch für alle Zugriffspunkte aktiviert, die Sie für den Bucket erstellen. Weitere Informationen zum Blockieren des öffentlichen Zugriffs finden Sie unter Verwenden von Amazon S3 Block Public Access im Amazon Simple Storage Service-Benutzerhandbuch.
-
(Optional) Wenn Sie die S3-Objektsperre aktivieren möchten:
-
Wählen Sie Fortschrittliche Einstellungen aus und lesen Sie die anschließend angezeigte Meldung.
WichtigSie können die S3-Objektsperre für einen Bucket nur aktivieren, wenn Sie ihn erstellen. Wenn Sie die Objektsperre für den Bucket aktivieren, können Sie es später nicht mehr deaktivieren. Durch Aktivieren der Objektsperre wird auch die Versionssteuerung für den Bucket aktiviert. Nachdem Sie die Objektsperre für den Bucket aktiviert haben, müssen Sie die Objektsperreneinstellungen konfigurieren, bevor Objekte im Bucket geschützt werden. Weitere Informationen zum Konfigurieren des Schutzes für Objekte finden Sie unter Konfigurieren der S3 Object Lock mit der Amazon-S3-Konsole.
-
Wenn Sie die Objektsperre aktivieren möchten, geben Sie in das Textfeld enable (Aktivieren) ein und wählen Sie Confirm (Bestätigen) aus.
Weitere Informationen zur S3-Objektsperrenfunktion finden Sie unter Sperren von Objekten mit der Amazon S3-Objektsperre im Amazon Simple Storage Service-Benutzerhandbuch.
-
-
Wählen Sie Create Bucket (Bucket erstellen) aus.
Wenn du den benutzt AWS SDKs Um einen Bucket zu erstellen, müssen Sie einen Client erstellen und den Client dann verwenden, um eine Anfrage zum Erstellen eines Buckets zu senden. Als bewährte Methode sollten Sie Ihren Client und Ihren Bucket in derselben AWS-Region erstellen. Wenn Sie beim Erstellen eines Clients oder Buckets keine Region angeben, verwendet Amazon S3 die Standardregion USA Ost (Nord-Virginia).
Um einen Client für den Zugriff auf einen Dual-Stack-Endpunkt zu erstellen, müssen Sie einen angeben AWS-Region. Weitere Informationen finden Sie unter Dual-Stack-Endpunkte von Amazon S3. Für eine Liste verfügbarer AWS-Regionen, siehe Regionen und Endpunkte in der Allgemeine AWS-Referenz.
Wenn Sie einen Client erstellen, wird die Region dem zugeordnet Region-specific Endpunkt. Der Client verwendet diesen Endpunkt für die Kommunikation mit Amazon S3: s3.. Wenn Ihre Region nach dem 20. März 2019 gestartet wurde, müssen sich Ihr Client und Ihr Bucket in derselben Region befinden. Sie können jedoch einen Client in der Region USA Ost (Nord-Virginia) verwenden, um einen Bucket in einer beliebigen Region zu erstellen, die vor dem 20. März 2019 gestartet wurde. Weitere Informationen finden Sie unter Legacy-Endpunkte.<region>.amazonaws.com
Diese AWS SDK-Codebeispiele erfüllen die folgenden Aufgaben:
-
Erstellen Sie einen Client, indem Sie explizit eine AWS-Region angeben – Im Beispiel verwendet der Client den Endpunkt
s3.us-west-2.amazonaws.com, um mit Amazon S3 zu kommunizieren. Sie können eine beliebige AWS-Region angeben. Für eine Liste von AWS-Regionen, siehe Regionen und Endpunkte in der AWS Allgemeine Referenz. -
Senden einer Bucket-Erstellungs-Anfrage durch Angabe eines Bucket-Namens – Der Client sendet eine Anfrage an Amazon S3, um den Bucket in der Region zu erstellen, in der Sie einen Client erstellt haben.
-
Abrufen von Informationen zum Standort des Buckets – Amazon S3 speichert Informationen zum Standort des Buckets in der Subressource location (Standort), die dem Bucket zugeordnet ist.
Die folgenden Code-Beispiele zeigen, wie CreateBucket verwendet wird.
Sie können auch den Amazon-S3-Bucket eines anderen Kontos verwenden. Allerdings müssen Sie ggf. eine Richtlinie für den Bucket erstellen, die AWS Config Zugriffsberechtigungen erteilt. Weitere Informationen zum Erteilen von Berechtigungen für einen Amazon-S3-Bucket finden Sie unter Berechtigungen für den Amazon S3-Bucket für den AWS Config Übermittlungskanal. Rufen Sie anschließend Schritt 2: Ein Amazon SNS-Thema erstellen auf.
Schritt 2: Ein Amazon SNS-Thema erstellen
Wenn Sie in Ihrem Konto bereits über ein Amazon-SNS-Thema verfügen und dieses verwenden möchten, überspringen Sie diesen Schritt und machen Sie bei Schritt 3: Eine IAM-Rolle erstellen weiter.
Erstellen eines Amazon SNS-Themas
Öffnen Sie die Amazon-SNS-Konsole unter https://console.aws.amazon.com/sns/v3/home
. -
Führen Sie eine der folgenden Aktionen aus:
-
Wenn noch nie Themen unter Ihrem erstellt wurden AWS-Konto Lesen Sie zuvor die Beschreibung von Amazon SNS auf der Startseite.
-
Wenn Themen unter Ihrem erstellt wurden AWS-Konto zuvor wählen Sie im Navigationsbereich Themen.
-
-
Klicken Sie auf der Seite Themen auf Create New Topic.
-
Führen Sie auf der Seite Create subscription (Abonnement erstellen) im Abschnitt Details die folgenden Schritte aus:
-
FürTypWählen Sie einen Thementyp aus (Standard-oderFIFO).
-
Geben Sie den Namen des neuen Themas ein. Für eineFIFO-ThemaFügen SieFIFOam Ende des Namens hinzu.
-
(Optional) Geben Sie einen Display name (Anzeigenamen) für Ihr Thema ein.
-
(Optional) Für ein FIFO-Thema können SieDeduplizierung für inhaltsbasierte Nachrichten, um die Standardnachrichtendeduplizierung zu aktivieren. Weitere Informationen finden Sie unter Nachrichtendeduplizierung für FIFO-Themen.
-
-
(Optional) Erweitern Sie den Abschnitt Encryption (Verschlüsselung) und gehen Sie wie folgt vor. Weitere Informationen finden Sie unter Verschlüsselung im Ruhezustand.
-
Wählen Sie Enable encryption (Verschlüsselung aktivieren) aus.
-
Geben Sie den Kundenmasterschlüssel (CMK) an. Weitere Informationen finden Sie unter Schlüsselbegriffe.
Für jeden CMK-Typ werden Description (Beschreibung), Account (Konto) und CMK ARN (CMK-ARN) angezeigt.
WichtigWenn Sie nicht der Besitzer des CMK sind oder wenn Sie sich mit einem Konto anmelden, das über keine
kms:ListAliasesundkms:DescribeKey-Berechtigungen verfügt, können Sie auf der Amazon SNS-Konsole keine Informationen über den CMK aufrufen.Bitten Sie den Inhaber des CMK, Ihnen diese Berechtigungen zu erteilen. Beispiele und weitere Informationen zu AWS KMS -Berechtigungen finden Sie unter API-Berechtigungen: Referenztabelle für Aktionen und Ressourcen im AWS Key Management Service Benutzerhandbuch.
-
Das AWS verwaltetes CMK für Amazon SNS (Standard) alias/aws/sns ist standardmäßig ausgewählt.
AnmerkungBeachten Sie Folgendes:
-
Wenn Sie das zum ersten Mal verwenden AWS-Managementkonsole um den zu spezifizieren AWS verwaltete CMK für Amazon SNS für ein Thema, AWS KMS erstellt den AWS verwaltetes CMK für Amazon SNS.
-
Alternativ können Sie bei der ersten Verwendung des
PublishAktion zu einem Thema mit aktiviertem SSE, AWS KMS erstellt die AWS verwaltetes CMK für Amazon SNS.
-
-
Um ein benutzerdefiniertes CMK von Ihrem zu verwenden AWS-Konto, wählen Sie das Kunden-Hauptschlüssel (CMK) Feld und wählen Sie dann den benutzerdefinierten CMK aus der Liste aus.
AnmerkungWeitere Informationen zum Erstellen benutzerdefinierter CMKs finden Sie unterErstellen von SchlüsselnimAWS Key Management Service Entwicklerhandbuch
-
Um einen benutzerdefinierten CMK-ARN aus Ihrem zu verwenden AWS-Konto oder von einem anderen AWS Konto, geben Sie es in das Kunden-Hauptschlüssel (CMK) Feld.
-
-
-
(Optional) Standardmäßig kann nur der Eigentümer des Themas das Thema abonnieren oder Veröffentlichungen dazu vornehmen. Um zusätzliche Zugriffsberechtigungen zu konfigurieren, erweitern Sie den Abschnitt Access policy (Zugriffsrichtlinie). Weitere Informationen finden Sie unter Identity and Access Management in Amazon SNS und Beispiele für die Zugriffskontrolle in Amazon SNS.
AnmerkungWenn Sie ein Thema mit der Konsole erstellen, verwendet die Standardrichtlinie den Bedingungsschlüssel
aws:SourceOwner. Dieser Schlüssel ist ähnlich wieaws:SourceAccount. -
(Optional) Um zu konfigurieren, wie Amazon SNS fehlgeschlagene Nachrichtenzustellungsversuche wiederholt, erweitern Sie das Richtlinie zur Wiederholung der Zustellung (HTTP/S) Abschnitt. Weitere Informationen finden Sie unter Wiederholungsversuche bei der Nachrichtenzustellung Amazon SNS.
-
(Optional) Um zu konfigurieren, wie Amazon SNS die Zustellung von Nachrichten protokolliert CloudWatch, erweitern Sie das Protokollierung des Lieferstatus Abschnitt. Weitere Informationen finden Sie unter Amazon-SNS-Nachrichtenzustellungsstatus.
-
(Optional) Wenn Sie Metadaten-Tags zum Thema hinzufügen, erweitern Sie den Tag-Abschnitt, geben Sie einen Schlüssel und einen Wert ein (optional), und wählen Sie Tag hinzufügen aus. Weitere Informationen finden Sie unter Markierung von Amazon-SNS-Themen.
-
Wählen Sie Thema erstellen aus.
Das Thema ist erstellt und der
MyTopicSeite wird angezeigt.Das ThemaName,ARN, (optional)Anzeigename, undEigentümer des ThemasS AWS -Konto-ID werden auf derDetailsSeite angezeigt.
-
Kopieren Sie das Thema ARN in die Zwischenablage, zum Beispiel:
arn:aws:sns:us-east-2:123456789012:MyTopic
So hinterlegen Sie eine E-Mail-Adresse für das abonnierte Amazon-SNS-Thema
Öffnen Sie die Amazon-SNS-Konsole unter https://console.aws.amazon.com/sns/v3/home
. -
Wählen Sie im linken Navigationsbereich Subscriptions (Abonnements).
-
Wählen Sie auf der Seite Subscriptions (Abonnements) die Option Create subscription (Abonnement erstellen)aus.
-
Führen Sie auf der Seite Create subscription (Abonnement erstellen) im Abschnitt Details die folgenden Schritte aus:
-
Wählen Sie für Topic ARN den Amazon Resource Name (ARN) eines Themas.
-
Für Protocol wählen Sie einen Endpunkttypen. Folgende Endpunkttypen stehen zur Verfügung:
-
Anmerkung
Um ein SNS FIFO-Thema zu abonnieren, wählen Sie diese Option.
-
Für Endpoint, geben Sie den Endpunktwert ein, wie z. B. eine E-Mail-Adresse oder die ARN einer Amazon-SQS-Warteschlange.
-
Nur Firehose-Endpunkte: Für Abonnement-Rolle (ARN), geben Sie den ARN der IAM-Rolle an, die Sie für das Schreiben in Firehose-Lieferstreams erstellt haben. Weitere Informationen finden Sie unter Voraussetzungen für das Abonnieren von Firehose-Lieferstreams für Amazon SNS-Themen.
-
(Optional) Für Firehose, Amazon SQS, HTTP/S An Endpunkten können Sie auch die Zustellung von Rohnachrichten aktivieren. Weitere Informationen finden Sie unter Übermittlung unformatierter Nachrichten Amazon SNS.
-
(Optional) Um eine Filterrichtlinie zu konfigurieren, erweitern Sie den Abschnitt Abonnement-Filterrichtlinie. Weitere Informationen finden Sie unter Filterrichtlinien für Amazon-SNS-Abonnements.
-
(Optional) Um eine Warteschlange für unzustellbare Nachrichten für das Abonnement zu konfigurieren, erweitern Sie den Abschnitt Redrive-Richtlinie (Warteschlange für unzustellbare Nachrichten). Weitere Informationen finden Sie unter Amazon SNS Queues für unzustellbare Nachrichten (DLQs).
-
Wählen Sie Create subscription (Abonnement erstellen) aus.
Die Konsole erstellt das Abonnement und öffnet die Seite Details des Abonnements.
-
Um eine zu verwenden AWS SDK, Sie müssen es mit Ihren Anmeldeinformationen konfigurieren. Weitere Informationen finden Sie unter Freigegebene Konfigurations- und Anmeldeinformationsdateien im AWS -Referenzhandbuch zu SDKs und Tools.
Die folgenden Code-Beispiele zeigen, wie CreateTopic verwendet wird.
Sie können auch ein Amazon-SNS-Thema in einem anderen Konto verwenden, allerdings müssen Sie dann ggf. eine Richtlinie für Themen erstellen, die Zugriffsberechtigungen für AWS Config gewährt. Weitere Informationen zum Erteilen von Berechtigungen für ein Amazon-SNS-Thema finden Sie unter Berechtigungen für das Amazon-SNS-Thema. Rufen Sie anschließend Schritt 3: Eine IAM-Rolle erstellen auf.
Schritt 3: Eine IAM-Rolle erstellen
(Empfohlen) Verwenden Sie AWS Config Mit einem Dienst verknüpfte Rolle
Es wird empfohlen, die zu verwenden AWS Config dienstgebundene Rolle: AWSServiceRoleForConfig. Service-linked Rollen sind vordefiniert und beinhalten alle Berechtigungen, die AWS Config muss andere anrufen AWS-Services. Das AWS Config Die serviceverknüpfte Rolle ist für serviceverknüpfte Konfigurationsrekorder erforderlich.
Weitere Informationen finden Sie unter Verwenden Service-Linked Rollen für AWS Config.
Sie können die IAM-Konsole verwenden, um eine IAM-Rolle zu erstellen, die Folgendes gewährt AWS Config Berechtigungen für den Zugriff auf Ihren Amazon S3-Bucket, für den Zugriff auf Ihr Amazon SNS-Thema und für das Abrufen von Konfigurationsdetails für unterstützte AWS Ressourcen. Wenn Sie eine IAM-Rolle über die Konsole erstellen, fügt AWS Config automatisch die benötigten Berechtigungen an die Rolle an.
Wenn Sie eine verwendet haben AWS Dienst, der verwendet AWS Config (wie AWS Security Hub oder AWS Control Tower) und ein AWS Config Die Rolle wurde bereits erstellt, Sie sollten sicherstellen, dass die IAM-Rolle, die Sie bei der Einrichtung verwenden AWS Config behält die gleichen Mindestberechtigungen wie die bereits erstellte AWS Config Rolle in der Reihenfolge der anderen AWS Der Dienst soll weiterhin wie erwartet ausgeführt werden.
Zum Beispiel, wenn AWS Control Tower hat eine IAM-Rolle, die Folgendes ermöglicht AWS Config Um Amazon S3-Objekte zu lesen, sollten Sie sicherstellen, dass innerhalb der IAM-Rolle, die Sie bei der Einrichtung verwenden, dieselben Berechtigungen gewährt werden AWS Config. Andernfalls kann es stören AWS Der Betrieb des Kontrollturms.
Weitere Informationen zu IAM-Rollen für AWS Config, siehe AWS Identitäts- und Zugriffsmanagement.
Um eine Rolle für einen zu erstellen AWS Service nicht zulässig
Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter https://console.aws.amazon.com/iam/
. -
Klicken Sie im Navigationsbereich der IAM-Konsole auf Rollen, und wählen Sie dann Rolle erstellen.
-
Wählen Sie für Select trusted entity (Vertrauenswürdige Entität auswählen) die Option AWS -Dienst.
-
Wählen Sie den gewünschten Anwendungsfall AWS Config: Konfiguration - Individuell anpassbar, Config - Organisationen, Konfiguration, oder Config — Konformitätspakete. Wählen Sie anschließend Weiter.
-
Überprüfen Sie auf der Seite Name, prüfen und erstellen die Details zu Ihrer Rolle und wählen Sie Rolle erstellen aus.
Um eine zu benutzen AWS SDK, Sie müssen es mit Ihren Anmeldeinformationen konfigurieren. Weitere Informationen finden Sie unter Freigegebene Konfigurations- und Anmeldeinformationsdateien im AWS -Referenzhandbuch zu SDKs und Tools.
Die folgenden Code-Beispiele zeigen, wie CreateRole verwendet wird.