How to manage the server-side encryption configurations of a bucket by running the bucket-encryption command - Object Storage Service: Central de Documentação do Alibaba Cloud

Após configurar a criptografia no lado do servidor (criptografia de bucket), o Object Storage Service (OSS) criptografa os objetos enviados e armazena permanentemente os objetos criptografados. Ao baixar objetos, o OSS descriptografa os objetos e retorna os objetos descriptografados. Este tópico descreve como executar o comando bucket-encryption para adicionar, modifique, consultar ou exclua as configurações de criptografia no lado do servidor de um bucket.

Observações de uso

Para adicionar ou modifique as configurações de criptografia no lado do servidor de um bucket, você deve ter a permissão oss:PutBucketEncryption. Para consultar as configurações de criptografia no lado do servidor de um bucket, você deve ter a permissão oss:GetBucketEncryption. Para exclua as configurações de criptografia no lado do servidor de um bucket, você deve ter a permissão oss:DeleteBucketEncryption. Para obter mais informações, consulte Grant a custom policy.

No ossutil 1.6.16 e versões posteriores, use diretamente ossutil como nome do binário na linha de comando. Não é necessário atualize o nome do binário com base no sistema operacional. Em versões do ossutil anteriores à 1.6.16, atualize o nome do binário de acordo com o sistema operacional. Para obter mais informações, consulte ossutil command reference.

Para obter mais informações sobre criptografia no lado do servidor, consulte Server-side encryption.

Adicionar ou modifique as configurações de criptografia no lado do servidor de um bucket

Sintaxe do comando

ossutil bucket-encryption --method put oss://bucketName --sse-algorithm algorithmName
[--kms-masterkey-id keyid]

A tabela a seguir descreve os parâmetros anteriores.

Parâmetro	Descrição
bucketName	Nome do bucket para o qual você deseja configure a criptografia no lado do servidor.
--sse-algorithm	Método de criptografia do bucket. Valores válidos: KMS: As chaves gerenciadas pelo Key Management Service (KMS) são usadas para criptografia e descriptografia (SSE-KMS). AES256: As chaves gerenciadas pelo OSS são usadas para criptografia e descriptografia (SSE-OSS).
--kms-masterkey-id	ID da chave mestra do cliente (CMK) gerenciada pelo KMS usada para criptografar objetos quando o método de criptografia está definido como SSE-KMS. Se você não especifique este parâmetro, a CMK padrão será usada para criptografar objetos. Para usar uma CMK específica, utilize este parâmetro para configure o ID da CMK. Nota Se você usar o OSS no CloudBox, este parâmetro não será suportado.

Exemplos
- execute o seguinte comando para defina o método de criptografia como SSE-OSS e o algoritmo de criptografia como AES256 para examplebucket:
```
ossutil bucket-encryption --method put oss://examplebucket --sse-algorithm AES256
```
- execute o seguinte comando para defina o método de criptografia como SSE-KMS, especifique um ID de CMK e usar o algoritmo de criptografia padrão AES256 para examplebucket:
```
ossutil bucket-encryption --method put oss://examplebucket --sse-algorithm KMS --kms-masterkey-id 9468da86-3509-4f8d-a61e-6eab1eac****
```
- Se a saída a seguir for exibida, a criptografia no lado do servidor foi configurada para examplebucket:
```
0.856895(s) elapsed
```
Para verifique se as configurações entraram em vigor, consulte as configurações de criptografia no lado do servidor de examplebucket.

Consultar as configurações de criptografia no lado do servidor de um bucket

Sintaxe do comando

ossutil bucket-encryption --method get oss://bucketName

Exemplos

execute o seguinte comando para consultar as configurações de criptografia no lado do servidor de examplebucket:
```
ossutil bucket-encryption --method get oss://examplebucket
```
Se a saída a seguir for exibida, o método de criptografia no lado do servidor configurado para examplebucket é SSE-KMS, o ID da CMK não está especificado e o algoritmo de criptografia padrão AES256 está em uso:
```
SSEAlgorithm:KMS
KMSMasterKeyID:
KMSDataEncryption:
```

exclua as configurações de criptografia no lado do servidor de um bucket

Sintaxe do comando

ossutil bucket-encryption --method delete oss://bucketName

Exemplos

execute o seguinte comando para exclua as configurações de criptografia no lado do servidor de examplebucket:
```
ossutil bucket-encryption --method delete oss://examplebucket
```
Se a saída a seguir for exibida, as configurações de criptografia no lado do servidor de examplebucket foram excluídas:
```
0.856686(s) elapsed
```

Opções comuns

Para acessar um bucket em uma região diferente, use -e para especifique o endpoint. Para acessar um bucket pertencente a uma conta Alibaba Cloud diferente, use -i para o AccessKey ID e -k para o AccessKey secret.

Por exemplo, execute o seguinte comando para defina o método de criptografia como AES256 para um bucket chamado examplebucket, localizado na região China (Hangzhou) e pertencente a outra conta Alibaba Cloud:

ossutil bucket-encryption --method put oss://examplebucket --sse-algorithm AES256 -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Para obter a lista completa de opções comuns, consulte o tópico a seguir.

Common options.