跳到主要内容
版本:6.1.1

Couchbase 字段级加密

Doubao 中英对照 Couchbase Field Level Encrytpion

Couchbase 支持字段级加密。本节介绍如何在 Spring Data Couchbase 中使用它。

要求​

  • Spring Data Couchbase 5.0.0-RC1 或更高版本。

概述​

使用 com.couchbase.client.java.encryption.annotation.Encrypted(@Encrypted)注解的字段,会在写入时自动加密、读取时自动解密。未加密的字段可以通过指定 @Encrypted(migration = Encrypted.Migration.FROM_UNENCRYPTED) 迁移为加密字段。

入门与配置​

依赖​

字段级加密通过以下依赖提供(参见字段级加密)

<groupId>com.couchbase.client</groupId>
<artifactId>couchbase-encryption</artifactId>

HashiCorp Vault Transit 集成需要 Spring Vault

<groupId>org.springframework.vault</groupId>
<artifactId>spring-vault-core</artifactId>

提供 CryptoManager​

需要通过覆盖 AbstractCouchbaseConfiguration 中的 cryptoManager() 方法来提供一个 CryptoManager。该 CryptoManager 既会被 Spring Data Couchbase 使用,也会被从 CouchbaseClientFactory 发起的 Couchbase Java SDK 直接调用使用。

@Override
protected CryptoManager cryptoManager() {
KeyStore javaKeyStore = KeyStore.getInstance("MyKeyStoreType");
FileInputStream fis = new java.io.FileInputStream("keyStoreName");
char[] password = { 'a', 'b', 'c' };
javaKeyStore.load(fis, password);
Keyring keyring = new KeyStoreKeyring(javaKeyStore, keyName -> "swordfish");

// AES-256 authenticated with HMAC SHA-512. Requires a 64-byte key.
AeadAes256CbcHmacSha512Provider provider = AeadAes256CbcHmacSha512Provider.builder().keyring(keyring).build();

CryptoManager cryptoManager = DefaultCryptoManager.builder().decrypter(provider.decrypter())
.defaultEncrypter(provider.encrypterForKey("myKey")).build();
return cryptoManager;
}

将字段定义为加密。​

  1. @Encrypted 将字段定义为加密字段。

  2. @Encrypted(migration = Encrypted.Migration.FROM_UNENCRYPTED) 定义一个在读取时可能已加密也可能未加密的字段。写入时会对其加密。

  3. @Encrypted(encrypter = "<encrypterAlias>") 指定用于加密的加密器别名。请注意这不是算法,而是将加密器添加到 CryptoManager 时指定的名称。

示例​

示例 1. AbstractCouchbaseConfiguration

@Configuration
@EnableCouchbaseRepositories("<parent-dir-of-repository-interfaces>")
@EnableReactiveCouchbaseRepositories("<parent-dir-of-repository-interfaces>")
static class Config extends AbstractCouchbaseConfiguration {

// Usual Setup
@Override public String getConnectionString() { /* ... */ }
@Override public String getUserName() { /* ... */ }
@Override public String getPassword() { /* ... */ }
@Override public String getBucketName() { /* ... */ }

/* provide a cryptoManager */
@Override
protected CryptoManager cryptoManager() {
KeyStore javaKeyStore = KeyStore.getInstance("MyKeyStoreType");
FileInputStream fis = new java.io.FileInputStream("keyStoreName");
char[] password = { 'a', 'b', 'c' };
javaKeyStore.load(fis, password);
Keyring keyring = new KeyStoreKeyring(javaKeyStore, keyName -> "swordfish");

// AES-256 authenticated with HMAC SHA-512. Requires a 64-byte key.
AeadAes256CbcHmacSha512Provider provider = AeadAes256CbcHmacSha512Provider.builder().keyring(keyring).build();

CryptoManager cryptoManager = DefaultCryptoManager.builder().decrypter(provider.decrypter())
.defaultEncrypter(provider.encrypterForKey("myKey")).build();
return cryptoManager;
}

}

示例 2. 文档中的注解

@Document
public class AddressWithEncStreet extends Address {

private @Encrypted String encStreet;
.
.

示例 3. 代码中的用法

AddressWithEncStreet address = new AddressWithEncStreet(); // plaintext address with encrypted street
address.setCity("Santa Clara");
address.setEncStreet("Olcott Street");
addressEncryptedRepository.save(address);

示例 4. 生成的文档

{
"_class": "AddressWithEncStreet",
"city": "Santa Clara",
"encrypted$encStreet": {
"alg": "AEAD_AES_256_CBC_HMAC_SHA512",
"ciphertext": "A/tJALmtixTxqj77ZUcUgMklIt3372DKD7l5FvbCzHNJMplbgQEv0RgSbxIfiRNr+uW2H7cokkcCW/F5YnQoXA==",
"kid": "myKey"
}
}