Par défaut, le SDK V2.0 accède aux services Alibaba Cloud via HTTPS. Pour changer de protocole, définissez le paramètre protocol de la classe com.aliyun.teaopenapi.models.Config sur HTTP ou HTTPS. Nous recommandons d'utiliser HTTPS pour sécuriser les transmissions de données.
com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config();
config.setProtocol("HTTPS");
Le SDK vérifie automatiquement les certificats SSL/TLS pour les connexions HTTPS. Si votre environnement ne dispose pas des certificats requis, cette vérification peut échouer. Utilisez le paramètre ignoreSSL de la classe com.aliyun.teautil.models.RuntimeOptions pour ignorer la validation des certificats. Par exemple, définissez ignoreSSL sur true dans un environnement de préproduction afin de contourner la vérification lors des tests.
Activez la validation des certificats SSL/TLS dans les environnements de production.
com.aliyun.teautil.models.RuntimeOptions runtimeOptions = new com.aliyun.teautil.models.RuntimeOptions();
// true: skip certificate validation, false: validate certificates (default is false)
runtimeOptions.ignoreSSL = true;Problèmes courants liés aux connexions HTTPS
Erreur « Connection reset » signalée par le client Java
Les applications Java appelant des API via HTTPS peuvent rencontrer une erreur Connection reset ou javax.net.ssl.SSLException, même si l'URL fonctionne correctement dans un navigateur. Ce problème survient généralement lorsque la version TLS par défaut de l'environnement d'exécution Java ne correspond pas à celle exigée par le serveur.
Cause racine
JDK 7 et les versions antérieures utilisent TLS 1.0 par défaut, tandis que JDK 8 utilise TLS 1.2.
Le serveur cible a désactivé TLS 1.0 et TLS 1.1, et prend uniquement en charge TLS 1.2 ou supérieur.
Contrairement aux navigateurs qui négocient automatiquement la version TLS la plus élevée disponible, les clients Java s'appuient sur la configuration par défaut du JDK, ce qui peut entraîner des incompatibilités.
Solution
Après avoir créé un objet Config, spécifiez explicitement la version TLS 1.2 au moyen d'un argument JVM ou directement dans le code.
-
Option 1 : Définir un argument de démarrage JVM
Ajoutez le paramètre suivant à votre commande de démarrage :
java -Dhttps.protocols=TLSv1.2 -jar your-app.jar -
Option 2 : Spécifier la version TLS dans le code
// Set the system property at the program entry point System.setProperty("https.protocols", "TLSv1.2");
Une fois la modification appliquée, redémarrez votre application et vérifiez que les appels HTTPS aboutissent. Si les erreurs persistent, assurez-vous que les versions TLS et les suites cryptographiques prises en charge par le serveur cible sont compatibles avec votre environnement Java.