View a markdown version of this page

Gestion des tables chiffrées dans DynamoDB - Amazon DynamoDB

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.

Gestion des tables chiffrées dans DynamoDB

Vous pouvez utiliser le Console de gestion AWS ou le AWS Command Line Interface (AWS CLI) pour spécifier la clé de chiffrement sur les nouvelles tables et mettre à jour les clés de chiffrement sur les tables existantes dans Amazon DynamoDB.

Définition de la clé de chiffrement pour une nouvelle table

Suivez ces étapes pour spécifier la clé de chiffrement sur une nouvelle table à l’aide de la console Amazon DynamoDB ou de l’ AWS CLI.

Création d’une table chiffrée (console)

  1. Connectez-vous au Console de gestion AWS et ouvrez la console DynamoDB à l'adresse https://console.aws.amazon.com/dynamodb/.

  2. Dans le volet de navigation sur le côté gauche de la console, choisissez Tables.

  3. Choisissez Créer une table. Comme Nom de la table, entrez Music. Pour la clé principale, saisissezArtist, puis, pour la clé de tri, saisissezSongTitle, ces deux valeurs devant être sous forme de chaîne.

  4. Dans Settings (Paramètres), assurez-vous que l’option Customize settings (Personnaliser les paramètres) est sélectionnée.

    Note

    Si Utiliser les paramètres par défaut est sélectionné, les tables sont chiffrées au repos avec le Clé détenue par AWS sans frais supplémentaires.

  5. En dessous Chiffrement au repos, choisissez un type de cryptage - Clé détenue par AWS, Clé gérée par AWS, ou clé gérée par le client.

    • Appartenant à Amazon DynamoDB. AWS clé détenue, spécifiquement détenue et gérée par DynamoDB. Aucun frais supplémentaire ne vous est facturé pour l’utilisation de cette clé.

    • AWS clé gérée. alias de clé (aws/dynamodb). La clé est stockée dans votre compte et est gérée par AWS Key Management Service (AWS KMS). AWS KMS des frais s'appliquent.

    • Stockée dans votre compte, et vous en êtes le propriétaire et le gestionnaire. Clé gérée par le client. La clé est stockée dans votre compte et est gérée par AWS Key Management Service (AWS KMS). AWS KMS des frais s'appliquent.

      Note

      Si vous choisissez de posséder et de gérer votre propre clé, assurez-vous que la politique des clés de KMS est correctement définie. Pour plus d’informations, consultez la politique relative aux clés gérées par le client.

  6. Choisissez Create table (Créer une table) pour créer la table chiffrée. Pour confirmer le type de chiffrement, sélectionnez les détails de la table dans l’onglet Overview (Vue d’ensemble) et examinez la section Additional details (Détails supplémentaires).

Création d'une table chiffrée (AWS CLI)

Utilisez le AWS CLI pour créer un tableau avec la valeur par défaut Clé détenue par AWS, le Clé gérée par AWS, ou une clé gérée par le client pour Amazon DynamoDB.

Pour créer une table chiffrée avec la valeur par défaut Clé détenue par AWS
  • Créez la table chiffrée Music comme suit :

    aws dynamodb create-table \ --table-name Music \ --attribute-definitions \ AttributeName=Artist,AttributeType=S \ AttributeName=SongTitle,AttributeType=S \ --key-schema \ AttributeName=Artist,KeyType=HASH \ AttributeName=SongTitle,KeyType=RANGE \ --provisioned-throughput \ ReadCapacityUnits=10,WriteCapacityUnits=5
    Note

    Cette table est désormais chiffrée à l'aide de la valeur par défaut Clé détenue par AWS dans le compte de service DynamoDB.

Pour créer une table chiffrée avec Clé gérée par AWS pour DynamoDB
  • Créez la table chiffrée Music comme suit :

    aws dynamodb create-table \ --table-name Music \ --attribute-definitions \ AttributeName=Artist,AttributeType=S \ AttributeName=SongTitle,AttributeType=S \ --key-schema \ AttributeName=Artist,KeyType=HASH \ AttributeName=SongTitle,KeyType=RANGE \ --provisioned-throughput \ ReadCapacityUnits=10,WriteCapacityUnits=5 \ --sse-specification Enabled=true,SSEType=KMS

    Le statut SSEDescription de la description de la table est défini sur ENABLED et le SSEType est KMS.

    "SSEDescription": { "SSEType": "KMS", "Status": "ENABLED", "KMSMasterKeyArn": "arn:aws:kms:us-east-1:123456789012:key/abcd1234-abcd-1234-a123-ab1234a1b234", }
Pour créer une table chiffrée avec une clé gérée par le client pour DynamoDB
  • Créez la table chiffrée Music comme suit :

    aws dynamodb create-table \ --table-name Music \ --attribute-definitions \ AttributeName=Artist,AttributeType=S \ AttributeName=SongTitle,AttributeType=S \ --key-schema \ AttributeName=Artist,KeyType=HASH \ AttributeName=SongTitle,KeyType=RANGE \ --provisioned-throughput \ ReadCapacityUnits=10,WriteCapacityUnits=5 \ --sse-specification Enabled=true,SSEType=KMS,KMSMasterKeyId=abcd1234-abcd-1234-a123-ab1234a1b234
    Note

    Pour le KMSMasterKeyId, vous pouvez utiliser un ID de clé, un ARN de clé ou un alias de clé. Si vous utilisez un alias de clé (par exemple, alias/my-key), DynamoDB résout l'alias et associe le sous-jacent AWS KMS clé avec la table. Dans la description du tableau, KMSMasterKeyArn affichera toujours l'ARN de la clé résolue, pas l'alias. Pour plus d'informations sur les identificateurs de clé, voir Identifiants clés (KeyId) dans le AWS Key Management Service Guide du développeur.

    Le statut SSEDescription de la description de la table est défini sur ENABLED et le SSEType est KMS.

    "SSEDescription": { "SSEType": "KMS", "Status": "ENABLED", "KMSMasterKeyArn": "arn:aws:kms:us-east-1:123456789012:key/abcd1234-abcd-1234-a123-ab1234a1b234", }

Mise à jour d’une clé de chiffrement

Vous pouvez également utiliser la console DynamoDB ou AWS CLI pour mettre à jour les clés de chiffrement d'une table existante entre Clé détenue par AWS, Clé gérée par AWS, et une clé gérée par le client à tout moment.

Mise à jour d’une clé de chiffrement (console)

  1. Connectez-vous au Console de gestion AWS et ouvrez la console DynamoDB à l'adresse https://console.aws.amazon.com/dynamodb/.

  2. Dans le volet de navigation sur le côté gauche de la console, choisissez Tables.

  3. Choisissez la table que vous voulez mettre à jour.

  4. Sélectionnez la liste déroulante Actions, puis l’option Update settings (Mettre à jour les paramètres ).

  5. Accédez à l’onglet Additional settings (Paramètres supplémentaires).

  6. Sous Encryption (Chiffrement), choisissez Manage encryption (Gérer le chiffrement).

  7. Choisissez un type de chiffrement :

    • Détenue par Amazon DynamoDB. Le AWS KMS La clé est détenue et gérée par DynamoDB. Aucun frais supplémentaire ne vous est facturé pour l’utilisation de cette clé.

    • AWS clé gérée Alias clé : aws/dynamodb. La clé est stockée dans votre compte et est gérée par AWS Key Management Service. (AWS KMS). AWS KMS des frais s'appliquent.

    • Stockée dans votre compte, et vous en êtes le propriétaire et le gestionnaire. La clé est stockée dans votre compte et est gérée par AWS Key Management Service. (AWS KMS). AWS KMS des frais s'appliquent.

      Note

      Si vous choisissez de posséder et de gérer votre propre clé, assurez-vous que la politique des clés de KMS est correctement définie. Pour plus d’informations, consultez Politique de clé pour une clé gérée par le client.

    Choisissez ensuite Enregistrer pour mettre à jour la table chiffrée. Pour vérifier le type de chiffrement, consultez les détails de la table sous l’onglet Présentation.

Mettre à jour une clé de chiffrement (AWS CLI)

Les exemples suivants illustrent comment mettre à jour une table chiffrée à l’aide de l’ AWS CLI.

Pour mettre à jour une table chiffrée avec la valeur par défaut Clé détenue par AWS
  • Mettez à jour la table Music chiffrée, comme dans l’exemple suivant.

    aws dynamodb update-table \ --table-name Music \ --sse-specification Enabled=false
    Note

    Cette table est désormais chiffrée à l'aide de la valeur par défaut Clé détenue par AWS dans le compte de service DynamoDB.

Pour mettre à jour une table chiffrée avec Clé gérée par AWS pour DynamoDB
  • Mettez à jour la table Music chiffrée, comme dans l’exemple suivant.

    aws dynamodb update-table \ --table-name Music \ --sse-specification Enabled=true

    Le statut SSEDescription de la description de la table est défini sur ENABLED et le SSEType est KMS.

    "SSEDescription": { "SSEType": "KMS", "Status": "ENABLED", "KMSMasterKeyArn": "arn:aws:kms:us-east-1:123456789012:key/abcd1234-abcd-1234-a123-ab1234a1b234", }
Pour mettre à jour une table chiffrée avec une clé gérée par le client pour DynamoDB
  • Mettez à jour la table Music chiffrée, comme dans l’exemple suivant.

    aws dynamodb update-table \ --table-name Music \ --sse-specification Enabled=true,SSEType=KMS,KMSMasterKeyId=abcd1234-abcd-1234-a123-ab1234a1b234
    Note

    Pour le KMSMasterKeyId, vous pouvez utiliser un ID de clé, un ARN de clé ou un alias de clé. Si vous utilisez un alias de clé (par exemple, alias/my-key), DynamoDB résout l'alias et associe le sous-jacent AWS KMS clé avec la table. Dans la description du tableau, KMSMasterKeyArn affichera toujours l'ARN de la clé résolue, pas l'alias.

    Le statut SSEDescription de la description de la table est défini sur ENABLED et le SSEType est KMS.

    "SSEDescription": { "SSEType": "KMS", "Status": "ENABLED", "KMSMasterKeyArn": "arn:aws:kms:us-east-1:123456789012:key/abcd1234-abcd-1234-a123-ab1234a1b234", }