ApsaraDB RDS:EncJDBC

Ana şifreleme anahtarı (MEK) yapılandırıldığında EncJDBC, şifreli metni otomatik olarak çözer ve açık metni döndürür. Bu süreç uygulamanız için şeffaftır. Yalnızca birkaç satırlık yapılandırma ile şifreli veritabanına bağlanabilir ve şifreli veritabanı özelliğini kullanmanın maliyetini düşürebilirsiniz.

Önkoşullar

• Şifreli veritabanı özelliğini etkinleştirdiniz. Daha fazla bilgi için bkz. Şifreli veritabanı özelliğini etkinleştirme.

• Ana makine adı, bağlantı noktası, veritabanı adı, kullanıcı adı ve parola gibi veritabanı bağlantı bilgilerini edindiniz.

• Bir veri koruma kuralı yapılandırdınız. Daha fazla bilgi için bkz. SQL kullanarak sütun şifreleme kurallarını yapılandırma.

Kullanım notları

• Ana şifreleme anahtarınızı (MEK) güvenli bir şekilde saklayın.

• JDK 1.8 veya sonraki bir sürümü kullanın.

  Not

  Bu konudaki örnekler Maven 3.9.2 ve IntelliJ IDEA Community Edition 2022.3.2 kullanır.

Adım 1: Maven bağımlılığını ekleyin

Maven projenizdeki pom.xml dosyasına aşağıdaki bağımlılıkları eklemeniz gerekir.

<dependencies>
  <dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-encdb-mysql-jdbc</artifactId>
    <version>1.0.9-1</version>
  </dependency>
</dependencies>

Adım 2: İstemciyi yapılandırın ve verileri sorgulayın

EncJDBC öğesini diğer JDBC sürücüleri gibi kullanabilirsiniz. Ancak öncelikle MEK (ana şifreleme anahtarı) ve ENC_ALGO (şifreleme algoritması) gibi güvenlik açısından kritik parametreleri yapılandırmanız gerekir.

Aşağıdaki tabloda parametreler ve örnek değerler açıklanmaktadır.

// Prepare the connection details, such as hostname, port, database name, username, and password.
// ...
String mek=...;
String encAlgo=...;
Properties props = new Properties();
props.setProperty("user", username);
props.setProperty("password", password);
props.setProperty("MEK", mek);
props.setProperty("ENC_ALGO", encAlgo);
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s", hostname, port, dbname);
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");
Connection connection = DriverManager.getConnection(dbUrl, props);
// ... Initiate a query ...

MEK=
ENC_ALGO=

// Prepare the connection details, such as hostname, port, database name, username, and password.
// ...
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s", hostname, port, dbname);
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");
Connection connection = DriverManager.getConnection(dbUrl, username, password);
// ... Initiate a query ...

// Prepare the connection details, such as hostname, port, database name, username, and password.
// ...
String mek=...;
String encAlgo=...;
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s?MEK=%s&ENC_ALGO=%s", hostname, port, dbname, mek, encAlgo);
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");
Connection connection = DriverManager.getConnection(dbUrl, username, password);
// ... Initiate a query ...

// Replace hostname, port, dbname, username, and password with your instance details.
String hostname = "hostname";
String port = "port";
String dbname = "db";
String username = "user";
String password = "password";
String mek="00112233445566778899aabbccddeeff";  // Example only. Use a more complex key.
String encAlgo="SM4_128_CBC";
Properties props = new Properties();
props.setProperty("user", username);
props.setProperty("password", password);
props.setProperty("MEK", mek);
props.setProperty("ENC_ALGO", encAlgo);
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s", hostname, port, dbname);
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");
Connection connection = DriverManager.getConnection(dbUrl, props);
int[] intData = {1, 2, 3, 4, 5, 6};
String[] strData = {"abc", "bcd", "1", "def", "efg", "fgi"};
// Create a table.
connection.createStatement().executeUpdate("drop table if exists test");
connection.createStatement().executeUpdate("create table test (a int, b text)");
// Insert data.
for (int i = 0; i < 6; i++) {
    PreparedStatement pstmt = connection.prepareStatement("insert into test values (?,?)");
    pstmt.setInt(1, intData[i]);
    pstmt.setString(2, strData[i]);
    pstmt.executeUpdate();
}
// Check the plaintext data.
ResultSet rs = connection.createStatement().executeQuery("select * from test");
while (rs.next()) {
    for (int i = 0; i < rs.getMetaData().getColumnCount(); i++) {
        System.out.print(rs.getString(i + 1));
        System.out.print("\t");
    }
    System.out.print("\n");
}

1	abc	
2	bcd	
3	1	
4	def	
5	efg	
6	fgi	

SSS

• S: Uygulamayı çalıştırdığımda neden Exception in thread "main" java.lang.IllegalAccessError: class com.alibaba.encdb.common.SymCrypto (in unnamed module @0x5c0369c4) cannot access class com.sun.crypto.provider.SunJCE (in module java.base) because module java.base does not export com.sun.crypto.provider to unnamed module @0x5c0369c4 hatasını alıyorum?

  C: Bu hata, yeni JDK sürümlerinin modüller arası erişimi kısıtlaması nedeniyle oluşabilir. Bu sorunu çözmek için çalışma zamanında --add-exports=java.base/com.sun.crypto.provider=ALL-UNNAMED VM seçeneğini ekleyin. Bu seçenek com.sun.crypto.provider paketini isimsiz modüle dışa aktarır ve erişim sorununu çözer.

• S: Uygulamayı çalıştırdığımda neden failed in mek provision: you might have an incorrect mek setting. Detail:gcmEncrypt error hatasını alıyorum?

  C: Bu sorun Oracle JDK ile yaygın olarak görülür. Çözmek için aşağıdaki yöntemlerden birini kullanın:

  • Amazon Corretto JDK kullanın.

  • Oracle JDK'niz için aşağıdaki adımları izleyerek bir güvenlik sağlayıcısını manuel olarak yapılandırın:

    1. JDK kurulum dizininizi bulun.

    2. <jdk_installation_path>/conf/security/ dizininde java.security dosyasını bulun.

    3. java.security dosyasını düzenleyin. List of providers and their preference orders (see above): bölümüne aşağıdaki satırı ekleyin:

       security.provider.14=org.bouncycastle.jce.provider.BouncyCastleProvider