

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.

# Mise à jour du chiffrement côté serveur pour les données existantes

Le chiffrement de tous les compartiments Amazon S3 est configuré par défaut, et les objets sont automatiquement chiffrés à l'aide d'un chiffrement côté serveur avec des clés gérées par Amazon S3 (). SSE-S3 Ce paramètre de chiffrement par défaut s'applique à tous les nouveaux objets de vos compartiments Amazon S3.

À l'aide de l'opération `UpdateObjectEncryption` API, vous pouvez mettre à jour automatiquement le type de chiffrement côté serveur d'un objet chiffré existant dans un compartiment à usage général, en passant du chiffrement côté serveur avec chiffrement géré par Amazon S3 (SSE-S3) au cryptage côté serveur avec AWS Key Management Service () clés de chiffrement ().AWS KMS SSE-KMS L'opération `UpdateObjectEncryption` d'API utilise le chiffrement [ d'](https://docs.aws.amazon.com/kms/latest/developerguide/kms-cryptography.html#enveloping)enveloppe pour rechiffrer la clé de données utilisée pour chiffrer et déchiffrer votre objet avec le type de cryptage côté serveur que vous venez de spécifier. 

Amazon S3 effectue cette mise à jour du type de chiffrement sans aucun mouvement de données. En d'autres termes, lorsque vous utilisez cette `UpdateObjectEncryption` opération, vos données ne sont pas copiées, les objets archivés dans S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive ne sont pas restaurés et les objets de la classe de Intelligent-Tiering stockage S3 ne sont pas déplacés entre les niveaux. En outre, l'`UpdateObjectEncryption`opération préserve toutes les propriétés des métadonnées de l'objet, notamment la classe de stockage, la date de création, la date de dernière modification, l'ETag et les propriétés de somme de contrôle.

L'`UpdateObjectEncryption`opération est prise en charge pour toutes les classes de stockage S3 prises en charge par des buckets à usage général. Vous pouvez utiliser cette `UpdateObjectEncryption` opération pour effectuer les opérations suivantes : 
+ Changez les objets chiffrés du chiffrement côté serveur avec le chiffrement géré par Amazon S3 (SSE-S3) au chiffrement côté serveur avec AWS Key Management Service (AWS KMS) clés de chiffrement (). SSE-KMS
+ Mettez à jour les objets SSE-KMS chiffrés au niveau de l'objet pour utiliser les clés de compartiment S3, ce qui permet de réduire le trafic de AWS KMS requêtes en provenance d'Amazon S3 vers. AWS KMS Pour de plus amples informations, veuillez consulter [Réduire les coûts SSE-KMS grâce à Amazon S3 Bucket Keys](bucket-key.md).
+ Modifiez la clé KMS gérée par le client qui est utilisée pour chiffrer vos données afin de vous conformer aux normes personnalisées de rotation des clés.

**Note**  
Les objets source non chiffrés ou chiffrés à l'aide d'un chiffrement double couche côté serveur avec AWS KMS keys (DSSE-KMS) ou de clés de chiffrement fournies par le client (SSE-C) ne sont pas pris en charge par cette opération.

L'`UpdateObjectEncryption`opération est généralement réalisée en quelques millisecondes, quelle que soit la taille de l'objet ou la classe de stockage, y compris S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive. Cette opération n'est pas considérée comme un accès pour S3 Intelligent-Tiering, de sorte que les objets du niveau Accès peu fréquent ou du niveau Archive Instant Access ne seront pas automatiquement replacés au niveau Frequent Access si vous modifiez le type de cryptage côté serveur de votre objet. 

`UpdateObjectEncryption`est une opération d'API au niveau de l'objet (plan de données) qui est enregistrée dans les journaux d'accès au serveur Amazon S3 et les événements de AWS CloudTrail données. Pour de plus amples informations, veuillez consulter [Options de journalisation pour Amazon S3](logging-with-S3.md). 

 L'`UpdateObjectEncryption`opération est facturée au même prix que les `LIST` requêtes `PUT``COPY`,`POST`, et (pour 1 000 demandes) et est toujours facturée comme une demande de classe de stockage S3 Standard, quelle que soit la classe de stockage de l'objet sous-jacent. Pour plus d’informations, consultez [Tarification Amazon S3](https://aws.amazon.com/s3/pricing/).

## Restrictions et considérations
<a name="update-sse-encryption-restrictions"></a>

Lors de l'utilisation de l'`UpdateObjectEncryption`opération, les restrictions et considérations suivantes s'appliquent :
+ L'`UpdateObjectEncryption`opération ne prend pas en charge les objets non chiffrés ni les objets chiffrés à l'aide d'un chiffrement double couche côté serveur avec AWS KMS keys (DSSE-KMS) ou de clés de chiffrement fournies par le client (). SSE-C En outre, vous ne pouvez pas spécifier le nouveau type de cryptage demandé SSE-S3 comme `UpdateObjectEncryption` demande.
+ Vous pouvez utiliser cette `UpdateObjectEncryption` opération pour mettre à jour des objets dans des compartiments pour lesquels la gestion des versions S3 est activée. Pour mettre à jour le type de cryptage d'une version particulière, vous devez spécifier un ID de version dans votre `UpdateObjectEncryption` demande. Si vous ne spécifiez pas l'ID de version, la `UpdateObjectEncryption` demande agit sur la version actuelle de l'objet. Pour plus d’informations sur la gestion des versions S3, consultez [Conservation de plusieurs versions d’objets grâce à la gestion des versions S3](Versioning.md).
+ L'`UpdateObjectEncryption`opération échoue sur tout objet auquel est appliqué un mode de rétention S3 Object Lock ou un blocage légal. Si un objet est soumis à une période de conservation en mode gouvernance ou à une suspension légale, vous devez d'abord supprimer le statut Object Lock sur l'objet avant d'émettre votre `UpdateObjectEncryption` demande. Vous ne pouvez pas utiliser cette `UpdateObjectEncryption` opération avec des objets auxquels est appliquée une période de rétention du mode de conformité Object Lock. Pour plus d'informations sur la fonctionnalité de verrouillage des objets S3, veuillez consulter [Verrouillage d’objets avec la fonctionnalité de verrouillage d’objet](object-lock.md).
+ `UpdateObjectEncryption`les requêtes sur les compartiments sources pour lesquels la réplication en direct est activée ne déclencheront pas d'événements de réplication dans le compartiment de destination. Si vous souhaitez modifier le type de chiffrement des objets dans vos compartiments source et de destination, vous devez lancer des `UpdateObjectEncryption` demandes distinctes sur les objets des compartiments source et de destination.
+ Par défaut, toutes les `UpdateObjectEncryption` demandes qui spécifient une clé KMS gérée par le client sont limitées aux clés KMS appartenant au propriétaire du bucket. Compte AWS Si vous utilisez AWS Organizations, vous pouvez demander la possibilité d'utiliser des comptes AWS KMS keys appartenant à d'autres membres de votre organisation en contactant AWS Support.
+ Si vous utilisez la réplication par lots S3 pour répliquer des ensembles de données entre régions et que le type de cryptage côté serveur de vos objets était précédemment mis à jour de SSE-S3 à SSE-KMS, vous pourriez avoir besoin d'autorisations supplémentaires. Sur le bucket de la région source, vous devez disposer `kms:decrypt` d'autorisations. Ensuite, vous aurez besoin des `kms:encrypt` autorisations `kms:decrypt` et pour le bucket dans la région de destination. 
+ Vous devez fournir un ARN de clé KMS complet dans votre `UpdateObjectEncryption` demande. Vous ne pouvez pas utiliser de nom d'alias ou d'alias ARN. Vous pouvez déterminer l'ARN complet de la clé KMS dans la console AWS KMS ou à l'aide de l'`DescribeKey`API AWS KMS.

## Autorisations requises
<a name="update-sse-encryption-permissions"></a>

Pour effectuer l'`UpdateObjectEncryption`opération, vous devez disposer des autorisations suivantes : 
+ `s3:UpdateObjectEncryption`
+ `kms:Encrypt`
+ `kms:Decrypt`
+ `kms:GenerateDataKey`
+ `kms:ReEncrypt*`

Si vous utilisez AWS Organizations, pour utiliser cette opération avec des clés KMS gérées par le client provenant d'autres membres de Comptes AWS votre organisation, vous devez disposer de l'`organizations:DescribeAccount`autorisation. Vous devez également demander la possibilité d'utiliser les comptes AWS KMS keys appartenant à d'autres membres de votre organisation en contactant AWS Support.

Pour effectuer l'`UpdateObjectEncryption`opération, ajoutez la politique Gestion des identités et des accès AWS (IAM) suivante à votre rôle IAM. Pour utiliser cette politique, `{{amzn-s3-demo-bucket}}` remplacez-la par le nom de votre compartiment à usage général et remplacez l'autre `{{user input placeholders}}` par vos propres informations.

```json
{
    "Version": "2012-10-17",		 	 	 
    "Statement": [{
            "Sid": "AllowUpdateObjectEncryption",
            "Effect": "Allow",
            "Action": [
                "s3:UpdateObjectEncryption",
                "kms:Encrypt",
                "kms:Decrypt",
                "kms:GenerateDataKey",
                "kms:ReEncrypt*",
                "organizations:DescribeAccount"
            ],
            "Resource": [
                "arn:aws:s3:::{{{{amzn-s3-demo-bucket}}}}",
                "arn:aws:s3:::{{{{amzn-s3-demo-bucket}}}}/*",
                "arn:aws:kms:{{us-east-1}}:{{111122223333}}:key/{{01234567-89ab-cdef-0123-456789abcdef}}"
            ]
        }
    ]
}
```

## Mise à jour groupée du chiffrement
<a name="update-sse-encryption-bulk"></a>

Pour mettre à jour le type de chiffrement côté serveur de plusieurs objets Amazon S3 avec une seule demande, vous pouvez utiliser S3 Batch Operations. Vous pouvez fournir à S3 Batch Operations une liste d'objets sur lesquels opérer, ou vous pouvez demander à Batch Operations de générer des métadonnées d'objet basées sur une liste d'objets, notamment le préfixe, la classe de stockage, la date de création, le type de cryptage, l'ARN de la clé KMS ou l'état de la clé de compartiment S3. La fonctionnalité des opérations par lot S3 appelle l’opération d’API respective pour effectuer l’opération spécifiée. Une seule tâche d'opérations par lots peut effectuer l'opération spécifiée sur des milliards d'objets au sein d'un compartiment contenant des pétaoctets de données. Pour en savoir plus sur les opérations par lots, veuillez consulter [Exécution d’opérations groupées sur des objets avec Batch Operations](batch-ops.md). 

La fonctionnalité d’opérations par lot S3 suit la progression, envoie des notifications et stocke un rapport de fin détaillé sur toutes les actions, offrant ainsi une expérience sans serveur entièrement gérée et qui peut être vérifiée. Vous pouvez utiliser S3 Batch Operations via la console Amazon S3, AWS les kits SDK AWS Command Line Interface (AWS CLI) ou l'API REST Amazon S3. Pour de plus amples informations, veuillez consulter [Mettre à jour le chiffrement des objets](batch-ops-update-encryption.md).

## Mise à jour du chiffrement des objets
<a name="update-sse-encryption-single-object"></a>

Vous pouvez mettre à jour le type de chiffrement côté serveur d'un objet via les AWS kits SDK AWS Command Line Interface (AWS CLI) ou l'API REST Amazon S3. 

### Mettre à jour le chiffrement d'un objet
<a name="update-sse-encryption-single-object-procedure"></a>

#### Utilisation de AWS CLI
<a name="update-sse-encryption-single-object-cli"></a>

Pour exécuter les commandes suivantes, vous devez les avoir AWS CLI installées et configurées. Si ce n'est pas déjà AWS CLI fait, voir [ Installer ou mettre à jour la dernière version AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) dans le Guide de l'*AWS Command Line Interface utilisateur*.

Vous pouvez également exécuter AWS CLI des commandes depuis la console en utilisant AWS CloudShell. AWS CloudShell est un shell pré-authentifié basé sur un navigateur que vous pouvez lancer directement depuis. Console de gestion AWS Pour plus d'informations, voir [ Qu'est-ce que c'est CloudShell ? ](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html)et [ Guide de démarrage AWS CloudShell](https://docs.aws.amazon.com/cloudshell/latest/userguide/getting-started.html) dans le Guide de *AWS CloudShell l'utilisateur*.

**Pour mettre à jour le chiffrement d'un objet à l'aide du AWS CLI**

Pour utiliser l’exemple de commande suivant, remplacez les `{{user input placeholders}}` par vos propres informations. 

1. Utilisez la commande suivante pour mettre à jour le chiffrement d'un seul objet (`{{index.html}}`) de votre compartiment à usage général (par exemple`{{amzn-s3-demo-bucket}}`) à utiliser SSE-KMS avec une clé de compartiment S3 :

   ```bash
   aws s3api update-object-encryption \
   --bucket {{amzn-s3-demo-bucket}} \
   --key {{index.html}} \
   --object-encryption '{"SSEKMS": { "KMSKeyArn": "arn:aws:kms:us-east-1:111122223333:key/f12a345a-678e-9bbb-1025-62e317037583", "BucketKeyEnabled": true }}'
   ```
**Note**  
Vous devez spécifier le nom de ressource AWS KMS key Amazon (ARN) complet. L'ID de clé KMS et l'alias de clé KMS ne sont pas pris en charge.

1. Exécutez la `head-object` commande pour afficher le type de cryptage mis à jour de votre objet :

   ```bash
   aws s3api head-object --bucket {{{{amzn-s3-demo-bucket}}}} --key {{index.html}}
   ```

#### Utilisation de l'API REST
<a name="update-sse-encryption-single-object-rest-api"></a>

Vous pouvez envoyer des requêtes REST pour mettre à jour le chiffrement d'un objet. Pour de plus amples informations, veuillez consulter [UpdateObjectEncryption](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateObjectEncryption.html).

#### Utilisation de AWS Kits SDK
<a name="update-sse-encryption-single-object-sdk"></a>

Vous pouvez utiliser les AWS kits SDK pour mettre à jour le chiffrement d'un objet. Pour plus d'informations, consultez la [ liste des SDK ](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateObjectEncryption.html#API_UpdateObjectEncryption_SeeAlso) pris en charge.

------
#### [ Java ]

**Example**  
L' AWS SDK for Java 2.x exemple suivant met à jour le type de cryptage SSE-KMS pour un objet dans un compartiment à usage général.  

```
    public void updateObjectEncryption(String bucketName,
                                       String objectKey,
                                       String versionId,
                                       String kmsKeyArn,
                                       boolean bucketKeyEnabled) {
        // Create the target object encryption type.
        ObjectEncryption objectEncryption = ObjectEncryption.builder()
                .ssekms(SSEKMSEncryption.builder()
                        .kmsKeyArn(kmsKeyArn)
                        .bucketKeyEnabled(bucketKeyEnabled)
                        .build())
                .build();

        // Create the UpdateObjectEncryption request.
        UpdateObjectEncryptionRequest request = UpdateObjectEncryptionRequest.builder()
                .bucket(bucketName)
                .key(objectKey)
                .versionId(versionId)
                .objectEncryption(objectEncryption)
                .build();

        // Update the object encryption.
        try {
            getS3Client().updateObjectEncryption(request);
            logger.info("Object encryption updated to SSE-KMS for {} in bucket {}", objectKey, bucketName);
        } catch (S3Exception e) {
            logger.error("Failed to update to object encryption: {} - Error code: {}", e.awsErrorDetails().errorMessage(),
                    e.awsErrorDetails().errorCode());
            throw e;
        }
    }
```

------
#### [ Python ]

**Example**  
L' AWS SDK pour Python (Boto3) exemple suivant montre comment mettre à jour le type de chiffrement SSE-KMS pour un objet dans un compartiment à usage général.   

```
response = client.update_object_encryption(
    Bucket='string',
    Key='string',
    VersionId='string',
    ObjectEncryption={
        'SSEKMS': {
                'KMSKeyArn': 'string',
                'BucketKeyEnabled': True|False
        }
    }
)
```

------