Inicializar el cliente

Para solicitar la API de instancia de KMS con el SDK, primero debe inicializar un cliente.

import com.aliyun.dkms.gcs.openapi.models.Config;
import com.aliyun.dkms.gcs.sdk.Client;
 public static void initClient() throws Exception {
        // The protocol must be "https". The KMS instance service only allows access over HTTPS.
        Config config = new Config();
        config.setProtocol("https");
        // Path to the ClientKey file.
        config.setClientKeyFile("<YOUR_CLIENT_KEY_FILE>");
         // Password for the ClientKey.
        config.setPassword("<YOUR_PASSWORD>");
         // Set the endpoint to <your-kms-instance-id>.cryptoservice.kms.aliyuncs.com.
        config.setEndpoint("<YOUR_ENDPOINT>");
        // The CA certificate of the KMS instance. You can specify a file path or the content directly.
        config.setCaFilePath("<PATH_TO_YOUR_CACERT>");
        // Alternatively, you can set the CA certificate content.
        //config.setCa("<your-ca-certificate-content");
        client = new Client(config);
    }

Importante

Un certificado de CA es fundamental para proteger la comunicación en un entorno de producción, ya que valida la autenticidad del certificado SSL/TLS. Se recomienda mantener siempre habilitada esta verificación. Si necesita deshabilitar la verificación del certificado SSL/TLS, por ejemplo, en un entorno de pruebas sin conexión, establezca el campo IgnoreSSL del parámetro RuntimeOptions en true.

Parámetros

Endpoint

El nombre de dominio de la instancia de KMS.

En la página Instances, haga clic en la pestaña Software Key Management o Hardware Key Management y seleccione la instancia de KMS deseada.
Haga clic en el ID de la instancia para ir a la página de detalles y consulte el Instance VPC Endpoint. En la sección Basic Information de la página de detalles de la instancia, revise el campo Instance VPC Endpoint. Esta dirección corresponde al endpoint de la instancia y tiene un formato como kst-xxx.cryptoservice.kms.aliyuncs.com.

Ruta del archivo ClientKey

La ruta al archivo de credenciales de su aplicación. Al crear una ClientKey, el navegador descarga el archivo automáticamente. El nombre predeterminado del archivo es clientKey_****.json.

Contraseña

La contraseña de la ClientKey. Al crear una ClientKey, el navegador descarga automáticamente un archivo de contraseña. El nombre predeterminado del archivo es clientKey_****_Password.txt.

Ca y caFilePath

El certificado de CA de la instancia de KMS.

En la página Instances, haga clic en la pestaña Software Key Management o Hardware Key Management y seleccione la instancia de KMS deseada.
Haga clic en el ID de la instancia o en Details en la columna Actions. En la página Details, dentro de la sección Instance CA Certificate, haga clic en Download y guarde el certificado de forma segura.

Nota
El archivo de certificado de CA descargado se denomina PrivateKmsCA_kst-******.pem de forma predeterminada.