Add a post authenticaton handler to validate email domain during federated authentication

[Yasasr1]

Proposed changes in this pull request

This pr introduces a new post authentication handler to validate the email address of the user authenticated from a federated IDP.

This handler will be invoked when email domain based organization discovery is enabled to prevent user authentication and provisioning to organizations when the authenticated user's email domain does not match with any of the mapped email domains for the organization.

Related issue

• Introduce a new post authentication handler to validate email domains during federated authentication product-is#21922

[codecov]

Codecov Report

Attention: Patch coverage is 53.33333% with 63 lines in your changes missing coverage. Please review.

Project coverage is 46.26%. Comparing base (97d2cbf) to head (548cb20).
Report is 199 commits behind head on master.

Files with missing lines	Patch %	Lines
...ler/request/impl/EmailDomainValidationHandler.java	52.94%	28 Missing and 12 partials ⚠️
.../authentication/framework/util/FrameworkUtils.java	55.17%	9 Missing and 4 partials ⚠️
.../framework/internal/FrameworkServiceComponent.java	0.00%	10 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##             master    #6177      +/-   ##
============================================
+ Coverage     45.83%   46.26%   +0.42%     
+ Complexity    15127    15072      -55     
============================================
  Files          1736     1729       -7     
  Lines        107598   106789     -809     
  Branches      19666    18958     -708     
============================================
+ Hits          49320    49406      +86     
+ Misses        51246    50342     -904     
- Partials       7032     7041       +9     

Flag	Coverage Δ
unit	30.36% <53.33%> (+0.10%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[Yasasr1]

All above comments are addressed with a338dc7

[jenkins-is-staging]

PR builder started
Link: https://github.com/wso2/product-is/actions/runs/12822007199

[jenkins-is-staging]

PR builder completed
Link: https://github.com/wso2/product-is/actions/runs/12822007199
Status: success

[jenkins-is-staging]

Approving the pull request based on the successful pr build https://github.com/wso2/product-is/actions/runs/12822007199

[jenkins-is-staging]

PR builder started
Link: https://github.com/wso2/product-is/actions/runs/12928228163

[jenkins-is-staging]

PR builder completed
Link: https://github.com/wso2/product-is/actions/runs/12928228163
Status: failure

[jenkins-is-staging]

PR builder started
Link: https://github.com/wso2/product-is/actions/runs/12981418922

[jenkins-is-staging]

PR builder completed
Link: https://github.com/wso2/product-is/actions/runs/12981418922
Status: failure

[jenkins-is-staging]

PR builder started
Link: https://github.com/wso2/product-is/actions/runs/12982588441

[jenkins-is-staging]

PR builder completed
Link: https://github.com/wso2/product-is/actions/runs/12982588441
Status: failure

[jenkins-is-staging]

PR builder started
Link: https://github.com/wso2/product-is/actions/runs/12984901106

[sonarqubecloud]

Quality Gate passed

Issues
5 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.5% Duplication on New Code

See analysis details on SonarQube Cloud

[jenkins-is-staging]

PR builder completed
Link: https://github.com/wso2/product-is/actions/runs/12984901106
Status: success

[jenkins-is-staging]

Approving the pull request based on the successful pr build https://github.com/wso2/product-is/actions/runs/12984901106

[jenkins-is-staging]

PR builder started
Link: https://github.com/wso2/product-is/actions/runs/12986542130

[jenkins-is-staging]

PR builder completed
Link: https://github.com/wso2/product-is/actions/runs/12986542130
Status: success

[jenkins-is-staging]

Approving the pull request based on the successful pr build https://github.com/wso2/product-is/actions/runs/12986542130