Key Management Service:Client JDBC pour Secrets Manager

Le client JDBC pour Secrets Manager offre les fonctionnalités suivantes :

• Prise en charge de Java Database Connectivity (JDBC), y compris les connexions utilisant des pools de connexions à la base de données (tels que c3p0 et DBCP) et des sources de données.

• Compatibilité avec quatre types de bases de données : MySQL, SQL Server, PostgreSQL et MariaDB.

• Possibilité de personnaliser les intervalles d'actualisation des secrets.

Remarques importantes

• Types de secrets pris en charge : secrets génériques et secrets RDS.

  • Si vous utilisez un secret RDS, nous vous recommandons d'utiliser un secret RDS géré avec double compte.

  • Si vous utilisez un secret générique, la valeur du secret doit respecter le format JSON suivant.

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

• Langage de programmation pris en charge : Java 8 ou version ultérieure.

• Pools de connexions à la base de données pris en charge : c3p0, DBCP, HikariCP et Druid.

Scénario 1 : Récupérer des secrets via une passerelle partagée

Les types de réseau pris en charge sont le réseau public et le VPC. Cette méthode prend en charge les méthodes d'authentification basées sur RAM, telles que le rôle RAM d'instance ECS, RamRoleArn, un jeton STS et un AccessKey. Pour plus d'informations, consultez Gérer les identifiants d'accès.

Scénario 2 : Récupérer des secrets à l'aide d'une passerelle dédiée (déconseillé)

Le type de réseau est un réseau privé KMS et ClientKey est le seul identifiant d'accès pris en charge.

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-secretsmanager-jdbc</artifactId>
    <version>x.x.x</version>
</dependency>
<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core</artifactId>
  <version>4.x.x</version>
</dependency>

Se connecter à une base de données via JDBC

• Base de données MySQL

  Remarque

  Remplacez #your-mysql-secret-name#, <your-mysql-ip>, <your-mysql-port> et <your-database-name> par le nom réel du secret, l'adresse IP du serveur, le port et le nom de la base de données.

  import java.sql.Connection;
  import java.sql.DriverManager;
  import java.sql.SQLException;
  
  public class SecretManagerJDBCSample {
      public static void main(String[] args) throws Exception {
          // Load the Alibaba Cloud secrets JDBC driver: 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();
          }
      }
  }

• Base de données SQL Server

  Remarque

  Remplacez #your-sqlserver-secret-name#, <your-sqlserver-ip>, <your-sqlserver-port> et <your-database-name> par le nom réel du secret, l'adresse IP du serveur, le port et le nom de la base de données.

  import java.sql.Connection;
  import java.sql.DriverManager;
  import java.sql.SQLException;
  
  public class SecretManagerJDBCSqlServerSample {
  
      public static void main(String[] args) throws Exception{
          // Load the Alibaba Cloud secrets JDBC driver: 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();
          }
      }
  }

• Base de données PostgreSQL

  Remarque

  Remplacez #your-postgresql-secret-name#, <your-postgresql-ip>, <your-postgresql-port> et <your-database-name> par le nom réel du secret, l'adresse IP du serveur, le port et le nom de la base de données.

  import java.sql.Connection;
  import java.sql.DriverManager;
  import java.sql.SQLException;
  
  public class SecretManagerJDBCPostgreSQLSample {
      public static void main(String[] args) throws Exception {
          // Load the Alibaba Cloud secrets JDBC driver: 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();
          }
      }
  }

• Base de données MariaDB

  Remarque

  Remplacez #your-mariadb-secret-name#, <your-mariadb-ip>, <your-mariadb-port> et <your-database-name> par le nom réel du secret, l'adresse IP du serveur, le port et le nom de la base de données.

  import java.sql.Connection;
  import java.sql.DriverManager;
  import java.sql.SQLException;
  
  public class SecretManagerJDBCMarialDBSample {
  
  	public static void main(String[] args) throws Exception{
  		// Load the Alibaba Cloud secrets JDBC driver: 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();
  		}
  	}
  }

Se connecter via un pool de connexions

Définissez les paramètres c3p0.user, c3p0.driverClass et c3p0.jdbcUrl dans le fichier de configuration c3p0.properties. Le paramètre c3p0.user correspond au nom du secret, c3p0.driverClass indique le nom de la classe du pilote JDBC des secrets Alibaba Cloud, et c3p0.jdbcUrl doit commencer par secrets-manager.

• Base de données MySQL

  Remarque

  Remplacez #your-mysql-secret-name#, <your-mysql-ip>, <your-mysql-port> et <your-database-name> par le nom réel du secret, l'adresse IP du serveur, le port et le nom de la base de données.

  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>

• Base de données SQL Server

  Remarque

  Remplacez #your-sqlserver-secret-name#, <your-sqlserver-ip>, <your-sqlserver-port> et <your-database-name> par le nom réel du secret, l'adresse IP du serveur, le port et le nom de la base de données.

  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>

• Base de données PostgreSQL

  Remarque

  Remplacez #your-postgresql-secret-name#, <your-postgresql-ip>, <your-postgresql-port> et <your-database-name> par le nom réel du secret, l'adresse IP du serveur, le port et le nom de la base de données.

  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>

• Base de données MariaDB

  Remarque

  Remplacez #your-mariadb-secret-name#, <your-mariadb-ip>, <your-mariadb-port> et <your-database-name> par le nom réel du secret, l'adresse IP du serveur, le port et le nom de la base de données.

  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>

Se connecter via une source de données

Cet exemple utilise une source de données ComboPooledDataSource c3p0 et une base de données MySQL. Ajoutez la configuration suivante au fichier de configuration 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>

Connexion à l'aide d'un pool de connexions Druid

Cet exemple utilise une base de données MySQL. Vous devez modifier les propriétés suivantes dans le fichier de configuration.

• Utilisation d'un fichier de configuration 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>

• Utilisation de la configuration bean

  • Méthode 1 : Fichier de configuration 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>
    

  • Méthode 2 : Injection de propriété

    Créez une classe de configuration dans votre application pour charger les informations de connexion à la base de données.

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