5430 Commits
Author SHA1 Message Date
Przemko Robakowski 1283425b60 Linux desktop access documentation (#490)
Export-Source-Commit: 64bc963663
2026-08-25 11:35:10 -05:00
Paul Gottschling 2b93e9a4ed Add a how-to guide for beamctl/beam-init (#389)
Export-Source-Commit: cd5f6af61c
2026-08-25 11:35:10 -05:00
Paul Gottschling 3f32994519 Update the description of the role request UI flow (#386)
Export-Source-Commit: 95a13d682c
2026-08-25 11:35:10 -05:00
Tim Buckley 642aa16ecf Scopes: support tpm joining (#289)
Export-Source-Commit: 395143602d
2026-08-25 11:35:10 -05:00
Michael Patterson-Muir 95cea18a8e docs: document EC2 Auto Scaling group discovery (#312)
Export-Source-Commit: bdc56d94df
2026-08-25 11:35:10 -05:00
Peter Willis 298e04f97e Scopes support for GitLab CI join (#448)
Export-Source-Commit: 1fe740db0a
2026-08-25 11:35:10 -05:00
Gavin Frazar 3a687a3d76 Regenerate terraform module docs on version update (#513)
Export-Source-Commit: 7d8e4ce5c7
2026-08-25 11:35:10 -05:00
Julia Ogris 4c3cb314ec app: Add audit event for role v9 HTTP deny (#194)
Export-Source-Commit: d7bb0d36d7
2026-08-25 11:35:10 -05:00
teleport-renovate[bot] a9b131d857 Update Go toolchain version to v1.26.7 (#396)
Export-Source-Commit: 8e4cdc517b
2026-08-25 11:35:10 -05:00
teleport-renovate[bot] 490ebd42ac Update Go toolchain version to v1.26.6 (#206)
Export-Source-Commit: ca738042bc
2026-08-25 11:35:10 -05:00
Roman Tkachenko a9e65b44ec Remove RFDs (#240)
Export-Source-Commit: c091c8a66a
2026-08-25 11:35:10 -05:00
Brian Joergerandmica 05f8e34943 SSO MFA for Admin MFA docs (#67149)
* Clarify that SSO MFA is acceptable in Admin Action MFA docs.

* Apply suggestions from code review

Co-authored-by: mica <marie.mcallister@goteleport.com>

* Clarify when admin MFA is/isn't enforced.

---------

Co-authored-by: mica <marie.mcallister@goteleport.com>
2026-08-13 23:18:50 +00:00
Adam CarhedenandHugo Shaka c8e23661ca Added proxy-only helm chart (#68037)
* Added proxy-only helm chart

* dleted unused text fixtures

* Deleted empty snapshots

* unused helmignore

* deleted debugging

* Switch empty join_params from values file to set to avoid lint-helm make target bug

* Put static join tokens in secert

* Remove PSP support

* Added token secret to validation hook

* fixed hook name in test

* Made example use more realistic kube+oidc token

* Set correct hook weight for secret

* Better validation of token secerts

* Fixed cluster ref in readme example

* Fixed typo in Account

* Preserve all join params

* Make tmp secret for install only

* Fixed wrong context for volumes calls

* Don't support creating token secret for upgrades

* Added optional audience to projected SA token

* Deleted unneeded snapshot

* Fixed merged proxy values for join token secret

* Ensures hook secret is created for proxy override

* Wrote docs

* Allowed empty value for proxyProtocol

* Fixed doc spelling errors

* Wrote index page for teleport-proxy chart

* Ensure bound keypair values are only in secrets

* Fixed extra whitespace

* fixed auth-token path and related tests

* Removed token and bound_keypair support

* Fixed lint version after rebase to helm4 link fix

* Corrected overrides for serviceAccountToken* settings

* corrected doc links

* Documented validation intent

* Fix doc links

* Fixed tls-routing doc link

* Fix arch doc ref

* arch link fix again

* forgot to checking vales

* Fix vale findings

* Update examples/chart/teleport-proxy/values.yaml

Co-authored-by: Hugo Shaka <hugo.hervieux@goteleport.com>

* Fixed missing docs secions due to -- vs -

* Address code review comments

* Switched helm values to camelCase

* Removed legacy proxy key

* Remove legacy replica count munging

* Added Azure support to joinParams

* Fix unescaped doc chars

* Fixed doc heading and link

* fixed heading

* fixed vale checks

* code review fixes for values

* Added updated generated doc page

* Updated for helm unittest 1.0.3

* Fixed config version for scratch chart mode

* Remove unneeded license from proxy chart

* Clarified Anycast support in comment

* Clarified cluster name docs

* Noted limited purpose of chart

* Made various bits of docs admonitions

* Advised against using serviceAccountToken values

* Removed ACME support

* Fixed incorrect link

* fixed mdx/mxd doc extention conflation

* Fixed doc lint issues

* Removed serviceAccountToken custom fields

* Corrected docs on join token creation

* Corrected example token expiry in docs and unneded doc link in README

* Fixed spelling

* Fixed tctl create command

---------

Co-authored-by: Hugo Shaka <hugo.hervieux@goteleport.com>
2026-08-13 21:36:57 +00:00
Tiago Silva 05419f28b6 support where RBAC on application session recordings (#69630)
* support `where` RBAC on application session recordings

application session recordings are backed by AppSessionChunk events, but
those events were never wired into the session recording RBAC path, so
`where` clauses on `kind: session` rules could not match them.

Fixes https://github.com/gravitational/teleport/issues/67775

Signed-off-by: Tiago Silva <tiago.silva@goteleport.com>

* fix unit test

* handle feedback

---------

Signed-off-by: Tiago Silva <tiago.silva@goteleport.com>
2026-08-13 14:29:20 +00:00
Michael Patterson-Muir 6fc6dc0733 discovery: add configurable AWS SSM install timeout (#69102) 2026-08-13 13:59:03 +00:00
Steven Martin bbe840d165 docs: Add 'sudo' to teleport-update uninstall command (#69618) 2026-08-13 09:08:09 +00:00
Noah Stride dce19fa553 Deprecate recording of join metadata into bot instance record (#69571)
* Deprecate recording of join metadata into bot instance record

* update docs

* Store bound keyapir data

* regen docs
2026-08-13 08:15:04 +00:00
Sakshyam Shah aecf425fe8 docs: entra id metrics (#69343)
* entra id metrics docs

* format table width

* explain integration headings

* fix typo emmited -> emitted

* add relative link to entra integration docs
2026-08-13 01:53:49 +00:00
micaandPaul Gottschling ee42a3c788 docs: address codex feedback for username trait in PingFederate role (#69589)
* docs: address codex feedback for username trait in PingFederate role example

* codex feedback, updating version necessary for user.metadata.name

* Update docs/pages/zero-trust-access/sso/integrate-idp/ping-federate-oidc.mdx

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>

---------

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2026-08-13 00:45:18 +00:00
Kyle Kloberdanz db19a7f551 Implement tctl observability (#67904)
This PR adds audit queue observability to tctl. It allows you to view
the audit queue depth and also sort records based on number of events in
each queue.
2026-08-12 22:23:22 +00:00
williamong-tel 3ef4934487 IAC SSH Server Namespacing support (#69542)
Update provider.go
2026-08-12 22:10:04 +00:00
Dustin Specker aaa380c338 docs(upgrading/cloud-cluster): mention email notifications (#69579)
* docs(upgrading/cloud-cluster): mention email notifications

Teleport Cloud has recently started supporting sending email
notifications to Teleport Cloud users running Teleport v17 and v18.

This adds a blurb about email notifications and link to adding new
business and security contacts.

* fix(docs/cloud-cluster-upgrade): use active voice

* Revert "fix(docs/cloud-cluster-upgrade): use active voice"

This reverts commit a85f2efcdd.
2026-08-12 15:32:21 +00:00
Maja Cieślak efe6598170 Add audit events for approving & denying an EnrollPairing (#69505)
* Add audit events for approving & denying an `EnrollPairing`

* Add web changes

* Drop `device.enroll_pairing.approve` from `eventGroupTypes`

* "not approved" -> "denied"

* Update wording around `device.enroll_pairing.approve` emitted on failure

While working on the RPC handler implementation, I realized that
`TV011W` is not emitted on MFA failures. This commit updates the godoc
and the fixture accordingly.

* Update `deny` audit event wording around expiry

In a typical scenario there will be no one to observe expiry, so this
event won't be emitted on enroll pairing expiry. I'll update the RFD
accordingly soon. For now just putting this here since I have no other
outstanding OSS PRs.

* Remove no longer necessary TODO comment

"Retryability" will be implemented one level above the storage layer, in
the RPC handler, so the comment here is no longer necessary.

* Remove `error` field from `device.enroll_pairing.deny`

Now that it's only going to be used for an explicit user denial, there's
no need to carry the `error` field.
2026-08-12 15:11:58 +00:00
Adam Carheden 9fe5463469 Clarified reporting service for duplicate k8s metrics (#69533)
* Clarified reporting service for duplicate k8s metrics

* Clarified language for k8s metrics

* Fixed absolute links

* fixed links (redux)

* links fix reduxx2

* Fixed section nesting

* clarified woding
2026-08-12 14:44:32 +00:00
Pawel Kopiczko 1bd52bd5c9 Docs: Update SCIM enrollment for OIN (#69415)
* Docs: Update SCIM enrollment for OIN

* Address comments

* Address feedback

* Smuggle some more docs fixes
2026-08-12 08:19:44 +00:00
Julia Ogris 677b0d6e1c types: Declare all app_resources fields (#69500)
* types: Declare all app_resources fields in the proto

Declare the eight reserved AppResource fields (paths, methods, where,
allow_encoded, allow_code, allow_reason, deny_code_hint,
deny_reason_hint) and the AppResourcesExpressions role condition, and
regenerate the proto stubs, the role CRDs, the Terraform schema and
docs, and the derived equality functions. Declaring the fields before
the fine-grained matcher merges lets every client of this version name
them, so a client that round-trips a role written by a newer auth
preserves the fields instead of silently dropping them on write-back,
which would widen the rule.

Tighten IsAllowAllOnly to require every declared field besides
allow_all to be unset. Without this, a rule such as {allow_all: true,
methods: [GET]} written by a newer auth would pass the check once the
fields are named, and this version would treat a method-restricted
rule as unrestricted.

Add GetAppResourcesExpressions to the Role interface, and read it in
decideMinimalV9 so the app agent denies a request governed by a
predicate it cannot evaluate. A predicate restricts the rules it
accompanies, so a role that pairs allow_all with one is not
unrestricted, and a deny-side predicate blocks another role's
allow_all the same way a deny-side rule does. Auth already treats both
as restricting when it downgrades a role for a pre-v9 client, so
without this the agent and auth disagree about the same role.

Strip AppResourcesExpressions in the v9-to-v8 downgrade alongside
AppResources, and reject it at write, so a role can neither reach a
pre-v9 client with the restriction silently removed nor be stored
while this version cannot enforce it.

* docs: List the declared app_resources fields

Honour the docs review on the app-resources reference page. A run of
inline code-style field names inside a sentence is hard to scan, so the
eight rejected `app_resources` fields become a list, and
`app_resources_expressions` gets its own sentence rather than trailing
the same run.

* buf: Trim the reserved-deletion except comment

Drop the two sentences explaining why buf's ignore lists cannot scope the
except. The rule name and the removal condition are what a reader needs
here, and the scoping attempts are recorded on the pull request.

* types: Reword the app_resources_expressions and Methods docs

Honour the review on the proto field comments. Drop "desugared" from
`AppResourcesExpressions`, which needs the RFD to gloss, and state the
relation between the two forms directly instead. Open `Methods` with the
plural, matching `Paths` on the row above.

Regenerate the proto stubs, the role CRDs, the Terraform schema and docs.
2026-08-12 05:19:01 +00:00
rosstimothy 5dd08bd2e2 Stop honoring teleport.cache.enabled (#69439)
Caching has become an integral part in functionality provided
by teleport. Allowing users to disable the cache was never something
that was a recomended configuration - it was predominately used
as a stopgap to address an outage. However, over time the cache
has become more stable and the need to bypass it should never
arise.

Additionally, this toggle causes several architectural difficulties
that increase complexity and maintainability of teleport. By always
enforcing that the cache is on, we can eventually separate the gRPC,
backend, and caching layers - a frequent developer experience nightmare.
Moving to a world where the cache is always guaranteed to be present
and available we will be able to remove layers of abstraction and
increase performance.


We do still honor `teleport.cache.max_backoff`. While it was tempting
to remove all teleport.cache knobs, it seemed that still allowing users
to control the backoff interval could alleviate any caching related
issues that lead to or are contributing to an outage. This seemed rather
important to still offer now that the ability to disable caching no
longer exists.
2026-08-12 02:12:37 +00:00
williamong-tel 5cf14ff0e2 IAC Operator SSH Server Namespacing support (#69543)
to teleport

add scoped tests
2026-08-11 19:40:51 +00:00
Taras 2c8a7659e8 [18.10.3] Bump cloud docs (#69288) 2026-08-11 16:42:39 +00:00
Gabriel Corado 1c6d883a8b Remove app auth config (#69528)
* refactor: remove app auth config

* chore: fix lint errors

* fix(docs): correct config json format
2026-08-11 16:01:44 +00:00
Paul Gottschling bebdf17fc6 Add a Beams use case demo for databases (#69382)
* Add a Beams use case demo for databases

This guide demonstrates the Teleport RBAC configuration to allow AI
agents running on a Teleport beam to access a Teleport-protected
database using an untrusted prompt. It includes an example of enrolling
a local Postgres container with Teleport, plus a Teleport user/role with
read-only access to the database. This way, a user can go through an
example that is guaranteed to work without having to run a
`--dangerously-skip-permissions` agent session against a preexisting
database.

* Simplify the Beams database guide

- Use `format=text` for the `tctl tokens add` command
- Use `teleport db configure create` instead of a config example

* Fix minor issues in the Beams database guide

- Remove technically inaccurate sentence.
- Clarify "AI agents" vs. Teleport Agents in an introductory paragraph.
- Clarify the `token` flag in `teleport db configure create`
2026-08-11 14:50:10 +00:00
Noah Stride b8881600f6 Remove legacy user generation label handling (#69335)
* Remove legacy fallback for bot generation

* fixup test
2026-08-11 08:46:02 +00:00
Tim Buckley ae8467a8f9 Add documentation for generic_oidc (#69216)
* Add documentation for `generic_oidc`

This adds documentation for the new `generic_oidc` join method, to be
released in v18.11.0. It includes reference material and guides for
joining both bots and agents.

* Update join-methods.mdx to include agent guide, add min version

* Fix docs lints

* Fix more lints

* Fix even more lints

* Fix hcl formatting

* Fix review comments

* Add generic_oidc client-side reference for bots and agents

* Add missing references to generic_oidc on the join methods page
2026-08-11 03:01:33 +00:00
Julia Ogris 466fccde36 operator: Add role v9 CRD kind (#68737)
* operator: Add role v9 CRD kind

Register a TeleportRoleV9 kind with the Kubernetes operator so v9
roles can be managed declaratively. The reconciler reuses the shared
RoleV6 storage type with a version override, the same way the v7 and
v8 kinds do.

Generated changes:

    make -C integrations/operator generate

* operator: Drop preserve-unknown on app_resources

Setting x-kubernetes-preserve-unknown-fields on app_resources rule items
relaxed the CRD schema to store fields it does not declare, so the operator
could reject them on decode. That keeps invalid data in cluster state and is
hard to walk back once shipped, even after Kubernetes field validation
improves. Rely on the structural schema and server-side field validation to
reject unknown fields at the API server instead, and drop the tests that
asserted the operator-side rejection.

* operator: Match the reconciler factory signature

The scoped operator work added an OperatorMetadata parameter to
ReconcilerFactory and updated every existing role reconciler. The v9
reconciler was written before that change, so master and this branch each
compile alone but not once merged, and the merge queue rejects the result.

Take the parameter and ignore it, as the v6 to v8 reconcilers do.
2026-08-10 23:51:57 +00:00
Ghassan Gedeon Achi 2eefa7990f [Docs] Add Identity Security CLI documentation (target: v18.11) (#68569)
* docs: add Identity Security CLI docs

* feat: address ci lint docs comments

* docs: address pr review comments

* fix: clean up double security syntax

* fix: roles and access list kind message

* docs: address codex comments

* fix: remove mention of enterprise cloud

* docs: update tctl access-review overview page

Small updates to the documentation to account for the changes introduced
by #68781, namely:
- Updating Grantor -> `Granted By`.
- Activity Window on by default
- Activity warning shown seperately.

* docs: address pr suggestions
2026-08-10 18:43:46 +00:00
Tiago Silva 395d98b5b4 feat: Add tctl recording summary commands for session summary management (#63488)
* feat: Add tctl summaries command for session summary management

Add new `tctl recordings summary` command group for viewing and downloading
AI-generated session summaries from the auth server.

- `tctl recordings summary <session-id>`

Signed-off-by: Tiago Silva <tiago.silva@goteleport.com>

* use opaque api

---------

Signed-off-by: Tiago Silva <tiago.silva@goteleport.com>
2026-08-10 16:16:31 +00:00
Hugo Shaka 3a45ff944e Implement RFD 328: scoped operator (#69074)
This commit implements the following changes:

- add a kubernetes state in which the operator can store its ID
- move ownership checks and label setting to the adapter interface
- add the scoped resource with label adapter
- add operator metadata and propagate it to scoped reconcilers
- make scoped adapters check the operator id label when the resource is
  scoped
- make scoped adapters set provenance labels when the resource is
  scoped
- fix the controller tests that were no longer able to infer the
  generics type since `api/types` was not directly imported anymore
- make the operator reject reconciling a resource whose scope does not
  match its own
- enable and fix scoped resource tests:
  - use the same test scope everythere
  - set the test scope in the operator metadata
  - generate and use the operator ID
2026-08-10 15:27:48 +00:00
matheus 9bb332882c client_ip_restriction: add new fields to Terraform provider (#68942)
* `client_ip_restriction`: add new fields to Terraform provider

* lint fix
2026-08-07 17:42:27 +00:00
Chris ThachandAlan Parra c1991c9497 Add spiffe-tls to supported CA overrides and create mapper func. (#69296)
* Add spiffe-tls to supported overrides and create mapper func.

Signed-off-by: Chris Thach <chris.thach@goteleport.com>

* Fix missing sub-kind and ignore slice order.

Signed-off-by: Chris Thach <chris.thach@goteleport.com>

* Update tctl CLI doc.

Signed-off-by: Chris Thach <chris.thach@goteleport.com>

* Apply suggestions from code review.

Signed-off-by: Chris Thach <chris.thach@goteleport.com>

* Apply suggestions from code review

Co-authored-by: Alan Parra <12500300+codingllama@users.noreply.github.com>

* Run gofmt.

Signed-off-by: Chris Thach <chris.thach@goteleport.com>

---------

Signed-off-by: Chris Thach <chris.thach@goteleport.com>
Co-authored-by: Alan Parra <12500300+codingllama@users.noreply.github.com>
2026-08-07 17:04:05 +00:00
Julia Ogris 2a05d3edfe role: Add minimal v9 with app default-deny (#68736)
* types: Add minimal role v9 with app default-deny

Add role resource version v9. A v9 role denies all access to HTTP apps
by default: when it grants an app via `app_labels` or
`app_labels_expression`, every HTTP request is denied unless an
allow-side `app_resources` rule permits it (RFD 0303).

Add `app_resources` to a role's `spec.allow` (not `spec.deny`), rules
controlling access to an app's resources on each HTTP request. For now
a rule holds one field, `allow_all`, which grants unrestricted access,
equivalent to v8, and must be the only rule. Reserve field numbers for
the fine-grained fields (`paths`, `methods`, `where`, audit codes) so
later releases add them without renumbering. Bump the role version in
an N.0.0 release: the breaking default-deny aims to ship in Teleport
v19.0.0.

Reject at write time any `app_resources` use on pre-v9 roles, under
deny, in a rule that does not set `allow_all`, or in a rule next to
another rule.

Serve v9 roles to clients older than 19.0.0 as v8 copies: the auth
server strips `app_resources` and marks the copy with the
`teleport.internal/downgraded` label. The stored role stays v9; only
what goes over the wire changes. The downgrade fails closed: unless a
rule sets `allow_all` (exactly v8 access, lossless), the copy also
loses its allow `app_labels` and `app_labels_expression`, so an older
agent denies the app entirely instead of serving it unrestricted.

Enforce the default-deny in the app agent's plain-HTTP path; TCP, MCP,
cloud, and LLM apps are excluded. When v8 and v9 roles grant the same
app, drop the v8 roles from the decision so they cannot re-open
unrestricted access, and log a warning once.

Bundle the Terraform provider update so v9 roles can be managed as
code starting with v19.0.0. The operator v9 CRD kind follows
separately.

Generated changes:

    make grpc/host
    make derive
    make -C integrations/terraform docs
    make -C integrations/operator generate

* auth: Downgrade roles from GetCurrentUserRoles

Run every role streamed by GetCurrentUserRoles through
maybeDowngradeRole before sending, matching GetRole, GetRoles,
ListRoles, and the watch stream. Without it, a pre-19 client asking a
remote cluster for its mapped roles receives a v9 role with allow
app_labels intact and no app_resources enforcement it understands, so
client-side access checks treat a default-deny role as granting full
app access. The change also applies the pre-existing v8-to-v7
downgrade on this surface, which previously served v8 roles to v17
clients unchanged.

* terraform: Exclude deny-side app_resources from schema

Drop `app_resources` from the Terraform role schema's deny block, as
the server rejects any deny-side `app_resources` at write time and
RFD 0303 keeps the rules allow-only so that they fail closed. With the
field gone from the schema, Terraform rejects a deny-side rule at plan
time instead of leaving it to the server's write-time check. Follow the
existing `RoleV6.Spec.Deny.Namespaces` exclusion.

Generated changes:

    make -C integrations/terraform docs

* docs: Split role versions into per-version headings

Break the Role versions section into one H4 per role version so
readers can jump straight to the version they care about. Move the
SAML IdP note under the v8 heading, since it describes a v8 change,
and keep the kubernetes_resources defaults table as its own H4 at
the end. Fix a mismatched backtick around `v5` in the moved
session-joining paragraph.

* app: Warn when version skew denies a v9 request

When the minimal v9 check denies a request because the user's roles
carry `app_resources` rules or role versions this Teleport version
does not implement, the app agent previously answered 403 without any
log line. In a mixed-version cluster an operator saw denied requests
with no explanation that the deny came from a version mismatch rather
than from an intended default-deny role.

Track the condition as `versionSkew` on `minimalV9Decision`:
deny-side rules, allow rules beyond a single pure `allow_all`, or a
role version above v9. When such a deny fires, log one warning per
user and app through the existing `v9WarnOnce` mechanism, telling the
operator to upgrade the app agent. An intended default-deny, a v9 role
without app rules, stays quiet. A follow-up PR adds a minimal audit
event for the same denials.

* app: Deny apps a downgraded v9 role restricted

A v9 role that restricts app access downgrades to v8 for a pre-v19 agent
that cannot enforce the restriction. Clearing the role's allow app labels
alone would only stop that role granting the apps; another v8 role the user
holds could still grant them, so the restriction would not hold on the old
agent. Move the role's allow app selector to the deny side instead, so no
other role grants the apps this role restricted. The deny is at least as
strict as the v9 restriction and never grants more.

If the role already denies apps by label, there is no room to merge a
second label map, so fall back to a wildcard deny and log it rather than
drop the existing deny.

* docs: Correct v9 downgrade mixed-version guidance

Describe the deny-side downgrade the code actually performs. Without
`allow_all`, the v8 copy moves the allow app selector to the deny side
rather than dropping it, so deny rules override allow rules across a user's
roles and a separate v8-or-older role can no longer reopen the app on
pre-v19 agents. Note that the moved selector denies conservatively and can
block more apps than the v9 role allowed in a mixed-version cluster.

* role: Deny v9 app access for unknown JSON fields

Empty any v9 allow app_resources rule whose stored JSON carried a field
this version does not recognize, so a rule written by a newer version cannot
read as more permissive than intended. An unrecognized field already denies
on the other surfaces: proto reads keep it in XXX_unrecognized so
IsAllowAllOnly rejects it, and writes reject it at validation. JSON unmarshal
drops unknown fields silently, so this re-scans the raw bytes on read. The
known field set is derived from the AppResource message, so a new proto field
extends it automatically. The result is a single rule across every surface,
an unrecognized field grants nothing, worst case over-deny.

* app: Deny app access from roles newer than v9

A role from a version above v9 may carry restrictions this agent cannot
evaluate, so treat it as deny even when its known fields form a plain
allow_all. Previously such a role set both versionSkew and allowed, and
enforceMinimalV9 returns early on allowed, so the request was forwarded and
the skew warning never fired.

* auth: Explain the greedy deny in the v9 downgrade

The downgrade moves a v9 role's allow app selector to the deny side, which
looks like it could clobber an existing deny expression. Record why it
cannot, since deny matches on either selector, and why label maps fall back
to a wildcard where expressions compose with an or.

* api: Guard the AppResource field set with a test

IsAllowAllOnly decides whether a rule is unrestricted by checking that
allow_all is set and no unknown bytes arrived over the wire. A field added
in tree, once one of the reserved numbers is unreserved, would restrict the
rule without making that check return false. Pin the field set so such an
addition fails the test, and name the checks to re-evaluate next to the
reserved numbers in the proto.

* app: Bound the v9 warning deduplication cache

The v9 enforcement warnings fire once per warning kind, user, and app, and
the sync.Map holding those keys never dropped an entry, so a long-running
app agent serving many users and apps grew it for the life of the process.
Hold the keys in a fixed-size LRU instead. Evicting the least recently
warned entry repeats its warning, which is the better failure mode.

* role: Address review feedback

Reword the checkAppResources godoc so the api module does not reference
lib/services. Move the unknown-field check for allow app_resources rules
from integrations/lib/tctl into lib/services next to the other role
unmarshal handling, and derive its known field set from the AppResource
message instead of hardcoding allow_all, so unreserving a proto field
extends it without a second edit. Replace the package-level
preV9RoleVersions slice with roleVersionPredatesV9, a function with a
switch, so nothing mutable sits at package scope.

* role: Address agent review feedback

Reword the `decideMinimalV9` godoc so only a v9 role can allow; a
version above v9 always denies. Drop the `AppResource` message summary
sentence that misstated the reserved field numbers as path, method, and
where rules; fields 6 to 9 hold the audit and deny-hint fields. Reword
the `TestAppResourceFields` comment so the api module does not point
at `lib/services`. Give `v10Grants` an `allow_all` rule so the
above-v9 test case fails if a newer-version role with a plain
`allow_all` rule ever allows again. Add a downgrade subtest for the
deny-expression OR-merge, which no test executed, and a `lib/services`
table test for `CheckAppResourcesKnownFields`, which was only
exercised from the integrations module after its move.

* role: Compact review-feedback additions

Tighten the previous commit's additions, partly to keep the PR under
5,000 added lines. Compact the `CheckAppResourcesKnownFields` table
test into direct assertions, flatten the allowed branch in
`decideMinimalV9`, iterate the `AppResource` fields with
`reflect.TypeFor`, drop the slice alias in
`denyAppAccessForUnknownFields`, and shorten two test comments and a
wrapped constructor call. No behavior change.

* role: Reuse access checking for v9 app decisions

The v9 default-deny check needs to know which individual role grants an
app. `roleGrantsApp` answered that by repeating the namespace and label
stages of `RoleSet` access checking inside `lib/srv/app`, where a second
implementation can drift from the original. Replace it with
`services.RoleGrantsResource`, which delegates to `RoleSet.checkAccess`
and follows the existing single-role idiom in
`lib/services/access_checker.go`.

Delegating changes one case. `resourceRequiresLabelMatching` exempts the
Identity Center app subkind from app label matching, so `checkAccess`
treats every role as granting such an app and v9 denies requests that
`roleGrantsApp` allowed. Add `isPlainHTTPApp` to skip enforcement for
that subkind alongside the cloud and LLM types, which is the scope v9 is
documented to cover, and log once per user and app when an app reaches
the check that should have been routed elsewhere. Drop the unused error
return from `decideMinimalV9`.

Remove `CheckAppResourcesKnownFields`. The property it enforced, that a
role never stores an `app_resources` rule with a field this version does
not understand, already holds on the write path, where `UnmarshalRole`
empties such a rule and `validateAppResources` then rejects it for no
longer setting `allow_all` alone. Its only caller was a test helper for
the access plugins, so assert the write path directly instead.

Describe `validateAppResources` by the property it guarantees rather than
by each check it runs, so the godoc does not drift as the checks change.
Explain why the role stream downgrades per client version, and say
explicitly that both versions in the `maybeDowngradeRole` ordering
comment are the client's, which read ambiguously as the server's. Cut the
role v9 reference section to the field it introduces and a link, and move
the rules, the mixed-version role behavior, and the agent upgrade it
requires to a new Application Resources reference page.

* docs: Use a defined tag on the app resources page

The application-access tag is not in the docs tags vocabulary, so the
docs build rejected the new page. Use privileged-access, which the
sibling roles reference page already carries.

* terraform: Regenerate the schema with protoc-gen-terraform v4

Master upgraded the generator to v4.0.0, which marks list-nested
attributes computed and preserves unknown elements by index. Regenerate
so the app_resources attributes match what the pinned generator emits.
2026-08-07 00:20:59 +00:00
Noah Stride e98f39c334 Document deprecation of roles config field in tbot (#69182)
* Add reference page for v18 -> v19 tbot breaking changes

* remove reference in FAQ

* add warning

* Add link to support
2026-08-06 21:44:45 +00:00
Noah Stride f7aef78a96 MWI: Bot Scope Namespacing (#68253)
* MWI: Bot Scope Namespacing (#68253)

* Properly handle scope namespaced bots in tctl

Squash of:
- Properly handle scope namespaced bots in tctl
- tdy

* tidy up todo/lint failure

* Add audit log events

* various tidying

* adjust for consistency

* remove botRef

* Simplify by removing checkBotRefMatches

* Avoid testify in authtest.go

* address review feedback

* defensive checks against name collisions
2026-08-06 09:55:16 +00:00
Gavin Frazar 73ae81befb Update Terraform modules (#69306)
* Enable managed updates by default

* Expose ECS task Teleport configuration

* Make RDS modification permissions opt-in

* Standardize Terraform format expressions

* Update default IAM token name

* Update discovery module RDS policy actions

These permisisons are necessary to support the web UI flow which has to list
VPCs, subnets, and security groups.

* Eliminate teleport_discovery_config_name local var

It was used in only one place.

* Fix nonsensitive cast in token name output

* fix container-service example

* fix docs lint
2026-08-06 02:51:26 +00:00
Nick Cellino 4cc0872f09 Add configurable automatic review resolution reasons (#69169)
* add configurable automatic review reasons

* generate CRD and terraform schemas

* document reason field in automatic review docs

* add validation for automatic review reason field

* Re-run "make grpc"

* remove unnecessary variable copy

* simplify a test

* Re run make tf integration docs
2026-08-05 20:51:57 +00:00
Bernard Kim 1a9de95d20 [terraform] upgrade protoc-gen-terraform to v4.0.0 (#67080)
* Bump protoc-gen-terraform v4.0.0-dev.1

* make gen-tfschema

* Temporarily skip broken tests

* [terraform] exclude `nonce` attribute (#67075)

* [terraform] exclude `metadata.revision` attribute (#67084)

* [terraform] set `role.spec.options.record_session` as a computed attribute (#67094)

* Enable SessionSummaries entitlement for tests

* [terraform] Update auth_preference protoc-gen-terraform config (#67154)

* Update protoc-gen-terraform-teleport.yaml

The following attributes are marked as computed:
- AuthPreferenceV2.Spec.IDP
- AuthPreferenceV2.Spec.IDP.SAML
- AuthPreferenceV2.Spec.Okta

The following attributes are no longer marked as required:
- AuthPreferenceV2.Metadata.Name

* [terraform] Fix custom attribute schema (#67345)

* Update custom schema attributes

Ensure constraints including `Computed` and `PlanModifiers` are
propagated to final attribute struct.

* Update custom attribute CopyTo logic

- CopyTo now clears the `Null` and `Unknown` fields.
- CopyTo now replaces stale values within lists/maps.

* Update custom attribute CopyFrom logic

- CopyFrom now sets nil object when value is `Null` or `Unknown`.

* [terraform] Remove metadata.expires as a computed_field (#67441)

Prior to `GenSchemaTimestamp` changes, none of the timestamp attributes
were actually computed because the `Computed` field was being discard.

Now that the custom attribute schema has been fixed, the provider
complains that the `plan was not empty` with a perpetual drift when
Teleport does not provide a default value for `metadata.expires`. To
resolve this issue, all `metadata.expires` attributes have been removed
from the list of `computed_fields`.

Additionally, `scoped_role.metadata.expires` and
`scoped_role_assignment.metadata.expires` are not supported configuration.
They are now `excluded_fields`.

* [terraform] fix plural resource update method (#67478)

* [terraform] Implement resource-level ModifyPlan (#67294)

* [terraform] Update cluster_networking_config protoc-gen-terraform config (#67216)

* [terraform] Exclude created_at and created_by (#67621)

* Bump protoc-gen-terraform v4.0.0-dev.2

* make gen-tfschema

* [terraform] Update protoc-gen-terraform-accesslist.yaml (#67139)

* Update protoc-gen-terraform-accesslist.yaml

The following attributes are marked as computed:
- access_list.spec.audit
- access_list.spec.audit.notifications
- access_list.spec.audit.notifications.start
- access_list.spec.audit.recurrence
- access_list.spec.audit.grants
- access_list.spec.audit.owner_grants
- access_list.spec.audit.membership_requires
- access_list.spec.audit.ownership_requires

The following attributes are marked as required:
- access_list.spec.title

The following attributes are marked as excluded:
- access_list.spec.audit.next_audit_date

* [terraform] Implement ModifyPlan for login_rule (#67894)

* Bump protoc-gen-terraform v4.0.0-dev.3

* [terraform] preserve unknown values during TF plan (#68405)

* Update templates to use preserve unknown

* Update tfschema/custom_types.go

CopyToBoolOption, CopyToLabels, CopyToTraits, and CopyToStrings now
accept the preserveUnknown flag.

* Update resource153/custom_types.go

CopyToTimestamp, CopyToDuration, and CopyToLabel now accept the
preserveUnknown flag.

* Update summarizer/v1/custom_types.go

CopyToClassifierActionMode, and CopyToRiskLevel, now accept the
preserveUnknown flag.

* Exclude access_list_member fields

The following fields are managed by Teleport:
- member.spec.added_by
- member.spec.joined
- member.spec.name

* teleport_bot requires teleport.dev/origin label

* Fix outdated trusted_cluster example

* Exclude teleport_workload_cluster.status

* Compute teleport_discovery_config attributes

- spec.aws.install is now computed
- spec.aws.ssm is now computed

* Fix teleport_trusted_device terraform type

* Set `role.spec.options.idp` as a computed field

The default value for v7 roles is `idp.saml.enabled = true`

* Re-enable skipped tests

* Bump protoc-gen-terraform v4.0.0

* Update generated code for scopes resources
2026-08-05 18:29:19 +00:00
nixpig 917e14724a Add docs for cleanup of deactivated Okta user assignments (#69322)
* Add docs for cleanup of deactivated Okta user assignments

* Fix spelling spacing

* Change delete command to rm for Okta assignment removal

Updated command for removing Okta assignments in Teleport.
2026-08-05 11:09:43 +00:00
Hugo Shaka 6fbe637f9c Add scoped IaC docs (#69300) 2026-08-04 19:43:15 +00:00
Forrest a918ca53d1 scoped verbs rework (#69232) 2026-08-04 16:53:02 +00:00
Adam Carheden 7d573a307d Added unhealthyPodEvictionPolicy to teleport-kube-agent helm chart (#69207)
* Added unhealthyPodEvictionPolicy to teleport-kube-agent helm chart

* updated docs

* Fixed wording of docs

* fix code review findings

* Enabled unhealthyPodEvictionPolicy in 1.27, since it's on by default in beta

* replaced forceUnhealthyPodEvictionPolicy with empty value for unhealthyPodEvictionPolicy

* Test custom value in 1.26

* Added auto value to unhealthyPodEvictionPolicy

* docs update

* Removed auto value and support for unhealthyPodEvictionPolicy in k8s <1.27

* updated helm docs

* Replaced failure with warning for k8s <1.27

* fixed missing newline

* Corrected docs

* fixed doc lint issues
2026-08-03 23:09:22 +00:00
Erik Tate 0163a8d7fa adding sections for dynamic kube cluster registration and kube resource RBAC to the scopes doc (#69114) 2026-08-03 21:28:34 +00:00