Add support for Microsoft AD FS

[jtnord]

Enable the plugin to work with AD FS which sends the user back to securityRealm/finishLogin with a HTTP Post.

Adds a Crumb exclusion extension for this endpoint.
Extract any POST data provided into a fake URL so it can be fed to the google code in a way that it can work with
Adds some rudimentary docs

fixes #352

Testing done

• setup a local LAB ADFS (OMG!) and configured the plugin to use it.
• validated I can login and obtain groups.
• unit test for the crumb exclusion

Submitter checklist

• Make sure you are opening from a topic/feature/bugfix branch (right side) and not your main branch!
• Ensure that the pull request title represents the desired changelog entry
• Please describe what you did
• Link to relevant issues in GitHub or Jira
• Link to relevant pull requests, esp. upstream and downstream changes
• Ensure you have provided tests - that demonstrates feature works or fixes the issue

[jtnord]

unrelated to the change, but due to eclipse-m2e/m2e-core/issues/1291 would cause an error in the project in eclipse.

[codecov]

Codecov Report

Attention: Patch coverage is 95.23810% with 1 line in your changes missing coverage. Please review.

Project coverage is 71.88%. Comparing base (b7205f1) to head (a08b47e).
Report is 22 commits behind head on master.

Files	Patch %	Lines
...ain/java/org/jenkinsci/plugins/oic/OicSession.java	91.66%	1 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##             master     #368      +/-   ##
============================================
- Coverage     72.02%   71.88%   -0.14%     
- Complexity      234      239       +5     
============================================
  Files            11       12       +1     
  Lines           990     1010      +20     
  Branches        142      145       +3     
============================================
+ Hits            713      726      +13     
- Misses          199      206       +7     
  Partials         78       78              

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

[jtnord]

@michael-doubez the metrics for code coverage appear broken.

https://app.codecov.io/gh/jenkinsci/oic-auth-plugin/pull/368?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=checks&utm_campaign=pr+comments&utm_term=jenkinsci#7dda26682abc4c20fa99de9ee4c7c0aa-L1423 is showing -0.75% coverage (src/main/java/org/jenkinsci/plugins/oic/OicSecurityRealm.java) yet this class in unchanged nor do any changes in test or production code affect it..

The base used for the diff is 11 commits behind master, yet the base for this PR is jtnord@3df5338 which is the same as jenkinsci/master at the time of writing this.

https://app.codecov.io/gh/jenkinsci/oic-auth-plugin is having the last report as b7205f1 so this PR is being penalised for all other changes on master since that was merged.

[jtnord]

code coverage upload is failing on the master branch

Error: Codecov token not found. Please provide Codecov token with -t flag.
Warning: Codecov: Failed to properly create commit: The process '/home/runner/work/_actions/codecov/codecov-action/v4/dist/codecov' failed with exit code 1

#369

[michael-doubez]

LGTM