docs(web-modeler): clarify Web Modeler public API OIDC setup

[wollefitz]

Description

Closes https://github.com/camunda/web-modeler/issues/13603

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.

[wollefitz]

@ingorichtsmeier Small ping to have a look at this

@jfriedenstab feel free to hand over to another WMC engineer in case you don't have the capacity to review.

[ingorichtsmeier]

Hi @wollefitz, I would recommend changing the names of the APIs to distinguish them clearly. I thought a while about them, and for our users, it is easier to name them the Web Modeler API (to support the Web Modeler User interface) and Web Modeler REST API (for public access).

The client ID needs a clarification, too. Which one is really required and is used in the code? The ID of the confidential client or the ID of the public client?

All values are created in step 3. (For the GENERIC configuration)

[jfriedenstab]

Sorry for the delayed review!

[wollefitz]

@ingorichtsmeier @jfriedenstab Thanks for the thorough review - I made the suggested adjustments. Could you have another look?

[jfriedenstab]

Looks good to me! 👍🏻

[ingorichtsmeier]

Much better than before.

[wollefitz]

@camunda/tech-writers I'll go ahead and merge this as this is mainly a technical change. If you identify something that has to be changed retroactively I'm happy to adjust!

[github-actions]

🧹 Preview environment for this PR has been torn down.