使用PHP配置並初始化KMS執行個體SDK用戶端-Key Management Service-阿里雲

使用KMS執行個體SDK發起KMS執行個體API請求前，您需要初始化用戶端。本文介紹如何初始化用戶端。

初始化用戶端

<?php

use AlibabaCloud\Dkms\Gcs\Sdk\Client as AlibabaCloudDkmsGcsSdkClient;
use AlibabaCloud\Dkms\Gcs\OpenApi\Models\Config as AlibabaCloudDkmsGcsOpenApiConfig;


function getDkmsGcsSdkClient()
{
    global $clientKeyContent, $password, $endpoint;

    // 構建KMS執行個體SDK Client配置
    $config = new AlibabaCloudDkmsGcsOpenApiConfig();
    //連線協定請設定為"https"。KMS執行個體服務僅允許通過HTTPS協議訪問。
    $config->protocol = 'https';
    //Client Key。
    $config->clientKeyContent = $clientKeyContent;
    //Client Key口令。
    $config->password = $password;
    //設定endpoint為<your KMS Instance Id>.cryptoservice.kms.aliyuncs.com。
    $config->endpoint = $endpoint;
    // 執行個體CA認證
    $config->caFilePath = 'path/to/caCert.pem';

    // 構建KMS執行個體SDK Client對象
    return new AlibabaCloudDkmsGcsSdkClient($config);
}

重要

設定執行個體CA認證是為保障生產環境通訊安全，其重要作用在於驗證SSL/TLS認證的有效性，建議您始終保持此功能開啟。如您確有需要關閉驗證SSL/TLS認證，例如線下測試情境，可通過將運行時參數RuntimeOptions的ignoreSSL欄位設定為true實現。

變數說明

endpoint

即KMS執行個體網域名稱地址。

在实例管理頁面，單擊软件密钥管理或硬件密钥管理頁簽後，選擇目標KMS執行個體。
單擊執行個體ID進入到詳情頁，查看实例VPC地址。

clientKeyContent

即應用身份憑證的路徑。建立ClientKey後瀏覽器會自動下載，檔案名稱預設為clientKey_****.json。

password

即ClientKey的口令。建立ClientKey後瀏覽器會自動下載，檔案名稱預設為clientKey_****_Password.txt。

caFilePath

KMS執行個體CA認證。

在实例管理頁面，單擊获取实例CA证书地區的下载。
在获取实例CA证书對話方塊中選擇執行個體ID，單擊下载並妥善保管。
CA認證下載後檔案名稱預設為PrivateKmsCA_kst-******.pem。