feat: add keycloak auth provider options

[nilivingston]

Description

Adds auth provider options for Keycloak to security/manager.py. Update example oauth/config.py to include "keycloak" and "keycloak_before_17" providers to demonstrate working configurations for Keycloak both before and after its version 17 API changes. Example config changes added to docs/security.rst as well.

Working out the necessary parameters for Keycloak integration was time consuming. Hopefully this configuration update and accompanying examples will make this process easier for other users.

ADDITIONAL INFORMATION

• Has associated issue:
• Is CRUD MVC related.
• Is Auth, RBAC security related.
• Changes the security db schema.
• Introduces new feature
• Removes existing feature

[dpgaspar]

Looks good, just the comment on the docs.

We are really needing tests for all these providers

[nilivingston]

I tested the Keycloak integration manually using the Bitnami Keycloak Docker image. I'm not sure how best to develop integration tests for Keycloak and the other providers for inclusion into the automated test suite. I'll give it some thought.

[dpgaspar]

I tested the Keycloak integration manually using the Bitnami Keycloak Docker image. I'm not sure how best to develop integration tests for Keycloak and the other providers for inclusion into the automated test suite. I'll give it some thought.

That would be great, thank you once more

[dpgaspar]

@nilivingston conflict here, I merged another docs related PR. Can you fix it plz?

[nilivingston]

@nilivingston conflict here, I merged another docs related PR. Can you fix it plz?

I resolved the conflict by including both the keycloak and azure examples in security.rst. Should be good to go.