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);
}
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.
Instances sayfasında Software Key Management veya Hardware Key Management sekmesini tıklayın ve ardından hedef KMS örneğini seçin.
Ö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.combiç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.
Instances sayfasında Software Key Management veya Hardware Key Management sekmesini tıklayın ve ardından hedef KMS örneğini seçin.
-
Ö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.