Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

En utilisant le. NETbibliothèque de chiffrement côté client pour DynamoDB

Cette rubrique décrit certaines des fonctions et classes d'assistance de la version 3. x du. NETbibliothèque de chiffrement côté client pour DynamoDB.

Pour plus de détails sur la programmation avec. NETbibliothèque de chiffrement côté client pour DynamoDB, consultez le. NETexemples dans le référentiel aws-database-encryption-sdk -dynamodb sur. GitHub

Chiffreurs d'éléments

À la base, le chiffrement de AWS base de données SDK pour DynamoDB est un crypteur d'éléments. Vous pouvez utiliser la version 3. x du. NETbibliothèque de chiffrement côté client permettant à DynamoDB de chiffrer, de signer, de vérifier et de déchiffrer les éléments de votre table DynamoDB de la manière suivante.

Actions d'attribut dans le chiffrement de AWS base de données SDK pour DynamoDB

Les actions d'attribut déterminent quelles valeurs d'attribut sont cryptées et signées, lesquelles sont uniquement signées, lesquelles sont signées et incluses dans le contexte de chiffrement, et lesquelles sont ignorées.

Pour spécifier des actions attributaires à l'aide du. NETclient, définissez manuellement les actions attributaires à l'aide d'un modèle d'objet. Spécifiez vos actions d'attribut en créant un Dictionary objet dans lequel les paires nom-valeur représentent les noms d'attributs et les actions spécifiées.

Spécifiez ENCRYPT_AND_SIGN le chiffrement et la signature d'un attribut. Spécifiez SIGN_ONLY pour signer un attribut, mais pas pour le chiffrer. Spécifiez SIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXT de signer un attribut et de l'inclure dans le contexte de chiffrement. Vous ne pouvez pas chiffrer un attribut sans le signer également. Spécifiez DO_NOTHING pour ignorer un attribut.

Les attributs de partition et de tri doivent être SIGN_ONLY soitSIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXT. Si vous définissez des attributs commeSIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXT, les attributs de partition et de tri doivent également l'êtreSIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXT.

Le modèle d'objet suivant montre comment spécifierENCRYPT_AND_SIGN, SIGN_ONLYSIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXT, et DO_NOTHING attribuer des actions avec le. NETclient. Cet exemple utilise le préfixe « : » pour identifier les DO_NOTHING attributs.

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
};

Configuration du chiffrement dans le chiffrement de AWS base de données SDK pour DynamoDB

Lorsque vous utilisez le chiffrement AWS de base de donnéesSDK, vous devez définir explicitement une configuration de chiffrement pour votre table DynamoDB. Les valeurs requises dans votre configuration de chiffrement varient selon que vous avez défini vos actions attributaires manuellement ou à l'aide d'une classe de données annotée.

L'extrait suivant définit une configuration de chiffrement de table DynamoDB utilisant le chiffrement de base de données de bas niveau pour SDK DynamoDB et des attributs AWS non signés autorisés définis par un préfixe distinctAPI.

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);

Mettre à jour des éléments avec le chiffrement AWS de base de données SDK

Le chiffrement AWS de base de données SDK ne prend pas en charge ddb : UpdateItem pour les éléments qui incluent des attributs chiffrés ou signés. Pour mettre à jour un attribut chiffré ou signé, vous devez utiliser ddb : PutItem. Lorsque vous spécifiez la même clé primaire qu'un élément existant dans votre PutItem demande, le nouvel article remplace complètement l'élément existant. Vous pouvez également l'utiliser CLOBBERpour effacer et remplacer tous les attributs lors de la sauvegarde après avoir mis à jour vos articles.