El kit de desarrollo de software (SDK) V1.0 usa el protocolo HTTP de forma predeterminada. Este tema describe cómo configurar el SDK para usar el protocolo HTTPS, que es más seguro.
Métodos de configuración
El protocolo de la solicitud se puede configurar de dos maneras. Los métodos se enumeran en orden descendente de prioridad:
-
Puede llamar al método
setSysProtocol()en una instancia de la clase Request de OpenAPI. Esta configuración se aplica solo a la solicitud actual. A continuación se muestra un ejemplo de código:NotaCada operación de OpenAPI tiene una clase Request única. El nombre de la clase sigue el formato
${OpenAPI}${Request}, por ejemplo,DescribeInstancesRequest.com.aliyuncs.ecs.model.v20140526.DescribeInstancesRequest request = new com.aliyuncs.ecs.model.v20140526.DescribeInstancesRequest(); request.setSysProtocol(com.aliyuncs.http.ProtocolType.HTTPS); -
Puede llamar al método
setProtocolType()de la clasecom.aliyuncs.http.HttpClientConfig. Esta configuración se aplica globalmente. El código que se muestra a continuación proporciona un ejemplo:com.aliyuncs.http.HttpClientConfig clientConfig = com.aliyuncs.http.HttpClientConfig.getDefault(); clientConfig.setProtocolType(com.aliyuncs.http.ProtocolType.HTTPS);
De forma predeterminada, si envía una solicitud de API a través de HTTPS, el SDK habilita la verificación de certificados para que se compruebe la validez de los certificados SSL/TLS. Si no se configura ningún certificado SSL/TLS en el entorno de desarrollo, se notifica un error que indica que la verificación del certificado falló.
Se recomienda que, para garantizar la seguridad de la comunicación de red, habilite la verificación de certificados. Si necesita deshabilitarla en el entorno de pruebas, deshabilite la verificación de certificados mediante la configuración de parámetros que se muestra a continuación:
com.aliyuncs.http.HttpClientConfig clientConfig = com.aliyuncs.http.HttpClientConfig.getDefault();
// Disable server-side certificate validation.
clientConfig.setIgnoreSSLCerts(true)