V1.0 SDK 預設採用HTTP協議。若您需要使用更安全的HTTPS協議,請根據本文指引進行配置。
配置方式
請求的協議支援兩種配置方式,優先順序順序為高到低:
通過OpenAPI Request類的執行個體調用
setSysProtocol()方法進行配置,僅對當前請求生效。範例程式碼如下:說明每個OpenAPI都有獨立的Request類,命名方式為:${OpenAPI}${Request},例如DescribeInstancesRequest。
com.aliyuncs.ecs.model.v20140526.DescribeInstancesRequest request = new com.aliyuncs.ecs.model.v20140526.DescribeInstancesRequest(); request.setSysProtocol(com.aliyuncs.http.ProtocolType.HTTPS);通過
com.aliyuncs.http.HttpClientConfig類的setProtocolType()方法進行配置,全域生效。範例程式碼如下:com.aliyuncs.http.HttpClientConfig clientConfig = com.aliyuncs.http.HttpClientConfig.getDefault(); clientConfig.setProtocolType(com.aliyuncs.http.ProtocolType.HTTPS);
重要
使用 HTTPS 協議訪問 OpenAPI 時,SDK 會預設開啟校正 SSL/TLS 認證有效性,若您代碼環境沒有認證環境,則會報錯認證校正失敗。
為保障生產環境通訊安全,建議您保持開啟,若在測試環境必須忽略認證校正,可以通過以下參數設定:
com.aliyuncs.http.HttpClientConfig clientConfig = com.aliyuncs.http.HttpClientConfig.getDefault();
// 設定不校正服務端認證
clientConfig.setIgnoreSSLCerts(true)