Tüm Ürünler
Search
Belge Merkezi

Key Management Service:İstemciyi Başlatma

Son Güncelleme:Oct 04, 2026

SDK ile KMS örnek API istekleri yapmak için öncelikle bir istemci başlatmanız gerekir.

İstemciyi Başlatma

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);
    }
Önemli

CA sertifikası, üretim ortamında iletişimin güvenliğini sağlamak için kritiktir. SSL/TLS sertifikasının kimliğini doğrular. Bu doğrulamayı her zaman etkin tutmanızı öneririz. Çevrimdışı test ortamları gibi durumlarda SSL/TLS sertifika doğrulamasını devre dışı bırakmanız gerekirse, RuntimeOptions parametresinin IgnoreSSL alanını true olarak ayarlayabilirsiniz.

Parametreler

Uç Nokta

KMS örneğinin etki alanı adıdır.

  1. Instances sayfasında Software Key Management veya Hardware Key Management sekmesini tıklayın ve ardından hedef KMS örneğini seçin.

  2. Örnek kimliğini tıklayarak ayrıntılar sayfasına gidin ve Instance VPC Endpoint değerini görüntüleyin. Örnek ayrıntıları sayfasının Basic Information bölümünde Instance VPC Endpoint alanını görüntüleyin. Bu adres, örneğin uç noktasıdır ve kst-xxx.cryptoservice.kms.aliyuncs.com biçimindedir.

ClientKey Dosya Yolu

Uygulamanızın kimlik bilgisi dosyasının yoludur. Bir ClientKey oluşturduğunuzda, dosya tarayıcınız tarafından otomatik olarak indirilir. Varsayılan dosya adı clientKey_****.json şeklindedir.

Parola

ClientKey parolasıdır. Bir ClientKey oluşturduğunuzda, parola dosyası tarayıcınız tarafından otomatik olarak indirilir. Varsayılan dosya adı clientKey_****_Password.txt şeklindedir.

ca ve caFilePath

KMS örneğinin CA sertifikasıdır.

  1. Instances sayfasında Software Key Management veya Hardware Key Management sekmesini tıklayın ve ardından hedef KMS örneğini seçin.

  2. Örnek kimliğini tıklayın veya İşlemler sütunundaki Details seçeneğini tıklayın. Details sayfasında, Instance CA Certificate bölümünde Download seçeneğini tıklayın ve sertifikayı güvenli bir şekilde kaydedin.

    Not

    İndirilen CA sertifikası dosyasının adı varsayılan olarak PrivateKmsCA_kst-******.pem şeklindedir.