Create NamedRoute to map extension routes to a shortened name

[cwperks]

Description

This PR will allow the naming of a Route to something that can be placed in a role definition.

i.e. GET /_extensions/_hw/hello becomes hw:greet. I have been thinking about this as REST action names which would be analogous to naming Transport actions.

A role definition in the security plugin currently lists action names granted to a role, but for extensions there is no transport action that is executed so there is currently no short name that can be permitted in a roles definition. This PR creates a concept of a ProtecteedRoute (a named route) with the purpose of creating a shortened name for a route that can be granted in a roles definition similar to:

extension_hw_full:
  reserved: true
  cluster_permissions:
    - 'hw:greet'
    - 'hw:greet_with_adjective'
    - 'hw:great_with_name'
    - 'hw:goodbye'

Issues Resolved

Related to: opensearch-project/security#2589

Check List

• New functionality includes testing.
  • All tests pass
• New functionality has been documented.
  • New functionality has javadoc added
• Commits are signed per the DCO using --signoff
• Commit changes are listed out in CHANGELOG.md file (See: Changelog)

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.

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/13030/
• CommitID: ad68321
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/13186/
• CommitID: 64e8667
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/13182/
• CommitID: f1d9c71
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/13285/
• CommitID: a7f83b5
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/13759/
• CommitID: 4268341
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: UNSTABLE ❕
• TEST FAILURES:

      1 org.opensearch.search.SearchWeightedRoutingIT.testSearchAggregationWithNetworkDisruption_FailOpenEnabled

• URL: https://build.ci.opensearch.org/job/gradle-check/14441/
• CommitID: d90d065
  Please review all flaky tests that succeeded after retry and create an issue if one does not already exist to track the flaky failure.

[codecov-commenter]

Codecov Report

Merging #6870 (ccbe4b5) into main (ff138cb) will decrease coverage by 0.14%.
The diff coverage is 82.27%.

❗ Current head ccbe4b5 differs from pull request most recent head 98a9d44. Consider uploading reports for the commit 98a9d44 to get more accurate results

@@             Coverage Diff              @@
##               main    #6870      +/-   ##
============================================
- Coverage     70.74%   70.60%   -0.14%     
- Complexity    56023    59837    +3814     
============================================
  Files          4670     4898     +228     
  Lines        265699   286970   +21271     
  Branches      39015    41364    +2349     
============================================
+ Hits         187958   202615   +14657     
- Misses        61807    67656    +5849     
- Partials      15934    16699     +765     

Impacted Files	Coverage Δ
...a/org/opensearch/extensions/ExtensionsManager.java	47.69% <33.33%> (-0.19%)	⬇️
...src/main/java/org/opensearch/rest/RestHandler.java	62.26% <45.45%> (-4.41%)	⬇️
.../main/java/org/opensearch/action/ActionModule.java	94.97% <82.14%> (-0.74%)	⬇️
...a/org/opensearch/extensions/rest/RouteHandler.java	90.00% <90.00%> (ø)
...rch/extensions/rest/RestActionsRequestHandler.java	100.00% <100.00%> (ø)
.../src/main/java/org/opensearch/rest/NamedRoute.java	100.00% <100.00%> (ø)
...rch/rest/extensions/RestSendToExtensionAction.java	47.45% <100.00%> (ø)

... and 736 files with indirect coverage changes

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: SUCCESS ✅
• URL: https://build.ci.opensearch.org/job/gradle-check/15671/
• CommitID: 9ca3c90

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: UNSTABLE ❕
• TEST FAILURES:

      1 org.opensearch.index.remote.RemoteRefreshSegmentPressureServiceTests.testValidateSegmentUploadLag

• URL: https://build.ci.opensearch.org/job/gradle-check/15674/
• CommitID: c7d7c15
  Please review all flaky tests that succeeded after retry and create an issue if one does not already exist to track the flaky failure.

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: SUCCESS ✅
• URL: https://build.ci.opensearch.org/job/gradle-check/15687/
• CommitID: fd53943

[cwperks]

Thank you for all of the help on this one @reta!

[owaiskazi19]

Overall LGTM! Minor comments. Thanks @cwperks for the patience and for addressing the comments.

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: SUCCESS ✅
• URL: https://build.ci.opensearch.org/job/gradle-check/15710/
• CommitID: ccbe4b5

[cwperks]

@owaiskazi19 Final 👀 ?

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: UNSTABLE ❕
• TEST FAILURES:

      3 org.opensearch.remotestore.RemoteStoreRefreshListenerIT.testRemoteRefreshRetryOnFailure

• URL: https://build.ci.opensearch.org/job/gradle-check/15714/
• CommitID: 0ad12ee
  Please review all flaky tests that succeeded after retry and create an issue if one does not already exist to track the flaky failure.

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: SUCCESS ✅
• URL: https://build.ci.opensearch.org/job/gradle-check/15715/
• CommitID: 98a9d44