Skip to content

docs: document awsExternalId parameter for cross-account AssumeRole#1754

Merged
JorTurFer merged 3 commits intokedacore:mainfrom
shivkumr:feature/aws-external-id-docs
May 3, 2026
Merged

docs: document awsExternalId parameter for cross-account AssumeRole#1754
JorTurFer merged 3 commits intokedacore:mainfrom
shivkumr:feature/aws-external-id-docs

Conversation

@shivkumr
Copy link
Copy Markdown
Contributor

Added documentation for the new awsExternalId parameter in TriggerAuthentication, which enables confused deputy protection for multi-tenant environments where a shared KEDA operator assumes roles in different AWS accounts.

Added under "Using KEDA role to assume workload role using AssumeRole" in the AWS auth provider page (docs/2.20/authentication-providers/aws.md), with:

  • Trust policy example with sts:ExternalId condition
  • TriggerAuthentication example using secretTargetRef
  • Note that awsExternalId is optional and only applies to AssumeRole (not AssumeRoleWithWebIdentity)

Checklist

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

Relates to kedacore/keda#7665

Add documentation for the new awsExternalId parameter in TriggerAuthentication,
which enables confused deputy protection for multi-tenant environments where
a shared KEDA operator assumes roles in different AWS accounts.

Relates to kedacore/keda#7665

Signed-off-by: shivkumr <shivkumr@amazon.com>
@shivkumr shivkumr requested review from a team as code owners April 29, 2026 20:04
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 29, 2026

Deploy Preview for keda ready!

Name Link
🔨 Latest commit 3d08634
🔍 Latest deploy log https://app.netlify.com/projects/keda/deploys/69f77a738b452a000830fe82
😎 Deploy Preview https://deploy-preview-1754--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.

@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:

Comment thread content/docs/2.20/authentication-providers/aws.md Outdated
Comment thread content/docs/2.20/authentication-providers/aws.md Outdated
Comment thread content/docs/2.20/authentication-providers/aws.md Outdated
Comment thread content/docs/2.20/authentication-providers/aws.md Outdated
@JorTurFer JorTurFer enabled auto-merge (squash) May 3, 2026 16:38
@JorTurFer JorTurFer disabled auto-merge May 3, 2026 16:38
Co-authored-by: Jorge Turrado Ferrero <Jorge_turrado@hotmail.es>
Signed-off-by: Jorge Turrado Ferrero <Jorge_turrado@hotmail.es>
@keda-automation keda-automation requested a review from a team May 3, 2026 16:40
Comment thread content/docs/2.20/authentication-providers/aws.md Outdated
Signed-off-by: Jorge Turrado Ferrero <Jorge_turrado@hotmail.es>
@JorTurFer JorTurFer enabled auto-merge (squash) May 3, 2026 16:40
@keda-automation keda-automation requested a review from a team May 3, 2026 16:40
@JorTurFer JorTurFer merged commit c9d9bec into kedacore:main May 3, 2026
9 checks passed
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