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.

Mit dem. NETclientseitige Verschlüsselungsbibliothek für DynamoDB

In diesem Thema werden einige der Funktionen und Hilfsklassen in Version 3 erklärt. x der. NETclientseitige Verschlüsselungsbibliothek für DynamoDB.

Einzelheiten zur Programmierung mit dem. NETClientseitige Verschlüsselungsbibliothek für DynamoDB, siehe. NETBeispiele finden Sie im -dynamodb-Repository unter aws-database-encryption-sdk. GitHub

Elementverschlüssler

Im Kern ist AWS Database Encryption SDK for DynamoDB ein Elementverschlüsseler. Sie können Version 3 verwenden. x der. NETclientseitige Verschlüsselungsbibliothek für DynamoDB zum Verschlüsseln, Signieren, Überprüfen und Entschlüsseln Ihrer DynamoDB-Tabellenelemente auf folgende Weise.

Attributaktionen in der AWS Datenbankverschlüsselung SDK für DynamoDB

Attributaktionen bestimmen, welche Attributwerte verschlüsselt und signiert werden, welche nur signiert sind, welche signiert und in den Verschlüsselungskontext aufgenommen werden und welche ignoriert werden.

Um Attributaktionen mit dem zu spezifizieren. NETClient, definieren Sie Attributaktionen manuell mithilfe eines Objektmodells. Geben Sie Ihre Attributaktionen an, indem Sie ein Dictionary Objekt erstellen, in dem die Name-Wert-Paare für Attributnamen und die angegebenen Aktionen stehen.

Geben Sie ENCRYPT_AND_SIGN an, dass ein Attribut verschlüsselt und signiert werden soll. Geben Sie SIGN_ONLY an, dass ein Attribut signiert, aber nicht verschlüsselt werden soll. Geben Sie SIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXT an, dass ein Attribut signiert und in den Verschlüsselungskontext aufgenommen werden soll. Sie können ein Attribut nicht verschlüsseln, ohne es auch zu signieren. Geben Sie DO_NOTHING an, ob ein Attribut ignoriert werden soll.

Die Partitions- und Sortierattribute müssen entweder SIGN_ONLY oder lautenSIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXT. Wenn Sie Attribute als definierenSIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXT, müssen dies auch die Partitions- und Sortierattribute seinSIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXT.

Das folgende Objektmodell zeigt, wie SieENCRYPT_AND_SIGN, SIGN_ONLYSIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXT, und DO_NOTHING Attributaktionen mit dem angeben. NETKunde. In diesem Beispiel wird das Präfix ":" verwendet, um DO_NOTHING Attribute zu identifizieren.

var attributeActionsOnEncrypt = new Dictionary<string, CryptoAction>
{
    ["partition_key"] = CryptoAction.SIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXT, // The partition attribute must be signed
    ["sort_key"] = CryptoAction.SIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXT, // The sort attribute must be signed
    ["attribute1"] = CryptoAction.ENCRYPT_AND_SIGN,
    ["attribute2"] = CryptoAction.SIGN_ONLY,
    ["attribute3"] = CryptoAction.SIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXT,
    [":attribute4"] = CryptoAction.DO_NOTHING
};

Verschlüsselungskonfiguration in AWS Database Encryption SDK for DynamoDB

Wenn Sie AWS Database Encryption verwendenSDK, müssen Sie explizit eine Verschlüsselungskonfiguration für Ihre DynamoDB-Tabelle definieren. Die in Ihrer Verschlüsselungskonfiguration erforderlichen Werte hängen davon ab, ob Sie Ihre Attributaktionen manuell oder mit einer annotierten Datenklasse definiert haben.

Der folgende Ausschnitt definiert eine DynamoDB-Tabellenverschlüsselungskonfiguration unter Verwendung der AWS Low-Level-Datenbankverschlüsselung SDK für DynamoDB API und zulässige unsignierte Attribute, die durch ein eindeutiges Präfix definiert sind.

Dictionary<String, DynamoDbTableEncryptionConfig> tableConfigs =
    new Dictionary<String, DynamoDbTableEncryptionConfig>();
DynamoDbTableEncryptionConfig config = new DynamoDbTableEncryptionConfig
{
    LogicalTableName = ddbTableName,
    PartitionKeyName = "partition_key",
    SortKeyName = "sort_key",
    AttributeActionsOnEncrypt = attributeActionsOnEncrypt,
    Keyring = kmsKeyring,
    AllowedUnsignedAttributePrefix = unsignAttrPrefix,
    // Optional: SearchConfig only required if you use beacons
    Search = new SearchConfig
    {
        WriteVersion = 1, // MUST be 1
        Versions = beaconVersions
    }    
};
tableConfigs.Add(ddbTableName, config);

Elemente mit der Datenbankverschlüsselung AWS aktualisieren SDK

Die AWS Datenbankverschlüsselung SDK unterstützt ddb: nicht UpdateItem für Elemente, die verschlüsselte oder signierte Attribute enthalten. Um ein verschlüsseltes oder signiertes Attribut zu aktualisieren, müssen Sie ddb: verwenden. PutItem Wenn Sie in Ihrer PutItem Anfrage denselben Primärschlüssel wie ein vorhandenes Element angeben, ersetzt das neue Element das vorhandene Element vollständig. Sie können ihn auch verwenden CLOBBER, um alle Attribute beim Speichern zu löschen und zu ersetzen, nachdem Sie Ihre Artikel aktualisiert haben.