Improve error message when a node with an incorrectly configured certificate attempts to connect

[akolarkunnu]

Description

Updated the error message to understand what is the exact reason of error and renamed the API name to match the intention of API.

Issues Resolved

Resolves #4601

Testing

Ran the unit tests

Check List

• [ x] New functionality includes testing
• New functionality has been documented
• New Roles/Permissions have a corresponding security dashboards plugin PR
• [ x] API changes companion pull request created
• [ x] Commits are signed per the DCO using --signoff

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.
For more information on following Developer Certificate of Origin and signing off your commits, please check here.

[akolarkunnu]

This is breaking change because of renaming of API. When I backport this, I will keep the existing API as such and introduce this as a new API, so that it won't break anything.

[akolarkunnu]

Can anyone please approve to start workflow(test execution) ?

[willyborankin]

@akolarkunnu, could you please fix code formatting? (gradle spotlessCheck spotlessApply)

[akolarkunnu]

@akolarkunnu, could you please fix code formatting? (gradle spotlessCheck spotlessApply)

Fixed the formatting. I feel it's good to list all Code Hygiene checks in the Developer Guide as a pre-commit activity, so that new comers will do that before creating the PR.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 70.75%. Comparing base (7692d77) to head (9ecd5f4).
Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4818      +/-   ##
==========================================
+ Coverage   70.71%   70.75%   +0.04%     
==========================================
  Files         310      310              
  Lines       20938    20938              
  Branches     3326     3326              
==========================================
+ Hits        14806    14815       +9     
+ Misses       4384     4377       -7     
+ Partials     1748     1746       -2     

Files with missing lines	Coverage Δ
...g/opensearch/security/ssl/util/ExceptionUtils.java	52.17% <100.00%> (ø)
...rch/security/transport/SecurityRequestHandler.java	55.03% <100.00%> (ø)

... and 2 files with indirect coverage changes

[willyborankin]

@nibix could you plz aprrove it one more time and I will merge it