TLS 1.3 compatibility issue with Oracle 21c - ORA-29019 protocol version error #159
Description
Problem Summary
When using JasperReportsIntegration 3.0.0 with Oracle Database 21c and a Tomcat server configured for TLS 1.3 only, the report generation fails with the error:
ORA-29019: The protocol version is incorrect
Environment Details
Oracle Database: 21c Express Edition Release 21.0.0.0.0 - Production
JRI Version: 3.0.0-jasper-7.0.1
Tomcat Version: 9 with TLS 1.3 enabled
Java Version: 8u261+ or 11+ (supporting TLS 1.3)
Network: Oracle database container connecting to Tomcat container via HTTPS
Root Cause Analysis
The issue occurs because:
Tomcat Configuration: Server is configured to use TLS 1.3 only (as per security requirements)
Oracle UTL_HTTP Behavior: Oracle 21c's UTL_HTTP by default attempts to negotiate TLS 1.2
Protocol Mismatch: When Oracle tries to connect with TLS 1.2, the Tomcat server rejects the connection
Error Result: This results in the "ORA-29019: The protocol version is incorrect" error