ApsaraDB RDS：EncJDBC

Jika Anda memiliki kunci enkripsi utama (MEK), EncJDBC dapat secara otomatis mendekripsi data ciphertext dan mengembalikan data plaintext. Proses ini transparan bagi aplikasi Anda, sehingga Anda dapat menghubungkan aplikasi ke basis data selalu rahasia dengan beberapa perubahan pada kode aplikasi. Hal ini menyederhanakan penggunaan fitur basis data selalu rahasia.

Prasyarat

• Fitur basis data selalu rahasia telah diaktifkan untuk instance ApsaraDB RDS for MySQL Anda. Untuk informasi lebih lanjut, lihat Aktifkan fitur basis data selalu rahasia.

• Informasi koneksi untuk instance RDS dengan fitur basis data selalu rahasia diaktifkan telah diperoleh. Informasi tersebut mencakup nama domain (host), nomor port (port), nama instance (dbname), nama pengguna (username), dan kata sandi (password).

• Aturan perlindungan data telah dikonfigurasi. Untuk informasi lebih lanjut, lihat Konfigurasikan aturan perlindungan data.

Catatan penggunaan

• Anda harus menyimpan MEK dan menjaganya tetap rahasia.

• Gunakan JDK 1.8 atau versi yang lebih baru.

  Catatan

  Dalam topik ini, versi Maven adalah 3.9.2, dan alat pengembangan adalah IntelliJ IDEA Community Edition 2022.3.2.

Langkah 1: Tambahkan dependensi Maven

Tambahkan dependensi berikut ke file pom.xml proyek Anda di Maven.

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

Langkah 2: Konfigurasikan EncJDBC berdasarkan contoh kode

Anda dapat menggunakan EncJDBC seperti menggunakan JDBC standar. Sebelum menggunakan EncJDBC, konfigurasikan parameter yang diperlukan, seperti MEK dan ENC_ALGO, di EncJDBC untuk keamanan data. MEK menentukan kunci enkripsi utama, sedangkan ENC_ALGO menentukan algoritma enkripsi.

Tabel berikut menjelaskan parameter dan memberikan nilai contoh.

// Dapatkan informasi koneksi seperti nama domain (hostname), nomor port (port), nama instance (dbname), nama pengguna (username), dan kata sandi (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);

// ... Mulai query. ...

MEK=
ENC_ALGO=

// Dapatkan informasi koneksi seperti nama domain (hostname), nomor port (port), nama instance (dbname), nama pengguna (username), dan kata sandi (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);

// ... Mulai query. ...

// Dapatkan informasi koneksi seperti nama domain (hostname), nomor port (port), nama instance (dbname), nama pengguna (username), dan kata sandi (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);

// ... Mulai query. ...

// Perbarui informasi koneksi seperti nama domain (hostname), nomor port (port), nama instance (dbname), nama pengguna (username), dan kata sandi (password) ke informasi instance Anda.
String hostname = "hostname";
String port = "port";
String dbname = "db";
String username = "user";
String password = "password";

String mek="00112233445566778899aabbccddeeff"; // Ini adalah nilai contoh. Kami merekomendasikan agar Anda menggunakan MEK yang lebih kompleks.
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"};

// buat tabel
connection.createStatement().executeUpdate("drop table if exists test");
connection.createStatement().executeUpdate("create table test (a int, b text)");

// masukkan 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();
}

// periksa data plaintext
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	cde	
4	def	
5	efg	
6	fgi	

FAQ

• Apa yang harus saya lakukan jika pesan kesalahan 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 muncul saat menjalankan program?

  Pesan kesalahan ini mungkin muncul karena masalah izin antar-modul ketika versi JDK lebih baru dari yang diperlukan. Untuk menyelesaikan kesalahan ini, tambahkan opsi VM --add-exports=java.base/com.sun.crypto.provider=ALL-UNNAMED saat menjalankan program untuk mengekspor com.sun.crypto.provider ke modul Unnamed.

• Apa yang harus saya lakukan jika pesan kesalahan failed in mek provision: you might have an incorrect mek setting. Detail:gcmEncrypt error muncul saat menjalankan program?

  Kesalahan ini merupakan kesalahan umum di Oracle JDK. Untuk menyelesaikan kesalahan ini, gunakan salah satu metode berikut:

  • Gunakan Amazon Corretto sebagai gantinya.

  • Jika Anda menggunakan Oracle JDK, lakukan langkah-langkah berikut untuk mengonfigurasi penyedia keamanan:

    1. Temukan jalur instalasi JDK.

    2. Di direktori Installation path/conf/security/, temukan file java.security.

    3. Edit file java.security. Di bagian List of providers and their preference orders (see above):, tambahkan konten berikut:

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