Configure HTTPS for V1.0 SDK (Java) - Alibaba Cloud SDK: Central de Documentação do Alibaba Cloud

O kit de desenvolvimento de software (SDK) V1.0 usa o protocolo HTTP por padrão. Este tópico descreve como configure o SDK para usar o protocolo HTTPS, mais seguro.

Métodos de configuração

Você pode configure o protocolo da solicitação de duas maneiras, listadas em ordem decrescente de prioridade:

Chame o método setSysProtocol() em uma instância da classe Request do OpenAPI. Essa configuração se aplica apenas à solicitação atual. Exemplo:

Nota
Cada operação do OpenAPI tem uma classe Request exclusiva. O nome da classe segue o formato ${OpenAPI}${Request}, como DescribeInstancesRequest.
```
com.aliyuncs.ecs.model.v20140526.DescribeInstancesRequest request = new com.aliyuncs.ecs.model.v20140526.DescribeInstancesRequest();
request.setSysProtocol(com.aliyuncs.http.ProtocolType.HTTPS);
```

Chame o método setProtocolType() da classe com.aliyuncs.http.HttpClientConfig. Essa configuração tem efeito global. Exemplo:

com.aliyuncs.http.HttpClientConfig clientConfig = com.aliyuncs.http.HttpClientConfig.getDefault();
clientConfig.setProtocolType(com.aliyuncs.http.ProtocolType.HTTPS);

Importante

Por padrão, ao enviar uma solicitação de API via HTTPS, o SDK ativa a verificação de certificados para validar os certificados SSL/TLS. Se nenhum certificado SSL/TLS estiver configurado no ambiente de desenvolvimento, o sistema relatará um erro de falha na verificação do certificado.

Para garantir a segurança da comunicação de rede, recomendamos manter a verificação de certificados ativada. Se for necessário desativar essa verificação no ambiente de teste, use as seguintes configurações de parâmetro:

com.aliyuncs.http.HttpClientConfig clientConfig = com.aliyuncs.http.HttpClientConfig.getDefault();
// Disable server-side certificate validation.
clientConfig.setIgnoreSSLCerts(true)