NIFI-12173 - Nifi Registry there's no documentation about OIDC connection

[marcelo225]

Summary

NIFI-12173

Tracking

Please complete the following tracking steps prior to pull request creation.

Issue Tracking

• Apache NiFi Jira issue created

Pull Request Tracking

• Pull Request title starts with Apache NiFi Jira issue number, such as NIFI-12173
• Pull Request commit message starts with Apache NiFi Jira issue number, as such NIFI-12173

Pull Request Formatting

• Pull Request based on current revision of the main branch
• Pull Request refers to a feature branch with one commit containing changes

Verification

Please indicate the verification steps performed prior to pull request creation.

Build

• Build completed using mvn clean install -P contrib-check
  • JDK 21

Licensing

• New dependencies are compatible with the Apache License 2.0 according to the License Policy
• New dependencies are documented in applicable LICENSE and NOTICE files

Documentation

• Documentation formatting appears as expected in rendered files

[exceptionfactory]

Thanks for proposing this improvement @marcelo225, this is definitely an area where NiFi Registry is lacking documentation.

Unfortunately, the Registry implementation of OpenID Connect has some notable differences from NiFi itself, so the documentation section from the NiFi Admin Guide cannot be copied and pasted. In order to make some progress, however, removing the descriptive paragraphs and starting with just the table of properties would be helpful.

If you are interested in digging into the Registry OIDC implementation and updating the description to match, that's great. On the other hand, if you would like to move forward incrementally, focusing on the properties would be the best option.

[exceptionfactory]

@marcelo225 On further review, removing several paragraphs copied from the NiFi description should be sufficient for this documentation update to proceed. Please see the detailed comments, thanks!

[marcelo225]

@exceptionfactory I'm done with it!

[exceptionfactory]

Thanks for making the adjustments @marcelo225, the latest version looks good! +1 merging