Skip to content

docs: clarify Temporal Cloud endpoint and auth method pairing#1709

Open
cheelim1 wants to merge 3 commits into
kedacore:mainfrom
cheelim1:docs/temporal-endpoint-auth-clarity
Open

docs: clarify Temporal Cloud endpoint and auth method pairing#1709
cheelim1 wants to merge 3 commits into
kedacore:mainfrom
cheelim1:docs/temporal-endpoint-auth-clarity

Conversation

@cheelim1

Copy link
Copy Markdown

Temporal Cloud requires different endpoints depending on the authentication method, but the current docs don't mention this. This causes user confusion — for example, using the mTLS endpoint (tmprl.cloud) with API key auth results in tls: certificate required errors.

Changes

  • Endpoint parameter description: Added Temporal Cloud endpoint format guidance for both API key and mTLS auth, including the HA namespace recommendation
  • Authentication callout: Added a blockquote in the Authentication Parameters section summarizing the two auth paths and their required endpoints
  • mTLS example: Added a complete mTLS example (Secret, TriggerAuthentication, ScaledObject) alongside the existing API key example
  • API key example: Updated to show the Temporal Cloud endpoint format with comments for both self-hosted and cloud variants

All endpoint formats verified against Temporal Cloud namespaces documentation.

Checklist

  • Commits are signed with Developer Certificate of Origin (DCO)

Relates to kedacore/keda#7443

@cheelim1 cheelim1 requested a review from a team as a code owner February 27, 2026 08:44
@github-actions

Copy link
Copy Markdown

Thank you for your contribution! 🙏 We will review your PR as soon as possible.

While you are waiting, make sure to:

  • Add your contribution to all applicable KEDA versions
  • GitHub checks are passing
  • Is the DCO check failing? Here is how you can fix DCO issues

Learn more about:

@netlify

netlify Bot commented Feb 27, 2026

Copy link
Copy Markdown

Deploy Preview for keda ready!

Name Link
🔨 Latest commit 47530cc
🔍 Latest deploy log https://app.netlify.com/projects/keda/deploys/69dc5b2ffd8fd300084fe4c8
😎 Deploy Preview https://deploy-preview-1709--keda.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@rickbrouwer rickbrouwer left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks a lot!

Temporal Cloud requires different endpoints depending on the
authentication method: API key auth uses regional api.temporal.io
endpoints, while mTLS auth uses namespace tmprl.cloud endpoints.
For HA namespaces with API key auth, the namespace endpoint is
recommended instead. Using the wrong combination causes connection
errors such as "tls: certificate required".

- Add endpoint format guidance to the endpoint parameter description
- Add Temporal Cloud authentication callout with HA note
- Add complete mTLS example alongside the existing API key example
- Update API key example to show Temporal Cloud endpoint format

Relates to: kedacore/keda#7443

Signed-off-by: CL <cheelim126@gmail.com>
@cheelim1 cheelim1 force-pushed the docs/temporal-endpoint-auth-clarity branch from 9920b19 to 2a220a7 Compare February 27, 2026 09:34
@cheelim1 cheelim1 requested a review from rickbrouwer February 27, 2026 09:34
@cheelim1

cheelim1 commented Feb 27, 2026

Copy link
Copy Markdown
Author

@rickbrouwer noticed my previous commit was unsigned, i re-signed it.

@rickbrouwer

rickbrouwer commented May 8, 2026

Copy link
Copy Markdown
Member

@carlydf

I appreciate your reviews in the Temporal area. Is this one accurate and correct to you?

@cheelim1

Copy link
Copy Markdown
Author

@rickbrouwer @carlydf any concerns with this PR ?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants