fix: improvements to the oidc document

[hamza-m-masood]

Description

related: #4619 (comment)

When should this change go live?

• This is a bug fix, security concern, or something that needs urgent release support. (add bug or support label)
• This is already available but undocumented and should be released within a week. (add available & undocumented label)
• This is on a specific schedule and the assignee will coordinate a release with the DevEx team. (create draft PR and/or add hold label)
• This is part of a scheduled alpha or minor. (add alpha or minor label)
• There is no urgency with this change (add low prio label)

PR Checklist

• My changes are for an upcoming minor release and:
  • are in the /docs directory (version 8.8).
  • are in the /versioned_docs/version-8.7/ directory (version 8.7).
• My changes are for an already released minor and are in a /versioned_docs directory.

• I added a DRI, team, or delegate as a reviewer for technical accuracy and grammar/style:
  • Engineering team review
  • Technical writer review via @camunda/tech-writers unless working with an embedded writer.

[github-actions]

👋 🤖 ✅ Looks like the changes were ported across versions, nice job! 🎉

You can read more about the versioning within our docs in our documentation guidelines.

[conceptualshark]

@hamza-m-masood Thank you for taking a look at this page! Can you add labels around which releases this should apply to? Right now the changes are only in 8.7, should they be mirrored in 8.8 (and updated later if 8.8 changes this process)?

[conceptualshark]

I've taken an editing pass over this, but do want to confirm if it should also be included in 8.8, or backported to previous versions.

Are there other reviewers familiar with OIDC setup that might be valuable to add here?

[hamza-m-masood]

@conceptualshark These changes need to be moved to 8.8 and 8.6.

The guide for 8.8 will need to be reworked before being released anyway. To my knowledge, nobody has tested OIDC on 8.8 yet. I don't even think OIDC is supported on 8.8 yet.

I just did not have the time to move the changes to other version since I'm busy with other tasks.

[conceptualshark]

@hamza-m-masood I've backported this to 8.6, and also moved it into 8.8 to keep things consistent. Whether or not it will be the same in the final state, it will keep the information available/consistent until we update it.

@Ben-Sheppard Is this something you would be able to take a look at, or assign a reviewer who might be able to validate from the Identity end? Thank you!

[Ben-Sheppard]

Hi @conceptualshark :) - I can validate the changes but it will be tomorrow if thats ok?

[akeller]

Hi Folks, this came from a support engagement so I'd like to see that we make progress on this and get something merged and released soon. @Ben-Sheppard will you be able to review this ASAP (tomorrow, not now if you see this 😅 )?