Key Management Service:Klien JDBC Secrets

Catatan penggunaan

• Jenis secret yang didukung: secret generik dan secret RDS.

  • Jika Anda menggunakan secret RDS, kami menyarankan menggunakan secret RDS managed dual-account.

  • Jika Anda menggunakan secret generik, nilai secret harus dalam format JSON berikut.

    {
        "AccountName":"<your-database-username>",
        "AccountPassword":"<your-database-password>"
    }

• Bahasa pemrograman yang didukung: Java 8 atau versi lebih baru.

• Connection pool database yang didukung: c3p0, DBCP, HikariCP, dan Druid.

Skenario 1: Ambil secret menggunakan gateway bersama

Jenis jaringan yang didukung adalah jaringan publik dan VPC. Metode ini mendukung metode autentikasi berbasis RAM seperti peran RAM instans ECS, RamRoleArn, token STS, dan AccessKey. Untuk informasi lebih lanjut, lihat Kelola kredensial akses.

Skenario 2: Ambil secret menggunakan gateway khusus (tidak disarankan)

Jenis jaringannya adalah jaringan pribadi KMS, dan ClientKey adalah satu-satunya kredensial akses yang didukung.

Hubungkan ke database menggunakan JDBC

• Database MySQL

  Catatan

  Ganti #your-mysql-secret-name#, <your-mysql-ip>, <your-mysql-port>, dan <your-database-name> dengan nama secret, alamat IP server, port, dan nama database yang sebenarnya.

  import java.sql.Connection;
  import java.sql.DriverManager;
  import java.sql.SQLException;
  
  public class SecretManagerJDBCSample {
      public static void main(String[] args) throws Exception {
          // Muat driver JDBC secrets Alibaba Cloud: com.aliyun.kms.secretsmanager.MysqlSecretsManagerSimpleDriver
          Class.forName("com.aliyun.kms.secretsmanager.MysqlSecretsManagerSimpleDriver");
          Connection connect = null;
          try {
              connect = DriverManager.getConnection("secrets-manager:mysql://<your-mysql-ip>:<your-mysql-port>/<your-database-name>", "#your-mysql-secret-name#","");
          } catch(SQLException e) {
              e.printStackTrace();
          }
      }
  }

• Database SQL Server

  Catatan

  Ganti #your-sqlserver-secret-name#, <your-sqlserver-ip>, <your-sqlserver-port>, dan <your-database-name> dengan nama secret, alamat IP server, port, dan nama database yang sebenarnya.

  import java.sql.Connection;
  import java.sql.DriverManager;
  import java.sql.SQLException;
  
  public class SecretManagerJDBCSqlServerSample {
  
      public static void main(String[] args) throws Exception{
          // Muat driver JDBC secrets Alibaba Cloud: com.aliyun.kms.secretsmanager.MssqlSecretsManagerSimpleDriver
          Class.forName("com.aliyun.kms.secretsmanager.MssqlSecretsManagerSimpleDriver");
          Connection connect = null;
          try {
              connect = DriverManager.getConnection("secrets-manager:sqlserver://<your-sqlserver-ip>:<your-sqlserver-port>;databaseName=<your-database-name>", "#your-sqlserver-secret-name#", "");
          }  catch (SQLException e) {
              e.printStackTrace();
          }
      }
  }

• Database PostgreSQL

  Catatan

  Ganti #your-postgresql-secret-name#, <your-postgresql-ip>, <your-postgresql-port>, dan <your-database-name> dengan nama secret, alamat IP server, port, dan nama database yang sebenarnya.

  import java.sql.Connection;
  import java.sql.DriverManager;
  import java.sql.SQLException;
  
  public class SecretManagerJDBCPostgreSQLSample {
      public static void main(String[] args) throws Exception {
          // Muat driver JDBC secrets Alibaba Cloud: com.aliyun.kms.secretsmanager.PostgreSQLSecretManagerSimpleDriver
          Class.forName("com.aliyun.kms.secretsmanager.PostgreSQLSecretManagerSimpleDriver");
          Connection connect = null;
          try {
              connect = DriverManager.getConnection("secrets-manager:postgresql://<your-postgresql-ip>:<your-postgresql-port>/<your-database-name>", "#your-postgresql-secret-name#", "");
          } catch (SQLException e) {
              e.printStackTrace();
          }
      }
  }

• Database MariaDB

  Catatan

  Ganti #your-mariadb-secret-name#, <your-mariadb-ip>, <your-mariadb-port>, dan <your-database-name> dengan nama secret, alamat IP server, port, dan nama database yang sebenarnya.

  import java.sql.Connection;
  import java.sql.DriverManager;
  import java.sql.SQLException;
  
  public class SecretManagerJDBCMarialDBSample {
  
  	public static void main(String[] args) throws Exception{
  		// Muat driver JDBC secrets Alibaba Cloud: com.aliyun.kms.secretsmanager.MariaDBSecretManagerSimpleDriver
  		Class.forName("com.aliyun.kms.secretsmanager.MariaDBSecretManagerSimpleDriver");
  		Connection connect = null;
  		try {
  			connect = DriverManager.getConnection("secrets-manager:mariadb://<your-mariadb-ip>:<your-mariadb-port>/<your-database-name>", "#your-mariadb-secret-name#", "");
  		}  catch (SQLException e) {
  			e.printStackTrace();
  		}
  	}
  }

Hubungkan menggunakan connection pool database

Atur c3p0.user, c3p0.driverClass, dan c3p0.jdbcUrl dalam file konfigurasi c3p0.properties. c3p0.user adalah nama secret, c3p0.driverClass adalah nama kelas driver JDBC secrets Alibaba Cloud, dan c3p0.jdbcUrl harus dimulai dengan secrets-manager.

• Database MySQL

  Catatan

  Ganti #your-mysql-secret-name#, <your-mysql-ip>, <your-mysql-port>, dan <your-database-name> dengan nama secret, alamat IP server, port, dan nama database yang sebenarnya.

  c3p0.user=#your-mysql-secret-name#
  c3p0.driverClass=com.aliyun.kms.secretsmanager.MysqlSecretsManagerSimpleDriver
  c3p0.jdbcUrl=secrets-manager:mysql://<your-mysql-ip>:<your-mysql-port>/<your-database-name>

• Database SQL Server

  Catatan

  Ganti #your-sqlserver-secret-name#, <your-sqlserver-ip>, <your-sqlserver-port>, dan <your-database-name> dengan nama secret, alamat IP server, port, dan nama database yang sebenarnya.

  c3p0.user=#your-sqlserver-secret-name#
  c3p0.driverClass=com.aliyun.kms.secretsmanager.MssqlSecretsManagerSimpleDriver
  c3p0.jdbcUrl=secrets-manager:sqlserver://<your-sqlserver-ip>:<your-sqlserver-port>/<your-database-name>

• Database PostgreSQL

  Catatan

  Ganti #your-postgresql-secret-name#, <your-postgresql-ip>, <your-postgresql-port>, dan <your-database-name> dengan nama secret, alamat IP server, port, dan nama database yang sebenarnya.

  c3p0.user=#your-postgresql-secret-name#
  c3p0.driverClass=com.aliyun.kms.secretsmanager.PostgreSQLSecretManagerSimpleDriver
  c3p0.jdbcUrl=secrets-manager:postgresql://<your-postgresql-ip>:<your-postgresql-port>/<your-database-name>

• Database MariaDB

  Catatan

  Ganti #your-mariadb-secret-name#, <your-mariadb-ip>, <your-mariadb-port>, dan <your-database-name> dengan nama secret, alamat IP server, port, dan nama database yang sebenarnya.

  c3p0.user=#your-mariadb-secret-name#
  c3p0.driverClass=com.aliyun.kms.secretsmanager.MariaDBSecretManagerSimpleDriver
  c3p0.jdbcUrl=secrets-manager:mariadb://<your-mariadb-ip>:<your-mariadb-port>/<your-database-name>

Hubungkan dengan menggunakan sumber data

Contoh ini menggunakan ComboPooledDataSource c3p0 dan database MySQL. Tambahkan konfigurasi berikut ke file konfigurasi Spring.

<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" >
      <property name="driverClass" value="com.aliyun.kms.secretsmanager.MysqlSecretsManagerSimpleDriver" />
      <property name="user" value="#your-mysql-secret-name#" />
      <property name="jdbcUrl" value="secrets-manager:mysql://<your-mysql-ip>:<your-mysql-port>/<your-database-name>" />
      <property name="maxPoolSize" value="***" />
      <property name="minPoolSize" value="***" />
      <property name="initialPoolSize" value="***" />
  </bean>
  <bean id="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate" >
      <property name="dataSource" ref="dataSource" />
  </bean>

Hubungkan menggunakan connection pool Druid

Contoh ini menggunakan database MySQL. Anda harus mengubah properti berikut dalam file konfigurasi.

• Gunakan file konfigurasi properties

  username=#your-mysql-secret-name#
  driverClassName=com.aliyun.kms.secretsmanager.MysqlSecretsManagerSimpleDriver
  url=secrets-manager:mysql://<your-mysql-ip>:<your-mysql-port>/<your-database-name>

• Gunakan konfigurasi bean

  • Metode 1: File konfigurasi XML

    <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close"> 
         <property name="username" value="${your-mysql-secret-name}" />
         <property name="driverClassName" value="com.aliyun.kms.secretsmanager.MysqlSecretsManagerSimpleDriver" />
         <property name="url" value="secrets-manager:mysql://<your-mysql-ip>:<your-mysql-port>/<your-database-name>" />
    </bean>
    

  • Metode 2: Penyuntikan properti

    Buat kelas konfigurasi dalam aplikasi Anda untuk memuat informasi koneksi database.

    @Configuration
    public class DataConfig {
    
        @Value("${your-mysql-secret-name}")
        private String username;
    
        @Value("com.aliyun.kms.secretsmanager.MysqlSecretsManagerSimpleDriver")
        private String driverClassName;
    
        @Value("secrets-manager:mysql://<your-mysql-ip>:<your-mysql-port>/<your-database-name>")
        private String url;
    
        @Bean(name = "dataSource",initMethod = "init",destroyMethod = "close")
        public DruidDataSource dataSource(){
            DruidDataSource druidDataSource = new DruidDataSource();
            druidDataSource.setUsername(username);
            druidDataSource.setDriverClassName(driverClassName);
            druidDataSource.setUrl(url);
            return druidDataSource;
        }
    }