Key Management Service:Secrets JDBC クライアント

注意事項

• サポートされるシークレットの種類：汎用シークレットおよび RDS シークレット。

  • RDS シークレットを使用する場合は、デュアルアカウント管理型の RDS シークレットを使用することを推奨します。

  • 汎用シークレットを使用する場合、シークレット値は以下の JSON 形式である必要があります。

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

• サポートされるプログラミング言語：Java 8 以降。

• サポートされるデータベース接続プール：c3p0、DBCP、HikariCP、Druid。

シナリオ 1：共有ゲートウェイを使用してシークレットを取得

サポートされるネットワークタイプは、パブリックネットワークおよび VPC です。この方法では、ECS インスタンス RAM ロール、RamRoleArn、STS トークン、AccessKey などの RAM ベースの認証方式をサポートします。詳細については、「アクセス認証情報の管理」をご参照ください。

シナリオ 2：専用ゲートウェイを使用してシークレットを取得 (非推奨)

ネットワークタイプは KMS プライベートネットワークであり、ClientKey のみがサポートされるアクセス認証情報です。

JDBC を使用したデータベースへの接続

• MySQL データベース

  説明

  #your-mysql-secret-name#、<your-mysql-ip>、<your-mysql-port>、および <your-database-name> は、実際のシークレット名、サーバー IP アドレス、ポート、およびデータベース名に置き換えてください。

  import java.sql.Connection;
  import java.sql.DriverManager;
  import java.sql.SQLException;
  
  public class SecretManagerJDBCSample {
      public static void main(String[] args) throws Exception {
          // Alibaba Cloud Secrets JDBC ドライバーをロードします：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();
          }
      }
  }

• SQL Server データベース

  説明

  #your-sqlserver-secret-name#、<your-sqlserver-ip>、<your-sqlserver-port>、および <your-database-name> は、実際のシークレット名、サーバー IP アドレス、ポート、およびデータベース名に置き換えてください。

  import java.sql.Connection;
  import java.sql.DriverManager;
  import java.sql.SQLException;
  
  public class SecretManagerJDBCSqlServerSample {
  
      public static void main(String[] args) throws Exception{
          // Alibaba Cloud Secrets JDBC ドライバーをロードします：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();
          }
      }
  }

• PostgreSQL データベース

  説明

  #your-postgresql-secret-name#、<your-postgresql-ip>、<your-postgresql-port>、および <your-database-name> は、実際のシークレット名、サーバー IP アドレス、ポート、およびデータベース名に置き換えてください。

  import java.sql.Connection;
  import java.sql.DriverManager;
  import java.sql.SQLException;
  
  public class SecretManagerJDBCPostgreSQLSample {
      public static void main(String[] args) throws Exception {
          // Alibaba Cloud Secrets JDBC ドライバーをロードします：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();
          }
      }
  }

• MariaDB データベース

  説明

  #your-mariadb-secret-name#、<your-mariadb-ip>、<your-mariadb-port>、および <your-database-name> は、実際のシークレット名、サーバー IP アドレス、ポート、およびデータベース名に置き換えてください。

  import java.sql.Connection;
  import java.sql.DriverManager;
  import java.sql.SQLException;
  
  public class SecretManagerJDBCMarialDBSample {
  
  	public static void main(String[] args) throws Exception{
  		// Alibaba Cloud Secrets JDBC ドライバーをロードします：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();
  		}
  	}
  }

データベース接続プールを使用した接続

c3p0.properties 設定ファイルで c3p0.user、c3p0.driverClass、および c3p0.jdbcUrl を設定します。c3p0.user はシークレット名、c3p0.driverClass は Alibaba Cloud Secrets JDBC ドライバークラス名、c3p0.jdbcUrl は secrets-manager で始まる必要があります。

• MySQL データベース

  説明

  #your-mysql-secret-name#、<your-mysql-ip>、<your-mysql-port>、および <your-database-name> は、実際のシークレット名、サーバー IP アドレス、ポート、およびデータベース名に置き換えてください。

  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>

• SQL Server データベース

  説明

  #your-sqlserver-secret-name#、<your-sqlserver-ip>、<your-sqlserver-port>、および <your-database-name> は、実際のシークレット名、サーバー IP アドレス、ポート、およびデータベース名に置き換えてください。

  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>

• PostgreSQL データベース

  説明

  #your-postgresql-secret-name#、<your-postgresql-ip>、<your-postgresql-port>、および <your-database-name> は、実際のシークレット名、サーバー IP アドレス、ポート、およびデータベース名に置き換えてください。

  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>

• MariaDB データベース

  説明

  #your-mariadb-secret-name#、<your-mariadb-ip>、<your-mariadb-port>、および <your-database-name> は、実際のシークレット名、サーバー IP アドレス、ポート、およびデータベース名に置き換えてください。

  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>

データソースを使用した接続

この例では、c3p0 ComboPooledDataSource および MySQL データベースを使用します。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>

Druid 接続プールを使用した接続

この例では、MySQL データベースを使用します。設定ファイルで以下のプロパティを変更する必要があります。

• 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>

• Bean 設定を使用する

  • 方法 1：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>
    

  • 方法 2：プロパティインジェクション

    アプリケーション内に設定クラスを作成し、データベース接続情報をロードします。

    @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;
        }
    }