Add the REST config to the Ingress guides

[conceptualshark]

Description

Relates to #4137
This addresses:

• adding the Zeebe REST API configuration into the Ingress guides
• adding a note that the ingress path should match the context path to the (pre-8.7 combined) Ingress guides
• linking to the ingress config, clarify the context path is for Zeebe Gateway, and update organization of the context path section in the Zeebe REST API overview

I've added these changes to the available documentation, back through 8.5 for the Ingress docs - prior to that the formatting changes.

I've added these options into /next assuming that if the /v1 APIs remain available, it will still be useful, and if they're removed, we can address removing it at the same time as any other updates, but let me know if this isn't the right call.

When should this change go live?

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

PR Checklist

• My changes are for an already released minor and are in /versioned_docs directory.
• My changes are for the next minor and are in /docs directory (aka /next/).

• My changes require an Engineering review, and I've assigned the Engineering DRI or delegate.
• My changes require a technical writer review, and I've assigned @camunda/tech-writers as a reviewer.

[github-actions]

👋 🤖 🤔 Hello, @conceptualshark! Did you make your changes in all the right places?

These files were changed only in versioned_docs/version-8.6/. You might want to duplicate these changes in docs/.

• versioned_docs/version-8.6/apis-tools/zeebe-api-rest/zeebe-api-rest-overview.md

You may have done this intentionally, but we wanted to point it out in case you didn't. You can read more about the versioning within our docs in our documentation guidelines.

[pepopowitz]

makes sense to me, and clarifies. Thank you!

[conceptualshark]

@jessesimpson36 Would you be able to double-check the update here? Thanks!

[akeller]

I've added these options into /next assuming that if the /v1 APIs remain available, it will still be useful, and if they're removed, we can address removing it at the same time as any other updates, but let me know if this isn't the right call.

I'd like to see a member of the Zeebe team pulled in to review this, given the Zeebe REST API is actively being removed. @conceptualshark can you reach out on #ask-zeebe?

[jessesimpson36]

I read the content and verified the referenced options. This all looks good to me.

[conceptualshark]

@akeller @jessesimpson36 With the zeebe REST API officially out of the docs for /next, I've updated this PR to remove the reference and remove the config from 8.7. Do you mind double-checking for a final review?

[akeller]

Suggested change

	:::note
	**Operate, Tasklist, Optimize, Modeler, Connectors, Console:** The Ingress path value for each Component (`global.identity.auth.<component>.redirectUrl`) should match the `contextPath` for that Component.
	:::
	:::note
	**Operate, Tasklist, Optimize, Modeler, Connectors, Console:** The Ingress path value for each component (`global.identity.auth.<component>.redirectUrl`) should match the `contextPath` for that component.
	:::

[akeller]

Plus the other versions.

[akeller]

❓ For the C8 REST API (v2), do we need to add a similar change? Basically, adding info on this page with a similar link to the ingress setup instructions?

Otherwise, the changes look consistently applied across the relevant versions.

[conceptualshark]

@akeller I've updated the Camunda REST API page as described! I think this should be the last place where this info was located/unclear. 🤞

[github-actions]

🧹 Preview environment for this PR has been torn down.