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.
Inhaber-Token-Authentifizierung einrichten
Diese Seite behandelt die Inhaber-Token-Authentifizierung für CloudWatch Protokolle. Für CloudWatch Authentifizierung mit einem Metrik-Inhaber-Tokens finden Sie unter Einrichtung der Inhaber-Token-Authentifizierung für Metriken in der CloudWatch Benutzerleitfaden. Informationen zur Authentifizierung mit Traces Bearer-Tokens finden Sie unter Einrichtung der Bearer-Token-Authentifizierung für Traces in der X-Ray Leitfaden für Entwickler. Jeder Dienst benötigt seinen eigenen API-Schlüssel.
Bevor Sie Protokolle mithilfe der Bearer-Token-Authentifizierung an einen der HTTP-Aufnahmeendpunkte senden können, müssen Sie:
Erstellen Sie einen IAM-Benutzer mit CloudWatch Protokolliert Berechtigungen
Generieren Sie dienstspezifische Anmeldeinformationen (Inhaber-Token)
Erstellen Sie eine Protokollgruppe und einen Protokollstream
Aktivieren Sie die Inhaber-Token-Authentifizierung für die Protokollgruppe
Wir empfehlen, für alle Workloads, bei denen dies möglich ist, die SigV4-Authentifizierung mit kurzfristigen Anmeldeinformationen zu verwenden. SigV4 bietet die stärkste Sicherheit. Beschränken Sie die Verwendung von API-Schlüsseln (Inhaber-Token) auf Szenarien, in denen eine kurzfristige Authentifizierung mit Anmeldeinformationen nicht möglich ist. Wenn Sie bereit sind, zu integrieren CloudWatch Wenn Sie sich bei Anwendungen mit höheren Sicherheitsanforderungen anmelden, sollten Sie zu kurzfristigen Anmeldeinformationen wechseln. Weitere Informationen finden Sie unter Alternativen zu Langzeit-Zugriffsschlüsseln im IAM-Benutzerhandbuch.
Option 1: Schnellstart mit der AWS Konsole
Die AWS Die Management Console bietet einen optimierten Arbeitsablauf zum Generieren von API-Schlüsseln für den HTTP-Endpunktzugriff.
So richten Sie den HTTP-Endpunktzugriff mithilfe der Konsole ein
Melden Sie sich bei der AWS Management-Konsole.
Navigieren Sie zu CloudWatch > Einstellungen > Logs.
-
Wählen Sie im Abschnitt API-Schlüssel die Option API-Schlüssel generieren aus.
-
Für den Ablauf des API-Schlüssels haben Sie folgende Möglichkeiten:
Wählen Sie eine Ablaufdauer für den API-Schlüssel von 1, 5, 30, 90 oder 365 Tagen aus.
Wählen Sie Benutzerdefinierte Dauer aus, um ein benutzerdefiniertes Ablaufdatum für den API-Schlüssel festzulegen.
Wählen Sie Läuft nie ab aus (nicht empfohlen).
-
Wählen Sie API-Schlüssel generieren aus.
Die Konsole führt automatisch Folgendes durch:
Erstellt einen neuen IAM-Benutzer mit entsprechenden Berechtigungen
Hängt die an CloudWatchLogsAPIKeyAccess verwaltete Richtlinie (beinhaltet
logs:PutLogEventsundlogs:CallWithBearerTokenGenehmigungen)Generiert servicespezifische Anmeldeinformationen (API-Schlüssel)
-
Kopieren Sie die angezeigten Anmeldeinformationen und speichern Sie sie sicher:
API-Schlüssel-ID (Service-specific Anmeldeinformationen (ID)
API-Schlüssel-Geheimnis (Bearer-Token)
WichtigSpeichern Sie das API-Schlüssel-Geheimnis sofort. Er kann später nicht mehr abgerufen werden. Wenn Sie ihn verlieren, müssen Sie einen neuen API-Schlüssel generieren.
-
Erstellen Sie die Log-Gruppe und den Log-Stream, in dem Ihre Logs gespeichert werden:
# Create the log group aws logs create-log-group \ --log-group-name /aws/hlc-logs/my-application \ --region us-east-1 # Create the log stream aws logs create-log-stream \ --log-group-name /aws/hlc-logs/my-application \ --log-stream-name application-stream-001 \ --region us-east-1 -
Aktivieren Sie die Inhaber-Token-Authentifizierung für die Loggruppe:
aws logs put-bearer-token-authentication \ --log-group-identifier /aws/hlc-logs/my-application \ --bearer-token-authentication-enabled \ --region us-east-1Überprüfen Sie die Konfiguration:
aws logs describe-log-groups \ --log-group-name-prefix /aws/hlc-logs/my-application \ --region us-east-1
Eingeschlossene Berechtigungen: Der automatisch erstellte IAM-Benutzer wird über die folgenden Berechtigungen verfügen:
logs:PutLogEvents— Sendet Protokollereignisse an CloudWatch • Protokollelogs:CallWithBearerToken— Authentifizieren Sie sich mit dem Inhaber-Tokenkms:Describe*,kms:GenerateDataKey*,kms:Decrypt— Zugang KMS-encrypted Protokollgruppen (mit einer Bedingung, die auf den Protokolldienst beschränkt ist)
Option 2: Manuelles Setup
Wenn Sie mehr Kontrolle über die IAM-Konfiguration bevorzugen oder die Berechtigungen anpassen müssen, können Sie den HTTP-Endpunktzugriff manuell einrichten.
Schritt 1: Einen IAM-Benutzer erstellen
Erstellen Sie einen IAM-Benutzer, der für die Protokollaufnahme verwendet wird:
Melden Sie sich an bei AWS Managementkonsole und navigieren Sie zu IAM.
Wählen Sie im linken Navigationsbereich Benutzer aus.
Wählen Sie Create user (Benutzer erstellen) aus.
Geben Sie einen Benutzernamen ein (z. B.
cloudwatch-logs-hlc-user).Wählen Sie Weiter aus.
-
Fügen Sie eine der folgenden IAM-Richtlinien an:
Option A: Die verwaltete Richtlinie verwenden (empfohlen)
Hängen Sie das an CloudWatchLogsAPIKeyAccess verwaltete Richtlinie.
Option B: Eine eigene Richtlinie erstellen
Erstellen Sie die folgende IAM-Richtlinie und fügen Sie sie an:
{ "Version": "2012-10-17", "Statement": [ { "Sid": "LogsAPIs", "Effect": "Allow", "Action": [ "logs:CallWithBearerToken", "logs:PutLogEvents" ], "Resource": "*" }, { "Sid": "KMSAPIs", "Effect": "Allow", "Action": [ "kms:Describe*", "kms:GenerateDataKey*", "kms:Decrypt" ], "Condition": { "StringEquals": { "kms:ViaService": [ "logs.*.amazonaws.com" ] } }, "Resource": "arn:aws:kms:*:*:key/*" } ] } Wählen Weiter und dann Benutzer erstellen.
Die KMS-Berechtigungen sind erforderlich, wenn Sie planen, Protokolle zu senden KMS-encrypted Protokollgruppen. Die Bedingung beschränkt den KMS-Zugriff nur auf Schlüssel, die über verwendet werden CloudWatch Protokolliert den Dienst.
Schritt 2: Servicespezifische Anmeldeinformationen (API-Schlüssel) generieren
Generieren Sie den CloudWatch Protokolliert den API-Schlüssel mit dem CreateServiceSpecificCredential API. Sie können auch die verwenden Create-service-Specific-Credential
So generieren Sie einen API-Schlüssel mit einer Gültigkeitsdauer von 30 Tagen:
aws iam create-service-specific-credential \ --user-name cloudwatch-logs-hlc-user \ --service-name logs.amazonaws.com \ --credential-age-days 30
Die Antwort ist ein ServiceSpecificCredential Objekt. Das ServiceCredentialSecret Wert ist dein CloudWatch Protokolliert den API-Schlüssel (Inhaber-Token).
Speichern Sie den Wert „ServiceCredentialSecret“ sicher, da Sie ihn später nicht mehr abrufen können. Wenn Sie ihn verlieren, müssen Sie einen neuen API-Schlüssel generieren.
Schritt 3: Erstellen Sie eine Protokollgruppe und einen Protokollstream
Erstellen Sie die Loggruppe und den Log-Stream, in denen Ihre Logs gespeichert werden:
# Create the log group aws logs create-log-group \ --log-group-name /aws/hlc-logs/my-application \ --region us-east-1 # Create the log stream aws logs create-log-stream \ --log-group-name /aws/hlc-logs/my-application \ --log-stream-name application-stream-001 \ --region us-east-1
Schritt 4: Aktivieren Sie die Inhaber-Token-Authentifizierung
Aktivieren Sie die Inhaber-Token-Authentifizierung für die Protokollgruppe:
aws logs put-bearer-token-authentication \ --log-group-identifier /aws/hlc-logs/my-application \ --bearer-token-authentication-enabled \ --region us-east-1
Überprüfen Sie die Konfiguration:
aws logs describe-log-groups \ --log-group-name-prefix /aws/hlc-logs/my-application \ --region us-east-1
Steuern Sie die Berechtigungen für das Generieren und Verwenden CloudWatch Protokolliert API-Schlüssel
Die Generierung und Verwendung von CloudWatch Die API-Schlüssel für Protokolle werden durch Aktionen und Bedingungsschlüssel in beiden CloudWatch Protokolle und IAM-Dienste.
Steuerung der Generierung von CloudWatch Protokolliert API-Schlüssel
Das Ich bin:CreateServiceSpecificCredential Aktion steuert die Generierung eines dienstspezifischen Schlüssels (z. B. CloudWatch Protokolliert den API-Schlüssel). Sie können diese Aktion auf IAM-Benutzer als Ressource beschränken, um die Anzahl der Benutzer einzuschränken, für die ein Schlüssel generiert werden kann.
Mit den folgenden Bedingungsschlüsseln können Sie Bedingungen mit der Berechtigung für die Aktion iam:CreateServiceSpecificCredential verknüpfen:
Ich bin:ServiceSpecificCredentialAgeDays — Ermöglicht es Ihnen, in der Bedingung die Ablaufzeit des Schlüssels in Tagen anzugeben. Sie können diesen Bedingungsschlüssel zum Beispiel verwenden, um nur das Erstellen von API-Schlüsseln zu erlauben, die innerhalb von 90 Tagen ablaufen.
Ich bin:ServiceSpecificCredentialServiceName — Ermöglicht es Ihnen, in der Bedingung den Namen eines Dienstes anzugeben. Sie können diesen Bedingungsschlüssel beispielsweise verwenden, um nur die Erstellung von API-Schlüsseln zuzulassen für CloudWatch Protokolle und keine anderen Dienste.
Kontrolle der Verwendung von CloudWatch Protokolliert API-Schlüssel
Das logs:CallWithBearerToken Aktion steuert die Verwendung von CloudWatch Protokolliert den API-Schlüssel. Um zu verhindern, dass eine Identität verwendet wird CloudWatch Protokolliert API-Schlüssel, fügen Sie eine Richtlinie hinzu, die Folgendes verweigert logs:CallWithBearerToken Aktion für den IAM-Benutzer, der dem Schlüssel zugeordnet ist.
Beispielrichtlinien
Verhindern Sie, dass eine Identität generiert und verwendet wird CloudWatch Protokolliert API-Schlüssel
{ "Version": "2012-10-17", "Statement": [ { "Sid": "DenyCWLAPIKeys", "Effect": "Deny", "Action": [ "iam:CreateServiceSpecificCredential", "logs:CallWithBearerToken" ], "Resource": "*" } ] }
Diese Richtlinie verhindert die Erstellung von Anmeldeinformationen für alle AWS Dienste, die die Erstellung dienstspezifischer Anmeldeinformationen unterstützen. Weitere Informationen finden Sie unter Service-specific Anmeldeinformationen für IAM-Benutzer.
Verhindern Sie, dass eine Identität verwendet wird CloudWatch Protokolliert API-Schlüssel
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Deny", "Action": "logs:CallWithBearerToken", "Resource": "*" } ] }
Erlauben Sie die Erstellung von CloudWatch Protokolliert Schlüssel nur, wenn sie innerhalb von 90 Tagen ablaufen
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iam:CreateServiceSpecificCredential", "Resource": "arn:aws:iam::123456789012:user/username", "Condition": { "StringEquals": { "iam:ServiceSpecificCredentialServiceName": "logs.amazonaws.com" }, "NumericLessThanEquals": { "iam:ServiceSpecificCredentialAgeDays": "90" } } } ] }
Rotieren von API-Schlüsseln
Das regelmäßige Rotieren von API-Schlüsseln verringert das Risiko eines unbefugten Zugriffs. Wir empfehlen, einen Rotationsplan zu erstellen, der den Sicherheitsrichtlinien Ihres Unternehmens entspricht.
Rotationsprozess
Gehen Sie wie folgt vor, um einen API-Schlüssel zu rotieren, ohne die Protokollübermittlung zu unterbrechen:
-
Erstellen Sie einen neuen (sekundären) Berechtigungsnachweis für den IAM-Benutzer:
aws iam create-service-specific-credential \ --user-name cloudwatch-logs-hlc-user \ --service-name logs.amazonaws.com \ --credential-age-days 90 (Optional) Speichern Sie die neuen Anmeldeinformationen in AWS Secrets Manager für sicheren Abruf und automatische Rotation.
Importieren Sie die neuen Anmeldeinformationen in das Portal Ihres Anbieters oder aktualisieren Sie Ihre Anwendungskonfiguration, um den neuen API-Schlüssel zu verwenden.
-
Setzen Sie die ursprünglichen Anmeldeinformationen auf inaktiv:
aws iam update-service-specific-credential \ --user-name cloudwatch-logs-hlc-user \ --service-specific-credential-id ACCA1234EXAMPLE1234 \ --status Inactive Stellen Sie sicher, dass die Protokollzustellung nicht beeinträchtigt wird, indem Sie Folgendes überwachen
IncomingBytesMetrik für Ihre Protokollgruppe in CloudWatch. Weitere Informationen finden Sie unter Überwachung mit CloudWatch Metriken.-
Nachdem Sie die erfolgreiche Bereitstellung mit dem neuen Schlüssel bestätigt haben, löschen Sie die vorherigen Anmeldeinformationen:
aws iam delete-service-specific-credential \ --service-specific-credential-id ACCA1234EXAMPLE1234
Überwachen des Ablauftermins von Schlüsseln.
Verwenden Sie den Befehl list-service-specific-credentials
aws iam list-service-specific-credentials \ --user-name cloudwatch-logs-hlc-user \ --service-name logs.amazonaws.com
Die Antwort enthält das CreateDate und den Status für jede Anmeldeinformation. Anhand dieser Informationen können Sie die Schlüssel identifizieren, die bald ablaufen oder die länger aktiv sind, als es Ihre Rotationsrichtlinie zulässt.
Reaktion auf einen kompromittierten API-Schlüssel
Wenn Sie vermuten, dass ein API-Schlüssel kompromittiert wurde, führen Sie sofort die folgenden Schritte durch:
-
Deaktivieren Sie den Schlüssel sofort, um eine weitere unbefugte Verwendung zu verhindern:
aws iam update-service-specific-credential \ --user-name cloudwatch-logs-hlc-user \ --service-specific-credential-id ACCA1234EXAMPLE1234 \ --status Inactive Bewertung CloudTrail aufzeichnen um den Umfang des unberechtigten Zugriffs zu ermitteln. Informationen zur Überprüfung der API-Schlüsselnutzung finden Sie unter Protokollierung der API-Schlüsselnutzung mit CloudTrail.
Erstellen Sie einen Ersatzschlüssel gemäß dem unter Rotationsprozess beschriebenen Rotationsprozess.
-
Löschen Sie den kompromittierten Schlüssel, nachdem der Ersatzschlüssel installiert wurde:
aws iam delete-service-specific-credential \ --service-specific-credential-id ACCA1234EXAMPLE1234 Fügen Sie eine Ablehnungsrichtlinie hinzu, wenn Sie sofort den gesamten Zugriff auf Bearer-Tokens für den IAM-Benutzer sperren müssen, während Sie die Untersuchung durchführen:
{ "Version": "2012-10-17", "Statement": { "Effect": "Deny", "Action": "logs:CallWithBearerToken", "Resource": "*" } }
Um diese Aktionen über die API auszuführen, müssen Sie sich bei authentifizieren AWS Anmeldeinformationen und nicht mit einem CloudWatch Protokolliert den API-Schlüssel.
Sie können auch die folgenden IAM-API-Operationen verwenden, um kompromittierte Schlüssel zu verwalten:
ResetServiceSpecificCredential — Setzen Sie den Schlüssel zurück, um ein neues Passwort zu generieren, ohne die Anmeldeinformationen zu löschen. Der Schlüssel darf noch nicht abgelaufen sein.
Bewährte Methoden zum Schutz von API-Schlüsseln
Folgen Sie diesen bewährten Methoden, um Ihre zu schützen CloudWatch Protokolliert API-Schlüssel:
Betten Sie API-Schlüssel niemals in den Quellcode ein. Codieren Sie API-Schlüssel nicht fest im Anwendungscode und geben Sie sie nicht an Versionskontrollsysteme weiter. Wenn ein Schlüssel versehentlich in ein öffentliches Repository übertragen wird, AWS Durch automatisiertes Scannen kann es passieren, dass der Schlüssel angezeigt wird. Sie sollten den Schlüssel sofort ändern.
Verwenden Sie Secrets Manager. Speichern Sie API-Schlüssel in AWS Secrets Manager oder eine gleichwertige Lösung zur Verwaltung von Geheimnissen. Das ermöglicht eine zentrale Zugriffssteuerung, die Auditprotokollierung und eine automatisierte Rotation.
Legen Sie für alle Schlüssel ein Ablaufdatum fest. Geben Sie beim Erstellen von API-Schlüsseln immer einen
--credential-age-days-Wert an. Verwenden Sie den IAM-Bedingungsschlüsseliam:ServiceSpecificCredentialAgeDays, um eine maximale Gültigkeitsdauer von Schlüsseln in Ihrer Organisation durchzusetzen. Ein Beispiel finden Sie unter Erlauben Sie die Erstellung von CloudWatch Protokolliert Schlüssel nur, wenn sie innerhalb von 90 Tagen ablaufen.Gewähren Sie immer nur geringste Berechtigungen. Beschränken Sie die Berechtigungen des IAM-Benutzers nur auf die erforderlichen Protokollgruppen und Aktionen. Verwenden Sie das verwaltete CloudWatchLogsAPIKeyAccess Richtlinie als Ausgangspunkt und weitere Einschränkungen nach Bedarf.
Aktiviere CloudTrail Protokollierung. Überwachen Sie die Nutzung der API-Schlüssel, indem Sie Folgendes aktivieren CloudTrail Datenereignisse für
AWS::Logs::LogGroupAuthorization. Siehe Protokollierung der API-Schlüsselnutzung mit CloudTrail.Nutzen Sie IAM Access Analyzer zur Überwachung. Verwenden Sie IAM Access Analyzer, um ungenutzte Anmeldeinformationen und übermäßig freizügige Richtlinien im Zusammenhang mit Ihren API-Schlüssel-IAM-Benutzern zu identifizieren.
Rotieren Sie die Schlüssel regelmäßig. Legen Sie einen Rotationsplan fest und folgen Sie dem in Rotieren von API-Schlüsseln beschriebenen Verfahren.
Protokollierung der API-Schlüsselnutzung mit CloudTrail
Sie können verwenden AWS CloudTrail um Datenereignisse zu protokollieren für CloudWatch Protokolliert die Verwendung des API-Schlüssels. CloudWatch Protokolliert Emissionen AWS::Logs::LogGroupAuthorization Datenereignisse für CallWithBearerToken Aufrufe, sodass Sie überprüfen können, wann und wie API-Schlüssel zum Senden von Protokollen verwendet werden.
Um zu aktivieren CloudTrail protokollieren für CloudWatch Protokolliert die Verwendung des API-Schlüssels:
Der S3-Bucket, den Sie für den Trail angeben, muss über eine Bucket-Richtlinie verfügen, die Folgendes ermöglicht CloudTrail um Logdateien in ihn zu schreiben. Weitere Informationen finden Sie unter Amazon S3-Bucket-Richtlinie für CloudTrail.
-
Einen Trail anlegen:
aws cloudtrail create-trail \ --name cloudwatch-logs-api-key-audit \ --s3-bucket-name my-cloudtrail-bucket \ --region us-east-1 -
Konfigurieren Sie erweiterte Event-Selektoren für die Erfassung CloudWatch Protokolle protokollieren Gruppenautorisierungsereignisse:
aws cloudtrail put-event-selectors \ --region us-east-1 \ --trail-name cloudwatch-logs-api-key-audit \ --advanced-event-selectors '[{ "Name": "CloudWatch Logs API key authorization events", "FieldSelectors": [ { "Field": "eventCategory", "Equals": ["Data"] }, { "Field": "resources.type", "Equals": ["AWS::Logs::LogGroupAuthorization"] } ] }]' -
Die Trail-Protokollierung starten:
aws cloudtrail start-logging \ --name cloudwatch-logs-api-key-audit \ --region us-east-1