Java uygulamalarınızda kod değişikliği yapmadan entegrasyon gerçekleştirmek için PolarDB Always-confidential ile birlikte sunulan özel Encrypted JDBC (EncJDBC) sürücüsünü kullanın. EncJDBC, şifreli metni otomatik olarak çözer ve düz metin verisi döndürür. Bu süreç uygulamanız için şeffaftır; böylece yalnızca birkaç yapılandırma değişikliği yaparak PolarDB Always-confidential hizmetine bağlanabilirsiniz.
Çözüm mimarisi
PolarDB Always-confidential is an on-the-fly encryption and decryption solution based on a database proxy. The proxy encrypts pre-configured sensitive fields when returning the query result set to the client. The client application must use the dedicated EncJDBC driver to transparently decrypt the received data.
İş akışı ve rol izinleri:
Sorgu: Bir istemci uygulaması, EncJDBC sürücüsü aracılığıyla standart bir SQL sorgusunu PolarDB küme uç noktasına gönderir.
Proxy işleme: Veritabanı proxy'si isteği alır ve çalıştırılması için arka plandaki veritabanı çekirdeğine iletir.
Anlık şifreleme: Sorgu sonucunu döndürürken proxy katmanı, sonuçların önceden tanımlanmış bir şifreleme ilkesiyle eşleşip eşleşmediğini kontrol eder. Eşleşme durumunda proxy, Key Management Service (KMS) üzerinden belirttiğiniz veya kendi yönettiğiniz bir anahtarı kullanarak sonuç kümesindeki hassas alanları şifreler.
Veri dönüşü: Şifrelenmiş sonuç kümesi istemciye döndürülür.
Şeffaf şifre çözme: İstemcideki EncJDBC sürücüsü şifreli metni otomatik olarak çözer. Uygulama düz metin verisi alır ve tüm süreç iş kodunuz için şeffaf kalır.
Sorgu sonuçları, veritabanı hesabının rolüne göre değişiklik gösterir:
Süper yönetici: Sorgu sonuçları her zaman düz metin formatındadır ve şifreleme ilkelerinden etkilenmez. Bu durum, veritabanı yönetimi ve denetim için kullanışlıdır.
Normal kullanıcı: Sorgu sonuçları şifreli metin olarak döndürülür. Verileri istemcide çözmek için EncJDBC sürücüsünü ve doğru anahtarı kullanmanız gerekir.
Diğer kullanıcılar: Sorgu sonuçları şifreli metin olarak döndürülür ve çözülemez.
Sınırlamalar
Devam etmeden önce, bu çözümün iş ve teknik gereksinimlerinizi karşılayıp karşılamadığını belirlemek için aşağıdaki temel sınırlamaları inceleyin.
Uç nokta gereksinimleri: Şifreleme kuralları yalnızca bir küme uç noktasına veya özel uç noktaya bağlandığınızda etkili olur. Doğrudan birincil uç noktaya bağlanmak proxy'yi atlar ve bu da şifreleme özelliğini devre dışı bırakır.
Anahtar yönetimi: Kendi yönettiğiniz bir anahtar kullandığınızda anahtar döndürme desteklenmez ve anahtarın kaybolma veya sızma riski bulunur. Bir anahtar kaybolursa, ilgili şifrelenmiş verilerin şifresini çözemeyebilirsiniz. Anahtarı yönetmek için sıkı güvenlik prosedürleri oluşturmalısınız.
JDK sürümü: JDK sürüm 1,8 veya üzerini kullanmanız gerekir.
KMS'den anahtar kullanma
Adım 1: KMS erişim izinlerini yapılandırma
-
Bir AccessKey çifti edinin: Uygulamanızın Key Management Service (KMS) tarafından yönetilen ana şifreleme anahtarını (MEK) alabilmesi için bir RAM kullanıcısının
AccessKey IDveAccessKey secretbilgilerini edinin.KMS'e erişim iznine sahip uygun bir RAM kullanıcınız zaten varsa bu kullanıcıyı kullanabilirsiniz.
Uygun bir RAM kullanıcınız yoksa RAM konsoluna gidin. Sol gezinme bölmesinde Identity Management > Users seçeneğini belirleyin. Create User seçeneğine tıklayın ve ekrandaki talimatları izleyerek bir kullanıcı oluşturun.
-
RAM kullanıcısına izin verin:
-
RAM konsoluna gidin. Sol gezinme bölmesinde Permission Management > Policies seçeneğini belirleyin. Create Policy seçeneğine tıklayın. JSON sekmesine geçin, aşağıdaki içeriği kopyalayın ve ardından OK seçeneğine tıklayın. İlkeyi oluşturmak için bir ad girin.
{ "Version": "1", "Statement": [ { "Effect": "Allow", "Action": "KMS:Decrypt", "Resource": "*" } ] } RAM konsoluna geri dönün. Sol gezinme bölmesinde Identity Management > Users seçeneğini belirleyin. Hedef RAM kullanıcısını bulun, Actions sütunundaki Add Permissions seçeneğine tıklayın ve yeni oluşturulan erişim ilkesini kullanıcıya atayın. Bu işlem, PolarDB hizmetinin verileri dinamik olarak çözmesine olanak tanır.
-
-
KMS örnek uç noktasını edinin:
VPC uç noktası (varsayılan): Varsayılan olarak, bir KMS örneğindeki anahtarlara yalnızca VPC ağı üzerinden erişilebilir. KMS örnek yönetim sayfasına gidin, örneğin bölgesini seçin, hedef KMS örneğini bulun ve Actions sütunundaki Details seçeneğine tıklayın. Basic Information sekmesinde örneğin VPC uç noktasını görüntüleyin.
Genel uç nokta: Anahtara internet üzerinden erişmeniz gerekiyorsa Multi-account Key sekmesinde genel erişimi etkinleştirmeniz gerekir. Genel erişimi etkinleştirdikten sonra Public network address adresini Basic Information sekmesinde görüntüleyebilirsiniz.
Adım 2: Bağımlılıkları yükleme
Maven projenizdeki pom.xml dosyasına aşağıdaki bağımlılığı ekleyin.
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-cls-jdbc</artifactId>
<version>1.0.10-1</version>
</dependency>
Maven bağımlılığını eklerken kullanım durumunuza göre version değerini değiştirin. aliyun-cls-jdbc öğesinin en son sürümünü Maven deposunda bulabilirsiniz.
Adım 3: MEK'i yapılandırma
MEK öğesini JDBC properties, bir dosya yapılandırması veya URL yapılandırması kullanarak yapılandırabilirsiniz. Birden fazla yapılandırma yöntemi kullanırsanız öncelik sırası şu şekildedir: JDBC properties yapılandırması > dosya yapılandırması > URL yapılandırması.
Aşağıdaki yapılandırma ve bağlantı yöntemlerinde
MEKistemcide işlenir ve zarf şifreleme kullanılarak sunucuya güvenli bir şekilde gönderilir. Bu sayedeMEKsızıntısı önlenir.AccessKey çiftinizi (
AccessKey IDveAccessKey secret) uygulama kodunuzda sabit kodlamanız önerilmez. Bu konuda AccessKey çiftini yönetmek için bir ortam değişkeni kullanılmaktadır. Daha fazla bilgi için bkz. Linux, macOS ve Windows sistemlerinde ortam değişkenlerini yapılandırma.KMS tarafından yönetilen MEK'i almak için geçici STS erişim kimlik bilgisi kullanmanız gerekiyorsa geçici bir STS belirteci almak üzere STS SDK'sını kullanabilirsiniz. STS SDK örnekleri için bkz. STS SDK'larına genel bakış.
JDBC özellikleri
Standart bir JDBC bağlantısı kurarken Properties nesnesini kullanarak özel nitelikler ayarlayabilirsiniz.
Örnek
// Prepare the connection information, such as the hostname, port, database name (dbname), username, and password.
String hostname = "your-hostname";
String port = "your-port";
String dbname = "your-database-name";
String username = "your-username";
String password = "your-password";
// Obtain the AccessKey ID and AccessKey secret from environment variables.
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
// If you use a temporary STS access credential to read the KMS key, you must also provide the obtained STS token.
// String stsToken= "yourSecurityToken";
// For the KMS instance endpoint, use the public endpoint for internet access or the VPC endpoint for access within a VPC.
String kmsEndpoint = "your-kms-endpoint";
Properties props = new Properties();
props.setProperty("user", username);
props.setProperty("password", password);
props.setProperty("ALIBABA_CLOUD_ACCESS_KEY_ID", accessKeyId);
props.setProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET", accessKeySecret);
props.setProperty("ALIBABA_CLOUD_KMS_ENDPOINT", kmsEndpoint);
// props.setProperty("ALIBABA_CLOUD_STS_TOKEN","stsToken");
// The connection URL format for a MySQL database is "jdbc:mysql:encdb://%s:%s/%s".
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s", hostname, port, dbname);
// Load the EncJDBC driver for the MySQL database.
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");
// Get the database connection.
Connection connection = DriverManager.getConnection(dbUrl, props);
// ... Initiate a query ...
URL
KMS anahtar parametrelerini bağlantı URL'sine gömebilirsiniz.
Örnek
// Prepare the connection information, such as the hostname, port, database name (dbname), username, and password.
String hostname = "your-hostname";
String port = "your-port";
String dbname = "your-database-name";
String username = "your-username";
String password = "your-password";
// Obtain the AccessKey ID and AccessKey secret from environment variables.
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
// If you use a temporary STS access credential to read the KMS key, you must also provide the obtained STS token.
// String stsToken= "yourSecurityToken";
// For the KMS instance endpoint, use the public endpoint for internet access or the VPC endpoint for access within a VPC.
String kmsEndpoint = "your-kms-endpoint";
// Embed the KMS key parameters in the connection URL.
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s?ALIBABA_CLOUD_ACCESS_KEY_ID=%s&ALIBABA_CLOUD_ACCESS_KEY_SECRET=%s&ALIBABA_CLOUD_KMS_ENDPOINT=%s", hostname, port, dbname, accessKeyId, accessKeySecret, kmsEndpoint);
// Use an STS token.
// String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s?ALIBABA_CLOUD_ACCESS_KEY_ID=%s&ALIBABA_CLOUD_ACCESS_KEY_SECRET=%s&ALIBABA_CLOUD_KMS_ENDPOINT=%s&ALIBABA_CLOUD_STS_TOKEN=%s", hostname, port, dbname, accessKeyId, accessKeySecret, kmsEndpoint, stsToken);
// Load the EncJDBC driver for the MySQL database.
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");
// Get the database connection.
Connection connection = DriverManager.getConnection(dbUrl, username, password);
// ... Initiate a query ...
Adım 4: Düz metin verisini sorgulama
Veritabanına bağlandıktan sonra standart bir JDBC sorgusunda olduğu gibi veritabanı işlemleri gerçekleştirebilirsiniz. EncJDBC, şifrelenmiş sütunları otomatik olarak çözer ve düz metin verisi döndürür.
Örnek
// Create a query statement.
Statement statement = connection.createStatement();
ResultSet resultSet = statement.executeQuery("SELECT * FROM your_table_name");
// Iterate over the result set.
while (resultSet.next()) {
for (int i = 0; i < resultSet.getMetaData().getColumnCount(); i++) {
System.out.print(resultSet.getString(i + 1));
System.out.print("\t");
}
System.out.print("\n");
}
Ek: Kod örneği
Bu örnekte Maven sürüm 3.9.9 ve IntelliJ IDEA Community Edition 2024.1.2 geliştirme aracı kullanılmaktadır.
import java.sql.*;
import java.util.Properties;
public class EncryptedColumnAccess {
public static void main(String[] args) throws ClassNotFoundException, SQLException {
// Replace the following connection information with your instance details, such as hostname, port, database name (dbname), username, and password.
String hostname = "your-hostname";
String port = "your-port";
String dbname = "your-database-name";
String username = "your-username";
String password = "your-password";
// Obtain the AccessKey ID and AccessKey secret from environment variables.
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
// If you use a temporary STS access credential to read the KMS key, you must also provide the obtained STS token.
// String stsToken= "yourSecurityToken";
// For the KMS instance endpoint, use the public endpoint for internet access or the VPC endpoint for access within a VPC.
String kmsEndpoint = "your-kms-endpoint";
Properties props = new Properties();
props.setProperty("user", username);
props.setProperty("password", password);
props.setProperty("ALIBABA_CLOUD_ACCESS_KEY_ID", accessKeyId);
props.setProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET", accessKeySecret);
props.setProperty("ALIBABA_CLOUD_KMS_ENDPOINT", kmsEndpoint);
// props.setProperty("ALIBABA_CLOUD_STS_TOKEN","stsToken");
// The connection URL format for a MySQL database is "jdbc:mysql:encdb://%s:%s/%s".
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s", hostname, port, dbname);
// Load the EncJDBC driver.
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");
// Get the database connection.
Connection connection = DriverManager.getConnection(dbUrl, props);
// Initiate a query.
try {
// Create a query statement.
Statement statement = connection.createStatement();
ResultSet resultSet = statement.executeQuery("SELECT * FROM users");
// Iterate over the result set.
while (resultSet.next()) {
int id = resultSet.getInt("id");
String name = resultSet.getString("username");
String phone = resultSet.getString("phone");
// Process other fields based on your table schema.
System.out.println("ID: " + id + ", Name: " + name + ", Phone: " + phone);
}
// Close the resources.
resultSet.close();
statement.close();
} catch (SQLException e) {
e.printStackTrace();
}
}
}
Yerel anahtar kullanma
Adım 1: MEK oluşturma
Ana şifreleme anahtarı (MEK), istemcilerin şifrelenmiş verilere erişimini yetkilendiren kök kimlik bilgisidir. Güvenlik amacıyla şifreli veritabanı MEK'inizi depolamaz, yönetmez, oluşturmaz veya yedeklemez. MEK'i oluşturma, güvenli bir şekilde yönetme ve yedekleme sorumluluğu tamamen size aittir. MEK'in depolanması ve yönetimi veritabanı güvenliği için kritiktir. MEK'inizi yedeklemenizi kesinlikle öneririz.
MEK: İstemci, MEK'i güvenli bir asimetrik şifreleme protokolü üzerinden veritabanı sunucusuna gönderir. Bu sayede istemci ve sunucu aynı anahtarı paylaşır ve simetrik şifreleme yoluyla güvenli veri aktarımı sağlanır.
Değer gereksinimleri: 16 baytlık onaltılık dize (32 karakter uzunluğunda). Örneğin, 00112233445566778899aabbccddeeff.
Yaygın oluşturma yöntemleri: Parola oluşturma araçlarını veya bir programlama dilindeki rastgele fonksiyonu kullanabilirsiniz.
Örnek
-
Linux'ta yerleşik OpenSSL aracını kullanın. Bir anahtar oluşturmak için
openssl rand -hex 16komutunu çalıştırın.# Use OpenSSL to generate a secure random key openssl rand -hex 16 # Example output: 11ce9a9489fab7355cf710837cea5d5b Windows'ta OpenSSL paketini yükleyin.
Adım 2: Bağımlılıkları yükleme
Maven projenizdeki pom.xml dosyasına aşağıdaki bağımlılığı ekleyin.
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-cls-jdbc</artifactId>
<version>1.0.10-1</version>
</dependency>
Maven bağımlılığını eklerken kullanım durumunuza göre version değerini değiştirin. aliyun-cls-jdbc öğesinin en son sürümünü Maven deposunda bulabilirsiniz.
Adım 3: MEK'i yapılandırma
MEK öğesini JDBC properties, bir dosya yapılandırması veya URL yapılandırması kullanarak yapılandırabilirsiniz. Birden fazla yapılandırma yöntemi kullanırsanız öncelik sırası şu şekildedir: JDBC properties yapılandırması > dosya yapılandırması > URL yapılandırması.
Aşağıdaki yapılandırma ve bağlantı yöntemlerinde MEK istemcide işlenir ve zarf şifreleme kullanılarak sunucuya güvenli bir şekilde gönderilir. Bu sayede MEK sızıntısı önlenir.
JDBC özellikleri
Standart bir JDBC bağlantısı kurarken Properties nesnesini kullanarak özel nitelikler ayarlayabilirsiniz.
Örnek
// Prepare the connection information, such as the hostname, port, database name (dbname), username, and password.
String hostname = "your-hostname";
String port = "your-port";
String dbname = "your-database-name";
String username = "your-username";
String password = "your-password";
// The master encryption key.
String mek = "00112233445566778899aabbccddeeff";
Properties props = new Properties();
props.setProperty("user", username);
props.setProperty("password", password);
props.setProperty("MEK", mek);
// The connection URL format for a MySQL database is "jdbc:mysql:encdb://%s:%s/%s".
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s", hostname, port, dbname);
// Load the EncJDBC driver for the MySQL database.
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");
// Get the database connection.
Connection connection = DriverManager.getConnection(dbUrl, props);
// ... Initiate a query ...
Dosya
Dosya yapılandırma yöntemi yalnızca yerel anahtar MEK'i yapılandırmak için geçerlidir.
Gerekli MEK öğesini yapılandırmak için parametreleri bir yapılandırma dosyasından içe aktarabilirsiniz. Projenizde encJdbcConfigFile özelliğini yapılandırma dosyasının yoluna ayarlayın. Bir yol belirtmezseniz sistem varsayılan olarak encjdbc.conf dosyasını kullanır. Yapılandırma dosyası aşağıdaki içeriği içermelidir:
MEK=00112233445566778899aabbccddeeff
Örnek
-
Yapılandırma dosyasının konumunu aşağıdaki iki yoldan biriyle belirtebilirsiniz:
-
Dosyayı projenizin
resourcesdizinine aşağıdaki yapıda gösterildiği gibi yerleştirin:src main java resources encjdbc.conf Dosyayı projenizin kök dizinine, yani programın çalışma zamanı dizinine yerleştirin.
-
-
Dosyayı yapılandırdıktan sonra aşağıdaki kodda gösterildiği gibi programınızda ek bir yapılandırma yapmanıza gerek yoktur:
// Prepare the connection information, such as the hostname, port, database name (dbname), username, and password. String hostname = "your-hostname"; String port = "your-port"; String dbname = "your-database-name"; String username = "your-username"; String password = "your-password"; // The connection URL format for a MySQL database is "jdbc:mysql:encdb://%s:%s/%s". String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s", hostname, port, dbname); // Load the EncJDBC driver for the MySQL database. Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver"); // Get the database connection. Connection connection = DriverManager.getConnection(dbUrl, username, password); // ... Initiate a query ...
URL
MEK ve diğer parametreleri bağlantı URL'sine gömebilirsiniz.
Örnek
// Prepare the connection information, such as the hostname, port, database name (dbname), username, and password.
String hostname = "your-hostname";
String port = "your-port";
String dbname = "your-database-name";
String username = "your-username";
String password = "your-password";
// The master encryption key.
String mek = "00112233445566778899aabbccddeeff";
// The connection URL format for a MySQL database is "jdbc:mysql:encdb://%s:%s/%s?MEK=%s".
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s?MEK=%s", hostname, port, dbname, mek);
// Load the EncJDBC driver for the MySQL database.
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");
// Get the database connection.
Connection connection = DriverManager.getConnection(dbUrl, username, password);
// ... Initiate a query ...
Adım 4: Düz metin verisini sorgulama
Veritabanına bağlandıktan sonra standart bir JDBC sorgusunda olduğu gibi veritabanı işlemleri gerçekleştirebilirsiniz. EncJDBC, şifrelenmiş sütunları otomatik olarak çözer ve düz metin verisi döndürür.
Örnek
// Create a query statement.
Statement statement = connection.createStatement();
ResultSet resultSet = statement.executeQuery("SELECT * FROM your_table_name");
// Iterate over the result set.
while (resultSet.next()) {
for (int i = 0; i < resultSet.getMetaData().getColumnCount(); i++) {
System.out.print(resultSet.getString(i + 1));
System.out.print("\t");
}
System.out.print("\n");
}
Ek: Kod örneği
Bu örnekte Maven sürüm 3.9.9 ve IntelliJ IDEA Community Edition 2024.1.2 geliştirme aracı kullanılmaktadır.
import java.sql.*;
import java.util.Properties;
public class EncryptedColumnAccess {
public static void main(String[] args) throws ClassNotFoundException, SQLException {
// Replace the following connection information with your instance details, such as hostname, port, database name (dbname), username, and password.
String hostname = "your-hostname";
String port = "your-port";
String dbname = "your-database-name";
String username = "your-username";
String password = "your-password";
// This is only an example. We recommend that you use a more complex key.
String mek="00112233445566778899aabbccddeeff";
Properties props = new Properties();
props.setProperty("user", username);
props.setProperty("password", password);
props.setProperty("MEK", mek);
// The connection URL format for a MySQL database is "jdbc:mysql:encdb://%s:%s/%s".
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s", hostname, port, dbname);
// Load the EncJDBC driver.
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");
// Get the database connection.
Connection connection = DriverManager.getConnection(dbUrl, props);
// Initiate a query.
try {
// Create a query statement.
Statement statement = connection.createStatement();
ResultSet resultSet = statement.executeQuery("SELECT * FROM users");
// Iterate over the result set.
while (resultSet.next()) {
int id = resultSet.getInt("id");
String name = resultSet.getString("username");
String phone = resultSet.getString("phone");
// Process other fields based on your table schema.
System.out.println("ID: " + id + ", Name: " + name + ", Phone: " + phone);
}
// Close the resources.
resultSet.close();
statement.close();
} catch (SQLException e) {
e.printStackTrace();
}
}
}