Add links to Well-Known OIDC providers doc

[sberyozkin]

Fixes #33056.

Hi @michelle-purcell @sheilamjones, it is an attempt to make the Well Known Providers doc more visible from within OIDC specific docs and sections, I've added extra links from the authentication mechanism concept doc, in the OIDC code flow concept and tutorials, and along the way updated the reference links section on the code flow tutorial (non-Quarkus doc links moved to the very end, minor optimization in the Summary section).
Have a look please.
The plan is to follow up with adding tags like google, github etc in the website for the users to immediately find the Well Known Providers doc if they type for example twitter in the Search area.
Do you think though if we can also add such tags to the Well Known Providers doc itself with this PR ?
Thanks

[github-actions]

🙈 The PR is closed and the preview is expired.

[sberyozkin]

Hey @michelle-purcell @sheilamjones I think simplest would be to add provider tags to the website, I'll follow up with another PR later

[sheilamjones]

Hi @sberyozkin,
Thanks for this update and apologies for slow reply. I will take a look this afternoon and get back to you directly.
Kind regards,
Sheila

[sberyozkin]

Hi @sheilamjones Np at all, take your time please, I'll be signing off shortly for the evening, back tomorrow morning, thanks

[michelle-purcell]

It would be great to add a mention and reference for the following topic to the Quarkus Security overview page:

xref:security-openid-connect-providers.adoc[Configuring Well-Known OpenID Connect Providers]

For example here/References link section:

[michelle-purcell]

@sberyozkin - Looks great 👍 Super job. See my comments above. Thanks.

[sheilamjones]

Thanks @sberyozkin for making these updates. They look great and also had a few small additional comments. With regards to the title of the existing [Configuring Well-Known OpenID Connect Providers] guide, would it be possible to update the title of the guide itself in this PR also to change it to sentence case, that is, "Configuring well-known OpenID Connect providers" or ""Configuring commonly-used OpenID Connect providers" if you choose that alternative term?

[sberyozkin]

Hey @michelle-purcell @sheilamjones
Looks like Configuring is now added everywhere with your suggestions, have a look please. Are you OK with retaining Well-Known (and we now have Commonly used used in one of the references as well) ? Hopefully it should be fine

[michelle-purcell]

If well-known is a well-known security term (:wink: ) familiar to Java developers who want to use/start using Quarkus then let's keep it. @sheilamjones ?

[sheilamjones]

Thanks for your updates @sberyozkin. And I am fine to keep "well-known" then too in this context. I just had a couple of additional minor comments for your consideration. Thank you :)

[sberyozkin]

Hey @michelle-purcell well-known is not really a security term, true, but IMHO this is what providers like Google etc are, they are well-known. Is commonly-used better ? May be, but is it a security term :-) ?

[sberyozkin]

Thanks @sheilamjones, done.

@sheilamjones @michelle-purcell thanks for a great review 👍 , very welcome, security docs can only become better after your reviews :-)

[sberyozkin]

Hi @gastaldi @geoand This PR has been reviewed by Michelle and Sheila, can you double check please this PR and add an approval letting me merge ? I'll follow up with another one to the website so that tags like twitter etc can be used to find the guide

[sberyozkin]

Thanks @gastaldi