View a markdown version of this page

Geheime Verschlüsselung und Entschlüsselung in AWS Secrets Manager - AWS Secrets Manager

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.

Geheime Verschlüsselung und Entschlüsselung in AWS Secrets Manager

Secrets Manager verwendet die Umschlagverschlüsselung mit AWS KMS Schlüssel und Datenschlüssel um jeden geheimen Wert zu schützen. Wenn sich der Secret-Wert eines Secrets ändert, fordert Secrets Manager einen neuen Datenschlüssel von AWS KMS , um ihn zu schützen. Der Datenschlüssel wird unter einem KMS-Schlüssel verschlüsselt und in den Metadaten des Secrets gespeichert. Um das Geheimnis zu entschlüsseln, entschlüsselt Secrets Manager zunächst den verschlüsselten Datenschlüssel mithilfe des KMS-Schlüssels in AWS KMS.

Secrets Manager verwendet den KMS-Schlüssel nicht zum direkten Verschlüsseln des Secret-Werts. Stattdessen verwendet der Service den KMS-Schlüssel zum Generieren und Verschlüsseln eines symmetrischen 256-Bit Advanced Encryption Standard (AES)-Datenschlüssels und den Datenschlüssel zum Verschlüsseln des Secret-Werts. Secrets Manager verwendet den Klartext-Datenschlüssel, um den geheimen Wert außerhalb von zu verschlüsseln AWS KMS, und entfernt es dann aus dem Speicher. Die verschlüsselte Kopie des Datenschlüssels wird in den Metadaten des Geheimnisses gespeichert.

Auswahl eines AWS KMS Schlüssel

Wenn Sie ein Geheimnis erstellen, können Sie einen beliebigen, vom Kunden verwalteten Schlüssel für symmetrische Verschlüsselung in der AWS-Konto und Region, oder Sie können das verwenden Von AWS verwalteter Schlüssel für Secrets Manager (aws/secretsmanager). Wenn du das wählst Von AWS verwalteter Schlüssel aws/secretsmanager und es existiert noch nicht, Secrets Manager erstellt es und verknüpft es mit dem Geheimnis. Sie können entweder denselben KMS-Schlüssel oder unterschiedliche KMS-Schlüssel für jedes Secret in Ihrem Konto verwenden. Möglicherweise möchten Sie verschiedene KMS-Schlüssel verwenden, um benutzerdefinierte Berechtigungen für die Schlüssel für eine Gruppe von Secrets festzulegen oder wenn Sie bestimmte Vorgänge für diese Schlüssel überprüfen möchten. Secrets Manager unterstützt nur symmetrische KMS-Verschlüsselungsschlüssel. Wenn Sie einen KMS-Schlüssel in einem externen Schlüsselspeicher verwenden, können kryptografische Operationen mit dem KMS-Schlüssel länger dauern und weniger zuverlässig und dauerhaft sein, da die Anforderung außerhalb von AWS gesendet werden muss.

Informationen zum Ändern des Verschlüsselungsschlüssels für ein Secret finden Sie unter Ändern Sie den Verschlüsselungsschlüssel für eine AWS Secrets Manager Secret.

Wenn Sie den Verschlüsselungsschlüssel ändern, verschlüsselt Secrets Manager erneut AWSCURRENT, AWSPENDING, und AWSPREVIOUS Versionen mit dem neuen Schlüssel. Um zu verhindern, dass Sie das Geheimnis aussperren, verschlüsselt Secrets Manager alle vorhandenen Versionen mit dem vorherigen Schlüssel. Das heißt, Sie können entschlüsseln AWSCURRENT, AWSPENDING, und AWSPREVIOUS Versionen mit dem vorherigen Schlüssel oder dem neuen Schlüssel. Wenn Sie nicht haben kms:Decrypt Zugriff auf den vorherigen Schlüssel. Wenn Sie den Verschlüsselungsschlüssel ändern, kann Secrets Manager die geheimen Versionen nicht entschlüsseln, um sie erneut zu verschlüsseln. In diesem Fall werden die vorhandenen Versionen nicht erneut verschlüsselt.

Um es so zu machen AWSCURRENT kann nur mit dem neuen Verschlüsselungsschlüssel entschlüsselt werden. Erstellen Sie eine neue Version des Geheimnisses mit dem neuen Schlüssel. Um dann das entschlüsseln zu können AWSCURRENT geheime Version, Sie müssen die Erlaubnis für den neuen Schlüssel haben.

Sie können dem die Erlaubnis verweigern Von AWS verwalteter Schlüssel aws/secretsmanager und erforderliche Geheimnisse werden mit einem vom Kunden verwalteten Schlüssel verschlüsselt. Weitere Informationen finden Sie unter Beispiel: Verweigern Sie einen bestimmten AWS KMS Schlüssel zur Verschlüsselung von Geheimnissen.

Um den KMS-Schlüssel zu finden, der einem Geheimnis zugeordnet ist, sehen Sie sich das Geheimnis in der Konsole an oder rufen Sie an ListSecrets oder DescribeSecret. Wenn das Geheimnis mit dem verknüpft ist Von AWS verwalteter Schlüssel für Secrets Manager (aws/secretsmanager), geben diese Operationen keine KMS-Schlüssel-ID zurück.

Was ist verschlüsselt?

Secrets Manager verschlüsselt den geheimen Wert, aber Folgendes wird nicht verschlüsselt:

  • Name und Beschreibung des Secrets

  • Rotationseinstellungen

  • ARN des mit dem Secret verknüpften KMS-Schlüssels

  • Alle beigefügten AWS Tags

Ver- und Entschlüsselungsprozesse

Um den Secret-Wert in einem Secret zu verschlüsseln, geht Secrets Manager wie folgt vor.

  1. Secrets Manager nennt den AWS KMS GenerateDataKey Vorgang mit der ID des KMS-Schlüssels für das Geheimnis und einer Anforderung eines symmetrischen 256-Bit-AES-Schlüssels. AWS KMS gibt einen Klartext-Datenschlüssel und eine Kopie dieses Datenschlüssels zurück, der unter dem KMS-Schlüssel verschlüsselt ist.

  2. Secrets Manager verwendet den Klartext-Datenschlüssel und den AES-Algorithmus (Advanced Encryption Standard), um den geheimen Wert außerhalb von zu verschlüsseln AWS KMS. Der Klartextschlüssel wird direkt nach der Verwendung aus dem Speicher gelöscht.

  3. Secrets Manager speichert den verschlüsselten Datenschlüssel in den Metadaten des Secrets, sodass er jederzeit zum Entschlüsseln des Secret-Werts verfügbar ist. Keine der Secrets Manager APIs gibt jedoch das verschlüsselte Secret oder den verschlüsselten Datenschlüssel zurück.

So wird ein verschlüsselter Geheimniswert entschlüsselt:

  1. Secrets Manager ruft den an AWS KMS Entschlüsseln Operation und übergibt den verschlüsselten Datenschlüssel.

  2. AWS KMS verwendet den KMS-Schlüssel für das Geheimnis, um den Datenschlüssel zu entschlüsseln. gibt den Datenschlüssel in Klartext zurück.

  3. Secrets Manager entschlüsselt den Secret-Wert mithilfe des Nur-Text-Datenschlüssels. Anschließend entfernt er den Datenschlüssel so schnell wie möglich aus dem Speicher.

Berechtigungen für den KMS-Schlüssel

Wenn Secrets Manager einen KMS-Schlüssel in kryptografischen Operationen verwendet, handelt er im Namen des Benutzers, der auf den Secret-Wert zugreift oder diesen aktualisiert. Sie können Berechtigungen in einer IAM-Richtlinie oder einer Schlüsselrichtlinie gewähren. Die folgenden Secrets Manager-Operationen erfordern AWS KMS Berechtigungen.

Damit der KMS-Schlüssel nur für Anfragen verwendet werden kann, die aus Secrets Manager stammen, können Sie in der Berechtigungsrichtlinie den kms:ViaService Bedingungsschlüssel mit dem secretsmanager.<Region>.amazonaws.com Wert.

Sie können auch die Schlüssel oder Werte im Verschlüsselungskontext als Bedingung für die Nutzung des KMS-Schlüssels in kryptografischen Operationen verwenden. Zum Beispiel können Sie einen verwenden Operator für eine Zeichenfolge in einem IAM- oder wichtigen Richtliniendokument, oder verwenden Sie eine Beschränkung gewähren in einem Zuschuss. AWS KMS Die Weitergabe eines Schlüsselzuschusses kann bis zu fünf Minuten dauern. Weitere Informationen finden Sie unter CreateGrant.

Wie Secrets Manager den KMS-Schlüssel verwendet

Secrets Manager ruft Folgendes auf AWS KMS Operationen mit Ihrem KMS-Schlüssel.

GenerateDataKey

Secrets Manager ruft den auf AWS KMS GenerateDataKey Vorgang als Reaktion auf die folgenden Secrets Manager-Operationen.

  • CreateSecret — Wenn das neue Geheimnis einen geheimen Wert enthält, fordert Secrets Manager einen neuen Datenschlüssel an, um es zu verschlüsseln.

  • PutSecretValue — Secrets Manager fordert einen neuen Datenschlüssel an, um den angegebenen geheimen Wert zu verschlüsseln.

  • ReplicateSecretToRegions — Um das replizierte Geheimnis zu verschlüsseln, fordert Secrets Manager einen Datenschlüssel für den AWS KMS Schlüssel in der Replikat-Region.

  • UpdateSecret — Wenn Sie den geheimen Wert oder den KMS-Schlüssel ändern, fordert Secrets Manager einen neuen Datenschlüssel an, um den neuen geheimen Wert zu verschlüsseln.

• Der RotateSecret Operation ruft nicht an GenerateDataKey, weil der geheime Wert dadurch nicht geändert wird. Wenn RotateSecret jedoch eine Lambda-Rotationsfunktion aufruft, die den Secret-Wert ändert, löst sein Aufruf der Operation PutSecretValue eine GenerateDataKey-Anforderung aus.

Decrypt

Secrets Manager ruft die Operation Decrypt als Reaktion auf die folgenden Secrets-Manager-Operationen auf.

  • GetSecretValue und BatchGetSecretValue — Secrets Manager entschlüsselt den geheimen Wert, bevor er an den Anrufer zurückgegeben wird. Um einen verschlüsselten Geheimwert zu entschlüsseln, ruft Secrets Manager den AWS KMS Entschlüsseln Vorgang zum Entschlüsseln des verschlüsselten Datenschlüssels im Geheimnis. Dann wird der verschlüsselte Geheimniswert mithilfe des Klartext-Datenschlüssels entschlüsselt. Bei Batch-Befehlen kann Secrets Manager den entschlüsselten Schlüssel wiederverwenden, sodass nicht alle Aufrufe zu einer Decrypt-Anforderung führen.

  • PutSecretValue und UpdateSecret — Die meisten PutSecretValue und UpdateSecret Anfragen lösen keine aus Decrypt Betrieb. Wenn jedoch eine PutSecretValue- oder UpdateSecret-Anforderung versucht, den Secret-Wert in einer vorhandenen Version eines Secrets zu ändern, entschlüsselt Secrets Manager den vorhandenen Secret-Wert und vergleicht ihn mit dem Secret-Wert in der Anforderung, um zu bestätigen, dass beide Werte identisch sind. Somit wird die Idempotenz von Secrets-Manager-Operationen sichergestellt. Um einen verschlüsselten Geheimwert zu entschlüsseln, ruft Secrets Manager den AWS KMS Entschlüsseln Vorgang zum Entschlüsseln des verschlüsselten Datenschlüssels im Geheimnis. Dann wird der verschlüsselte Geheimniswert mithilfe des Klartext-Datenschlüssels entschlüsselt.

  • ReplicateSecretToRegions — Secrets Manager entschlüsselt zuerst den geheimen Wert in der primären Region, bevor der geheime Wert erneut mit dem verschlüsselt wird AWS KMS Schlüssel in der Replikat-Region.

  • AssociateCrossAccountReplica — Secrets Manager führt einen Probelaufruf zur Entschlüsselung mit dem KMS-Schlüssel des primären Geheimnisses durch. Dieser Anruf bestätigt, dass der Anrufer berechtigt ist, den Schlüssel zu verwenden. Während der Replikation entschlüsselt Secrets Manager den Datenschlüssel der primären geheimen Version, bevor der Klartext-Datenschlüssel erneut mit dem KMS-Schlüssel des Replikatgeheimnisses verschlüsselt wird.

Encrypt

Secrets Manager ruft die Verschlüsselungsoperation als Reaktion auf die folgenden Secrets-Manager-Operationen auf:

  • UpdateSecret — Wenn Sie den KMS-Schlüssel ändern, verschlüsselt Secrets Manager den Datenschlüssel erneut, der das schützt AWSCURRENT, AWSPREVIOUS, und AWSPENDING geheime Versionen mit dem neuen Schlüssel.

  • AssociateCrossAccountReplica — Secrets Manager führt einen Probelaufruf zur Verschlüsselung mit dem KMS-Schlüssel des Replikatgeheimnisses durch. Dieser Aufruf bestätigt, dass der primäre Kontoaufrufer berechtigt ist, den KMS-Schlüssel des Replikatgeheimnisses für die kontoübergreifende Replikation zu verwenden. Während der Replikation entschlüsselt Secrets Manager den Datenschlüssel der primären geheimen Version, bevor der Klartext-Datenschlüssel erneut mit dem KMS-Schlüssel des Replikatgeheimnisses verschlüsselt wird.

DescribeKey

Secrets Manager ruft den auf DescribeKey Vorgang, um zu bestimmen, ob das aufgelistet werden soll AWS KMS geben Sie die Taste ein, wenn Sie ein Geheimnis in der Secrets Manager-Konsole erstellen oder bearbeiten.

Validieren des Zugriffs auf den KMS-Schlüssel

Wenn Sie den einem Secret zugeordneten KMS-Schlüssel einrichten oder ändern, ruft Secrets Manager die Operationen GenerateDataKey und Decrypt mit dem angegebenen KMS-Schlüssel auf. Damit wird bestätigt, dass der Aufrufer über die Berechtigung zur Verwendung des KMS-Schlüssels für diese Operation verfügt. Secrets Manager verwirft die Ergebnisse dieser Operationen. Sie werden nicht für Entschlüsselungsoperationen verwendet.

Sie können diese Validierungsaufrufe daran erkennen, dass der SecretVersionIdWert des -Verschlüsselungskontexts in diesen Anforderungen RequestToValidateKeyAccess ist.

Anmerkung

Bisher enthielten Secrets-Manager-Validierungsaufrufe keinen Verschlüsselungskontext. Möglicherweise finden Sie Anrufe ohne Verschlüsselungskontext in älteren AWS CloudTrail protokolliert.

Wichtigste Politik der Von AWS verwalteter Schlüssel (aws/secretsmanager)

Die wichtigste Politik für die Von AWS verwalteter Schlüssel für Secrets Manager (aws/secretsmanager) gibt Benutzern nur dann die Erlaubnis, den KMS-Schlüssel für bestimmte Operationen zu verwenden, wenn Secrets Manager die Anfrage im Namen des Benutzers stellt. Die Schlüsselrichtlinie erlaubt es keinem Benutzer, den KMS-Schlüssel direkt zu verwenden.

Diese Schlüsselrichtlinie wird – wie die Richtlinien aller Von AWS verwaltete Schlüssel – vom Service eingerichtet. Sie können die Schlüsselrichtlinie nicht ändern, Sie können sie jedoch jederzeit anzeigen. Details dazu finden Sie unter Anzeigen einer Schlüsselrichtlinie.

Die Richtlinienanweisungen in der Schlüsselrichtlinie haben folgende Wirkungen:

  • Benutzer im Konto dürfen den KMS-Schlüssel für kryptografische Operationen nur verwenden, wenn die Anforderung von Secrets Manager in ihrem Namen ergeht. Der Bedingungsschlüssel kms:ViaService setzt diese Beschränkung durch.

  • Ermöglicht die AWS Konto zum Erstellen von IAM-Richtlinien, die es Benutzern ermöglichen, die wichtigsten Eigenschaften von KMS einzusehen und Zuschüsse zu widerrufen.

  • Secrets Manager verwendet zwar keine Erteilungen für den Zugriff auf KMS-Schlüssel, die Richtlinie ermöglicht es Secrets Manager jedoch, im Namen des Benutzers für den KMS-Schlüssel Erteilungen zu erstellen, und erlaubt es dem Konto, Erteilungen zu widerrufen, mit denen Secrets Manager den KMS-Schlüssel verwenden kann. Dies sind Standardelemente eines Richtliniendokuments für Von AWS verwalteter Schlüssel.

Das Folgende ist eine wichtige Richtlinie für ein Beispiel Von AWS verwalteter Schlüssel für Secrets Manager.

JSON
{ "Id": "auto-secretsmanager-2", "Version":"2012-10-17", "Statement": [ { "Sid": "Allow access through AWS Secrets Manager for all principals in the account that are authorized to use AWS Secrets Manager", "Effect": "Allow", "Principal": { "AWS": [ "*" ] }, "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:ReEncrypt*", "kms:CreateGrant", "kms:DescribeKey" ], "Resource": "*", "Condition": { "StringEquals": { "kms:CallerAccount": "111122223333", "kms:ViaService": "secretsmanager.us-west-2.amazonaws.com" } } }, { "Sid": "Allow access through AWS Secrets Manager for all principals in the account that are authorized to use AWS Secrets Manager", "Effect": "Allow", "Principal": { "AWS": [ "*" ] }, "Action": "kms:GenerateDataKey*", "Resource": "*", "Condition": { "StringEquals": { "kms:CallerAccount": "111122223333" }, "StringLike": { "kms:ViaService": "secretsmanager.us-west-2.amazonaws.com" } } }, { "Sid": "Allow direct access to key metadata to the account", "Effect": "Allow", "Principal": { "AWS": [ "arn:aws:iam::111122223333:root" ] }, "Action": [ "kms:Describe*", "kms:Get*", "kms:List*", "kms:RevokeGrant" ], "Resource": "*" } ] }

Verschlüsselungskontext für Secrets Manager

Ein Verschlüsselungskontext ist ein Satz von Schlüssel-Wert-Paaren, die beliebige, nicht geheime Daten enthalten. Wenn Sie einen Verschlüsselungskontext in eine Anforderung zur Datenverschlüsselung einbeziehen, AWS KMS bindet den Verschlüsselungskontext kryptografisch an die verschlüsselten Daten. Zur Entschlüsselung der Daten müssen Sie denselben Verschlüsselungskontext übergeben.

In seiner GenerateDataKey und Entschlüsseln Anfragen an AWS KMS, Secrets Manager verwendet einen Verschlüsselungskontext mit zwei Name-Wert-Paaren, die das Geheimnis und seine Version identifizieren, wie im folgenden Beispiel gezeigt. Die Namen variieren nicht. In Kombination unterscheiden sich die Verschlüsselungskontextwerte jedoch für jeden Geheimniswert.

"encryptionContext": { "SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:test-secret-a1b2c3", "SecretVersionId": "EXAMPLE1-90ab-cdef-fedc-ba987SECRET1" }

Sie können den Verschlüsselungskontext verwenden, um diese kryptografischen Vorgänge in Auditaufzeichnungen und Protokollen zu identifizieren, z. B. AWS CloudTrail und Amazon CloudWatch Protokolle und als Voraussetzung für die Autorisierung in Richtlinien und Zuschüssen.

Der Secrets-Manager-Verschlüsselungskontext besteht aus zwei Name-Wert-Paaren.

  • SecretARN – Das erste Name-Wert-Paar dient der Identifizierung des Secrets. Der Schlüssel lautet SecretARN. Der Wert ist der Amazon-Ressourcenname (ARN) des Geheimnisses.

    "SecretARN": "ARN of an Secrets Manager secret"

    Wenn der ARN des Geheimnisses beispielsweise arn:aws:secretsmanager:us-east-2:111122223333:secret:test-secret-a1b2c3 lautet, würde der Verschlüsselungskontext das folgende Paar beinhalten.

    "SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:test-secret-a1b2c3"
  • SecretVersionId — Das zweite Name-Wert-Paar identifiziert die Version des Geheimnisses. Der Schlüssel lautet SecretVersionId. Der Wert ist die Versions-ID.

    "SecretVersionId": "<version-id>"

    Wenn die Versions-ID des Geheimnisses beispielsweise EXAMPLE1-90ab-cdef-fedc-ba987SECRET1 lautet, würde der Verschlüsselungskontext das folgende Paar beinhalten.

    "SecretVersionId": "EXAMPLE1-90ab-cdef-fedc-ba987SECRET1"

Wenn Sie den KMS-Schlüssel für ein Geheimnis einrichten oder ändern, sendet Secrets Manager Folgendes GenerateDataKey und Entschlüsseln Anfragen an AWS KMS um zu überprüfen, ob der Anrufer berechtigt ist, den KMS-Schlüssel für diese Operationen zu verwenden. Die Antworten werden verworfen und nicht für den Geheimniswert verwendet.

In diesem Validierungsanfragen ist der Wert von SecretARN der tatsächliche ARN des Geheimnisses. Der Wert SecretVersionId ist jedoch RequestToValidateKeyAccess, wie im folgenden Beispielverschlüsselungskontext dargestellt. Mithilfe dieses speziellen Werts lassen sich Validierungsanfragen in Protokollen und Audit-Trails identifizieren.

"encryptionContext": { "SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:test-secret-a1b2c3", "SecretVersionId": "RequestToValidateKeyAccess" }
Anmerkung

Bisher enthielten Secrets-Manager-Validierungsanforderungen keinen Verschlüsselungskontext. Möglicherweise finden Sie Anrufe ohne Verschlüsselungskontext in älteren AWS CloudTrail protokolliert.

Überwachen Sie die Secrets Manager-Interaktion mit AWS KMS

Sie können verwenden AWS CloudTrail und Amazon CloudWatch Protokolle, um die Anfragen zu verfolgen, an die Secrets Manager sendet AWS KMS in Ihrem Namen. Weitere Informationen über das Überwachen der Verwendung von Secrets finden Sie unter AWS Secrets Manager Geheimnisse überwachen.

GenerateDataKey

Wenn Sie den geheimen Wert in einem Geheimnis erstellen oder ändern, sendet Secrets Manager eine GenerateDataKey Anfrage an AWS KMS das gibt den KMS-Schlüssel für das Geheimnis an.

Das Ereignis, das die GenerateDataKey-Operation aufzeichnet, ähnelt dem folgenden Beispielereignis. Die Anforderung wird durch secretsmanager.amazonaws.com aufgerufen. Die Parameter enthalten den Amazon-Ressourcennamen (ARN) des KMS-Schlüssels für das Secret, einen Schlüsselbezeichner, der einen 256-Bit-Schlüssel benötigt, und den Verschlüsselungskontext, der das Secret und dessen Version identifiziert.

{ "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AROAIGDTESTANDEXAMPLE:user01", "arn": "arn:aws:sts::111122223333:assumed-role/Admin/user01", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2018-05-31T23:23:41Z" } }, "invokedBy": "secretsmanager.amazonaws.com" }, "eventTime": "2018-05-31T23:23:41Z", "eventSource": "kms.amazonaws.com", "eventName": "GenerateDataKey", "awsRegion": "us-east-2", "sourceIPAddress": "secretsmanager.amazonaws.com", "userAgent": "secretsmanager.amazonaws.com", "requestParameters": { "keyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "keySpec": "AES_256", "encryptionContext": { "SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:test-secret-a1b2c3", "SecretVersionId": "EXAMPLE1-90ab-cdef-fedc-ba987SECRET1" } }, "responseElements": null, "requestID": "a7d4dd6f-6529-11e8-9881-67744a270888", "eventID": "af7476b6-62d7-42c2-bc02-5ce86c21ed36", "readOnly": true, "resources": [ { "ARN": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "accountId": "111122223333", "type": "AWS::KMS::Key" } ], "eventType": "AwsApiCall", "recipientAccountId": "111122223333" }
Decrypt

Wenn Sie den Geheimwert eines Geheimnisses abrufen oder ändern, sendet Secrets Manager eine Entschlüsseln Anfrage an AWS KMS um den verschlüsselten Datenschlüssel zu entschlüsseln. Bei Batch-Befehlen kann Secrets Manager den entschlüsselten Schlüssel wiederverwenden, sodass nicht alle Aufrufe zu einer Decrypt-Anforderung führen.

Das Ereignis, das die Decrypt-Operation aufzeichnet, ähnelt dem folgenden Beispielereignis. Der Benutzer ist der Prinzipal in Ihrem AWS Konto, das auf die Tabelle zugreift. Zu den Parametern gehören der verschlüsselte Tabellenschlüssel (als Chiffretext-Blob) und Verschlüsselungskontext das identifiziert die Tabelle und die AWS Konto. AWS KMS leitet die ID des KMS-Schlüssels aus dem Chiffretext ab.

{ "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AROAIGDTESTANDEXAMPLE:user01", "arn": "arn:aws:sts::111122223333:assumed-role/Admin/user01", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2018-05-31T23:36:09Z" } }, "invokedBy": "secretsmanager.amazonaws.com" }, "eventTime": "2018-05-31T23:36:09Z", "eventSource": "kms.amazonaws.com", "eventName": "Decrypt", "awsRegion": "us-east-2", "sourceIPAddress": "secretsmanager.amazonaws.com", "userAgent": "secretsmanager.amazonaws.com", "requestParameters": { "encryptionContext": { "SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:test-secret-a1b2c3", "SecretVersionId": "EXAMPLE1-90ab-cdef-fedc-ba987SECRET1" } }, "responseElements": null, "requestID": "658c6a08-652b-11e8-a6d4-ffee2046048a", "eventID": "f333ec5c-7fc1-46b1-b985-cbda13719611", "readOnly": true, "resources": [ { "ARN": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "accountId": "111122223333", "type": "AWS::KMS::Key" } ], "eventType": "AwsApiCall", "recipientAccountId": "111122223333" }
Encrypt

Wenn Sie das ändern AWS KMS Schlüssel, der einem Geheimnis zugeordnet ist, sendet Secrets Manager eine Verschlüsseln Anfrage an AWS KMS um das erneut zu verschlüsseln AWSCURRENT, AWSPREVIOUS, und AWSPENDING geheime Versionen mit dem neuen Schlüssel. Wenn Sie ein Secret in eine andere Region replizieren, sendet Secrets Manager außerdem eine Verschlüsselungsanfrage an  AWS KMS.

Das Ereignis, das die Encrypt-Operation aufzeichnet, ähnelt dem folgenden Beispielereignis. Der Benutzer ist der Prinzipal in Ihrem AWS Konto, das auf die Tabelle zugreift.

{ "eventVersion": "1.08", "userIdentity": { "type": "IAMUser", "principalId": "AROAIGDTESTANDEXAMPLE:user01", "arn": "arn:aws:sts::111122223333:assumed-role/Admin/user01", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "sessionContext": { "attributes": { "creationDate": "2023-06-09T18:11:34Z", "mfaAuthenticated": "false" } }, "invokedBy": "secretsmanager.amazonaws.com" }, "eventTime": "2023-06-09T18:11:34Z", "eventSource": "kms.amazonaws.com", "eventName": "Encrypt", "awsRegion": "us-east-2", "sourceIPAddress": "secretsmanager.amazonaws.com", "userAgent": "secretsmanager.amazonaws.com", "requestParameters": { "keyId": "arn:aws:kms:us-east-2:111122223333:key/EXAMPLE1-f1c8-4dce-8777-aa071ddefdcc", "encryptionAlgorithm": "SYMMETRIC_DEFAULT", "encryptionContext": { "SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:ChangeKeyTest-5yKnKS", "SecretVersionId": "EXAMPLE1-5c55-4d7c-9277-1b79a5e8bc50" } }, "responseElements": null, "requestID": "129bd54c-1975-4c00-9b03-f79f90e61d60", "eventID": "f7d9ff39-15ab-47d8-b94c-56586de4ab68", "readOnly": true, "resources": [ { "accountId": "AWS Internal", "type": "AWS::KMS::Key", "ARN": "arn:aws:kms:us-west-2:111122223333:key/EXAMPLE1-f1c8-4dce-8777-aa071ddefdcc" } ], "eventType": "AwsApiCall", "managementEvent": true, "recipientAccountId": "111122223333", "eventCategory": "Management" }

AWS KMS Schlüssel für die kontoübergreifende Replikation

Wenn Sie ein Geheimnis auf ein anderes replizieren AWS Konto, Sie müssen das Replikatgeheimnis mit einem vom Kunden verwalteten KMS-Schlüssel im Replikatkonto verschlüsseln. Das Replikatgeheimnis kann das nicht verwenden Von AWS verwalteter Schlüssel aws/secretsmanager, weil Von AWS verwaltete Schlüssel unterstützen keinen kontoübergreifenden Zugriff. Weitere Informationen zur kontoübergreifenden Replikation finden Sie unter Cross-account Replikation.

Damit Secrets Manager den geheimen Wert unter dem Replikatschlüssel erneut verschlüsseln kann, aktualisieren Sie den wichtige Richtlinie des Replikat-KMS-Schlüssels, sodass er das primäre Konto zum Aufrufen autorisiert kms:Encrypt. Secrets Manager entschlüsselt den geheimen Wert mit dem Schlüssel des primären Geheimnisses und verschlüsselt ihn erneut mit dem Replikatschlüssel.

Legen Sie optional den Geltungsbereich der Replikatschlüsselrichtlinie fest mit SecretArn-Verschlüsselungskontext sodass das primäre Konto den Replikatschlüssel nur für das Replikatgeheimnis verwenden kann. Der Wert für den Verschlüsselungskontext ist der ARN des Replikatgeheimnisses. Ein Beispiel für eine wichtige Grundsatzerklärung finden Sie unter Erstellen Sie ein Replikatgeheimnis.