Data Security Center:EncJDBC の統合

JDBC プロパティ構成

標準の JDBC を使用して接続する場合、Properties を介してカスタムユーザープロパティを設定できます。次の例は、この方法で JDBC を構成して実行する方法を示しています。

// エンドポイント (ホスト名)、ポート、データベースインスタンス名 (dbname)、ユーザー名、パスワードなどの接続情報を準備します。
// ...

String hostname = "your-hostname";
String port = "your-port";
String dbname = "your-database-name";
String username = "your-username";
String password = "your-password";

// システム環境変数から AccessKey ID と AccessKey Secret を取得します。
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
// STS の一時的なアクセス認証情報を使用して KMS キーを読み取る場合は、取得したセキュリティトークンサービス (STS) トークンも提供する必要があります。
// String stsToken= "yourSecurityToken";

// KMS インスタンスのエンドポイント。インターネットアクセスにはパブリックエンドポイントを使用します。VPC アクセスにはインスタンス VPC エンドポイントを使用します。
String kmsEndpoint = "kms.cn-hangzhou.aliyuncs.com";

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");



// 以下は、RDS for MySQL データベースの接続 URL フォーマットです: "jdbc:mysql:encdb://%s:%s/%s"。
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s", hostname, port, dbname);

// 以下は、RDS for MySQL データベース用の EncJDBC ドライバーをロードします。
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");

// データベース接続を取得します。
Connection connection = DriverManager.getConnection(dbUrl, props);

// ... クエリを開始 ...

URL 構成

次の例に示すように、KMS キーを取得するためのパラメーターを URL に埋め込むことができます。

// エンドポイント (ホスト名)、ポート、データベースインスタンス名 (dbname)、ユーザー名、パスワードなどの接続情報を準備します。
// ...
String hostname = "your-hostname";
String port = "your-port";
String dbname = "your-database-name";
String username = "your-username";
String password = "your-password";

// システム環境変数から AccessKey ID と AccessKey Secret を取得します。
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
// STS の一時的なアクセス認証情報を使用して KMS キーを読み取る場合は、取得した STS トークンも提供する必要があります。
// String stsToken= "yourSecurityToken";

// KMS インスタンスのエンドポイント。インターネットアクセスにはパブリックエンドポイントを使用します。VPC アクセスにはインスタンス VPC エンドポイントを使用します。
String kmsEndpoint = "kms.cn-hangzhou.aliyuncs.com";

// 以下は、RDS for MySQL データベースの接続 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);
// STS トークンを使用します。
// 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);

// 以下は、RDS for MySQL データベース用の EncJDBC ドライバーをロードします。
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");

// データベース接続を取得します。
Connection connection = DriverManager.getConnection(dbUrl, username, password);

// ... クエリを開始 ...

JDBC プロパティ構成

標準の JDBC を使用して接続する場合、Properties を介してカスタムユーザープロパティを設定できます。次の例は、この方法で JDBC を構成して実行する方法を示しています。

// エンドポイント (ホスト名)、ポート、データベースインスタンス名 (dbname)、ユーザー名、パスワードなどの接続情報を準備します。
// ...

String hostname = "your-hostname";
String port = "your-port";
String dbname = "your-database-name";
String username = "your-username";
String password = "your-password";
// 顧客マスターキー。
String mek = "00112233445566778899aabbccddeeff"; 

Properties props = new Properties();
props.setProperty("user", username);
props.setProperty("password", password);
props.setProperty("MEK", mek);

// 以下は、RDS for MySQL データベースの接続 URL フォーマットです: "jdbc:mysql:encdb://%s:%s/%s"。RDS for PostgreSQL データベースの場合は、フォーマットを "jdbc:postgresql:encdb://%s:%s/%s" に置き換えます。
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s", hostname, port, dbname);

// 以下は、RDS for MySQL データベース用の EncJDBC ドライバーをロードします。RDS for PostgreSQL データベースの場合は、ドライバーを "com.aliyun.encdb.postgresql.jdbc.EncDriver" に置き換えます。
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");

// データベース接続を取得します。
Connection connection = DriverManager.getConnection(dbUrl, props);

// ... クエリを開始 ...

ファイル構成

必要な MEK などのパラメーターを構成ファイルからインポートできます。

プロジェクトで、property という名前の encJdbcConfigFile を設定し、その値を構成ファイルのパスに設定できます。このプロパティを設定しない場合、デフォルトで encjdbc.conf ファイルが使用されます。構成ファイルの内容は次のとおりです。

MEK=00112233445566778899aabbccddeeff

構成ファイルは、次の 2 つの場所のいずれかに配置できます。

• 次の図に示すように、プロジェクトのリソースフォルダにファイルを配置します。

  

• プログラムのランタイムディレクトリであるプロジェクトのルートディレクトリにファイルを配置します。

ファイルを構成した後、次の例に示すように、プログラムで追加の構成を行う必要はありません。

// エンドポイント (ホスト名)、ポート、データベースインスタンス名 (dbname)、ユーザー名、パスワードなどの接続情報を準備します。
// ...
String hostname = "your-hostname";
String port = "your-port";
String dbname = "your-database-name";
String username = "your-username";
String password = "your-password";

// 以下は、RDS for MySQL データベースの接続 URL フォーマットです: "jdbc:mysql:encdb://%s:%s/%s"。RDS for PostgreSQL データベースの場合は、フォーマットを "jdbc:postgresql:encdb://%s:%s/%s" に置き換えます。
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s", hostname, port, dbname);

// 以下は、RDS for MySQL データベース用の EncJDBC ドライバーをロードします。RDS for PostgreSQL データベースの場合は、ドライバーを "com.aliyun.encdb.postgresql.jdbc.EncDriver" に置き換えます。
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");

// データベース接続を取得します。
Connection connection = DriverManager.getConnection(dbUrl, username, password);

// ... クエリを開始 ...

URL 構成

次の例に示すように、MEK などのパラメーターを URL に埋め込むことができます。

// エンドポイント (ホスト名)、ポート、データベースインスタンス名 (dbname)、ユーザー名、パスワードなどの接続情報を準備します。
// ...
String hostname = "your-hostname";
String port = "your-port";
String dbname = "your-database-name";
String username = "your-username";
String password = "your-password";
 // 顧客マスターキー。
String mek = "00112233445566778899aabbccddeeff";

// 以下は、RDS for MySQL データベースの接続 URL フォーマットです: "jdbc:mysql:encdb://%s:%s/%s?MEK=%s"。RDS for PostgreSQL データベースの場合は、フォーマットを "jdbc:postgresql:encdb://%s:%s/%s?MEK=%s" に置き換えます。
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s?MEK=%s", hostname, port, dbname, mek);

// 以下は、RDS for MySQL データベース用の EncJDBC ドライバーをロードします。RDS for PostgreSQL データベースの場合は、ドライバーを "com.aliyun.encdb.postgresql.jdbc.EncDriver" に置き換えます。
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");

// データベース接続を取得します。
Connection connection = DriverManager.getConnection(dbUrl, username, password);

// ... クエリを開始 ...