Commit Graph
543 Commits
Author SHA1 Message Date
Noah Stride ee6e527eaf WMI: Allow max TTL for X509 and JWT SVIDs to be configured (#53787)
* Add maximum_ttl fields to the WorkloadIdentity resource

* Update issuer service to respect configurable max TTLs

* Add tests for TTL specification

* Add validation logic & tests

* Update terraform provider

* Fix tbot max ttl limitations

* Clarify name of `ignoreMaximumTTL`

* Introduce `defaultTTL` constant

* Fix generation of jwt

* Update operator resources
2025-04-09 17:28:51 +00:00
Noah Stride 47ec6d7222 Operator support for WorkloadIdentity resource (#53484)
* Generate CRDs

* Update snapshots

* Add apis impl for WorkloadIdentity

* Add WorkloadIdentityReconciler

* Add test for WorkloadIdentityReconciler

* Update RBAC

* Update to include version in kind

* Fix license header

* Fix handling of well-known Struct type

* Ignore revsiion
2025-04-09 14:18:31 +00:00
1d812b0779 Workload ID: Document the Systemd attestor and Unix improvements (#52875)
* Document the Systemd workload attestor

* Document the `binary_path` and `binary_hash` attribute

* Replace period with colon

Co-authored-by: Noah Stride <noah.stride@goteleport.com>

* Add "dbus" to the linter's known words

* Better grammar

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

* Remove extraneous newlines in list

---------

Co-authored-by: Noah Stride <noah.stride@goteleport.com>
Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2025-04-07 14:02:33 +00:00
Steven MartinandPaul Gottschling 82fbe3719a docs: update storage backends to include AWS S3 for audit events (#53718)
* docs: update storage backens to include AWS S3 for audit events

* docs: update s3 titling

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

* docs: update ref to s3

---------

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2025-04-04 16:09:01 +00:00
Bernard Kim d6a850f4d4 access_monitoring_rule: Restructure the automatic review spec (#53601)
* Update proto

* Restructure AMR

* lint

* Update ts types
2025-04-04 00:18:12 +00:00
Noah Stride 63e269a756 Operator support for Bot resource (#53453)
* Add `Bot` manifests

* Update protos

* Add Bot API resource impl

* Add reconciler

* Fix bot CRD "versions" name

* Fix Unmarshal/Marshal panic for 153 resources

* Fix update test

* Mispell Marshalling

* Generate docs page

* Update role.yaml

* Add TeleportBot to resource list

* Update contributing

* Try to update the versions per RFD160

* Update k8s rbac for new resource name

* Use proto binary encoding for Marshal/Unmarshal

* Clear out unversioned crd

* More efficient deepcopyinto

* Fix license

* Add unmarshal options for protojson

* Update golden

* Fix RBAC
2025-04-01 15:31:48 +00:00
Dan Upton 256aaff0dc Add image_digest to Docker attestor attributes (#53538) 2025-03-31 13:52:03 +00:00
Dan Upton 41935c358f Add spiffe.jwt.extra_claims to the WorkloadIdentity documentation (#53587) 2025-03-31 13:18:56 +00:00
Dan Upton 63ed6aea72 Add image_digest to the Podman attestor's attributes (#53539) 2025-03-31 12:00:42 +00:00
Dan Upton 3ec72107c9 Workload ID: Capture Kubernetes Container Details (#53534)
* Add container details to the Kubernetes workload attestor

* Document k8s container attributes
2025-03-31 11:07:29 +00:00
Sakshyam ShahandPaul Gottschling 5c83b29ca9 docs: explain awsic plugin install --assume-role-arn flag (#53512)
* docs: explain awsic plugin install  flag

* expand the use system credential sentence

* Update docs/pages/admin-guides/management/guides/aws-iam-identity-center/migrating-identity-center-from-okta-to-teleport.mdx

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

---------

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2025-03-28 20:54:00 +00:00
Noah Stride ccbe5c5a18 Document allow_reissue (#53439) 2025-03-27 23:33:09 +00:00
Hugo Shaka 22b05490d6 Support adding introduction text into Terraform reference pages (#53474)
* TF docs: add introduction support in generic template

* TF docs: link database guide
2025-03-27 17:31:37 +00:00
Noah StrideandPaul Gottschling b3448877b5 Add documentation for workload-identity-aws-ra tbot service (#53322)
* Add cdocumentation for `workload-identity-aws-ra` service

* Apply suggestions from code review

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

* Adjust name to be full roles anywhere

---------

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2025-03-27 13:52:43 +00:00
Gavin Frazar 8d38eac6ce [docs] Fix role reference request_access docs (#53471)
* Fix request_access godoc

* Update terraform docs

* Update operator CRD docs
2025-03-26 22:43:56 +00:00
STeve (Xin) Huang 70ccd1bb14 [docs] Move discovery reference and fix ElastiCache/MemoryDB db access reference (#52854)
* Move discovery reference and fix ElastiCache/MemoryDB db access reference

* adding redirect

* fix spelling

* fix trailing slash

* fix links

* change to wildcard
2025-03-26 15:37:18 +00:00
Noah Stride 7cbb46d2ed Support configuring StaticJWKS for the GitLab join method (#53386)
* Update protobuf

* Implement and test ValidateTokenWithJWKS

* Update join logic to use new method for static jwks

* Update Terraform Provider

* Update operator docs/files

* Update goldenfile
2025-03-25 18:03:09 +00:00
Noah Stride b946365941 Document disable_exec_plugin option for Kubertnetes output (#53326) 2025-03-25 08:52:40 +00:00
Paul Gottschling 861128ac83 Fix 18 vale warnings (#53300)
Include inlining the partial:

docs/pages/includes/machine-id/recover-circle-ci-claims.mdx

This is because it's only used by two pages and, as a partial, violates
the rule in which each Var with a given name must be used multiple
times on a single page. Since this Vale rule uses the `raw` scope, it is
not possible to ignore it with an MDX comment.
2025-03-24 14:24:51 +00:00
Paul Gottschling 6c14c2b16e Replace (!toc!) syntax with DocCardList (#53331)
DocCardList is a Docusaurus-native component that achieves the same
goal as our custom `remark-toc` plugin, but with Docusaurus APIs instead
of file system lookups. Replace `(!toc!)` mentions so we can remove
`remark-toc`.
2025-03-24 12:53:16 +00:00
Noah StrideandPaul Gottschling 848025c02a Update Identity output docs to include ssh_config option (#53271)
* Update Identity output docs to include `ssh_config` option

* Update docs/pages/reference/machine-id/configuration.mdx

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

---------

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2025-03-24 10:26:44 +00:00
Hugo ShakaandJoao Ubaldo 8c8b3832c9 [buddy] helm: add support for secondFactors (#53274)
* Helm: add support for multiple second factors

* Helm: better handle webauthn

* Helm: add tests

* Helm: update contributing reference link

* Helm: add doc

* Helm: update default value

* helm: deprecate secondFactor and user secondFactors by default

---------

Co-authored-by: Joao Ubaldo <me@joaoubaldo.com>
2025-03-23 11:00:28 +00:00
Hugo Shaka 4fad952d20 helm: add topology spread constraints (#53276) 2025-03-21 14:50:43 +00:00
175a5504b1 docs: Add tctl plugins install refrerence (#52878)
* docs: Add `tctl plugins install` refrerence

* Update tctl.mdx

* Apply suggestions from code review

Co-authored-by: Roman Tkachenko <roman@goteleport.com>

* Update tctl.mdx

* Update tctl.mdx

* explain required and optional fields

---------

Co-authored-by: Roman Tkachenko <roman@goteleport.com>
Co-authored-by: Sakshyam Shah <sshah@goteleport.com>
2025-03-21 02:50:11 +00:00
Steven MartinandZac Bergquist 4b342558ee docs: update role v5 reference info (#53219)
* docs: update role v5 reference info

* docs: spelling fix

* docs: update role v5+ language for joining sessions

Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>

---------

Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>
2025-03-20 17:01:12 +00:00
Michael 46437e307a Add UseAnyProxyPublicAddr to app spec (#52693)
This adds a new field, UseAnyProxyPublicAddr, that will be used to
tell the web api/ui to rebuild the request app's FQDN based on the proxy
public addr that the request came from (upcoming PR to consume this)
2025-03-20 00:40:06 +00:00
Hugo Shaka 5e73eaf342 Add autoupdate version and config support to TF provider (#53007)
This commit adds two new singular resources to the Terraform provider:
teleport_version and telpeort-config.
Both got added using the resource 153 pattern (new protoc-X.yaml file)
and it went pretty seamless.

The only specific is that I had to add a provider feature to
automatically set singular resource names as we don't run
CheckAndSetDefaults() locally anymore. This got merged in a separate PR.
2025-03-19 17:55:33 +00:00
Paul Gottschling 3156fa9e3c Fix 18 Vale warnings related to Var components (#52810)
`Var` components with a particular `name` should have multiple instances
in a given page.
2025-03-18 16:27:50 +00:00
marieandZac Bergquist ec58d4f585 docs: add jwt options to application-acces full spec (#52901)
* docs: add[D jwt options to application-acces full spec

* Update docs/pages/reference/agent-services/application-access.mdx

Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>

* Update docs/pages/reference/agent-services/application-access.mdx

Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>

---------

Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>
2025-03-18 14:34:24 +00:00
Nic Klaassen e027dcc5ac docs: instructions for signature_algorithm_suite with hsm and FIPS (#53097) 2025-03-17 23:59:15 +00:00
Zac Bergquist 60c5a1361e Support context path for Kubernetes app discovery (#52897) 2025-03-17 21:47:48 +00:00
Paul Gottschling 6023797386 Use the Docusaurus format for Details (#53009)
See gravitational/docs-website#91

Docusaurus uses semantic HTML tags instead of a custom Details
component. Replace instances of our Details component with the
`<details>` and `<summary>` tags so we do not need to perform a
conversion when building the docs website.
2025-03-13 17:32:59 +00:00
marie acd4e4873a docs: expandable content - customer feedback (#49782)
* docs: expandable content - customer feedback

* docs: expandable content - customer feedback

* bolder heading

* yikes - meant to use H5

* trying with multiple tags

* variation - corrected

* restored original best-practices module

* direct auth note
2025-03-12 01:02:08 +00:00
Noah StrideandPaul Gottschling 3bbaaccc95 Add Spacelift to join token reference page (#52576)
* Add spacelift to join token reference page

* Fix join_method

* Update docs/pages/reference/join-methods.mdx

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

* simplify

---------

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2025-03-11 16:27:45 +00:00
Noah Stride d04859707b Add documentation for Workload Identity Revocations (#52504)
* Add revocations page

* Add example of fetching signed CRL

* Add example of listing and remvoing revocations
2025-03-11 14:49:54 +00:00
Paul Gottschling 1c31b5e4a8 Remove Figure tags (#52929)
See gravitational/docs-website#95

The docs engine currently unwraps them, meaning that they are no-op
components. Remove these so we can delete the Figure-unwrapping code.
2025-03-11 12:08:41 +00:00
Zac Bergquist 213246296f docs: document tsh sessions ls (#52780)
Closes #52391
2025-03-07 16:39:09 +00:00
Dan Upton fda52e082a Fix missing closing backticks in Workload Identity API & Workload Attestation (#52874)
Somehow these got lost when applying suggestions in #52557.
2025-03-07 12:03:46 +00:00
marieandZac Bergquist 829532409b docs: new product messaging for marketing launch (#52319)
* initial draft for marketing changes

* product name changes from marketing

* correcting duplications

* final changes post-marketing review

* review changes

* Update docs/pages/admin-guides/infrastructure-as-code/managing-resources/access-list.mdx

Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>

* revisions

* cleanup and reverting use-cases of 'Zero Trust Access x'

* Trust Access corrections

* removing 2 images already in master

* post-feedback changes

* Update docs/pages/admin-guides/teleport-policy/teleport-policy.mdx

Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>

* post G2 review feedback

* Lint helm appeasement

---------

Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>
2025-03-07 01:35:13 +00:00
Dan UptonandPaul Gottschling 49d543cb1b Document the Podman and Docker workload attestors (#52557)
* Document the Podman and Docker workload attestors

* Use more direct language and fix typo

* Add "rootlessly" and "rootfully" to recognized words

* Use proper `code` blocks and improved grammar

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

* Use real tbot image name

* Linter doesn't like angle brackets

---------

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2025-03-06 22:50:08 +00:00
Tim Buckley e512ff1253 Machine ID: Document kubernetes/v2 service (#52783)
* Machine ID: Document `kubernetes/v2` service

This adds initial documentation for the new `kubernetes/v2` service.

This only includes reference documentation for now, since this
service was added partway through v17; the existing Kubernetes guide
will be updated in a separate PR for v18 and won't be backported to
v17.

Partially fixes #52412

* Review feedback, and add an FAQ entry about the new service

* Add more detailed version note

* Fix broken link
2025-03-06 00:54:19 +00:00
Paul Gottschling 753277c42d Change Notices to Admonitions (#52801)
We are deprecating the Notice component since it is not supported
natively in Docusaurus and the Docusaurus-native Admonition component
serves the same purpose.
2025-03-05 18:28:20 +00:00
Paul Gottschling 0fbbeff50c Replace Notices with Docusaurus syntax (#52634)
Use Docusaurus syntax for admonitions so the docs engine does not need
to replace these. This is one step toward removing the
`remark-update-tags` plugin. See: gravitational/docs-website#94

Relevant commands are included below to make reproducing this work
easier.

1. Replace all `Notice` tags with `Admonition` tags.

2. Add `type="info"` if an Admonition is missing a type.

   To find instances:

   ```
   find docs/pages -name "*.mdx" -exec awk '
   BEGIN{a=0}
   a==0 && /<Admonition/{ a = 1 }
    a==1 && /type/{t = 1}
    a==1 && />/{ a = 0; if(t == 0) print FILENAME ":" FNR }' {} \;
   ```

3. Replace `type="notice"` with `type="note"`.

   To find instances:

   ```
   find docs/pages -name "*.mdx" -exec awk '
   BEGIN{a=0}
   a==0 && /<Admonition/{ a = 1 }
    a==1 && /type="notice"/{t = 1}
    a==1 && />/{ a = 0; if(t == 1) print FILENAME ":" FNR }' {} \;
   ```
2025-03-04 15:51:27 +00:00
Steven Martin 187b6ff317 docs: update db port examples to 443 (#52559) 2025-03-04 13:21:33 +00:00
Zac BergquistandJoao Ubaldo a297c17a3f Support setting the public addr for apps discovered in Kube clusters (#52642)
Signed-off-by: Zac Bergquist <zac.bergquist@goteleport.com>
Co-authored-by: Joao Ubaldo <me@joaoubaldo.com>
2025-03-03 15:42:47 +00:00
Dan Upton f9a3fd9c98 Workload ID: Document Support for Predicate Language (#52526)
* Workload ID: Document Support for Predicate Language

* Much clearer wording and fix linting errors
2025-03-03 12:13:54 +00:00
Steven Martin 3acf2af450 Fix spelling identity center assignment desc (#52674) 2025-03-03 00:41:23 +00:00
7669c4e4ce docs: Remove references to tsh aws proxy --endpoint-url mode (#52493)
* refactor(docs): remove --endpoint-url reference and add troubleshooting section

* Apply suggestions from code review

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
Co-authored-by: STeve (Xin) Huang <xin.huang@goteleport.com>

---------

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
Co-authored-by: STeve (Xin) Huang <xin.huang@goteleport.com>
2025-02-28 23:37:46 +00:00
39fc6a7cbb [teleport-update] Agent managed updates documentation (#52024)
* docs wip

* wip 2

* wip 3

* remove roles

* wip

* wip 4

* wip 5

* wip 6

* cli 1

* next

* cli ref

* Autoupdate docs edition:

- ban subjective and marketting words such as "new", "old", "original",
  "next-generation", "previous", and consolidate to Managed Updates v1/v2
- change the installation snippets to document the unified installer
  (except the linux-cloud one).
- change the autoupdate architecture page to reflect the design changes
  between v1 and v2
- make the autoupdate v2 guide not Cloud-specific
- fix configuration examples
- add troublshooting commands

* Fix broken links

* managed updates -> Managed Updates

* fixup! Fix broken links

* finish teleport-update reference, fix typo

* Add unified installer + align names + fix typos

* style feedback

* title fixes

* cleanup

* lint

* Address feedback + fix spell + fix bash command

Signed-off-by: hugoShaka <hugo.hervieux@goteleport.com>

* Simplify install script docs + fix links

Signed-off-by: hugoShaka <hugo.hervieux@goteleport.com>

* try to appease linter

* fixup! try to appease linter

* Apply suggestions from code review

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

* Address final feedback

---------

Signed-off-by: hugoShaka <hugo.hervieux@goteleport.com>
Co-authored-by: hugoShaka <hugo.hervieux@goteleport.com>
Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2025-02-28 20:49:13 +00:00
0212ee6730 Update tctl reference docs with autoupdate commands (#52455)
* Update `tctl` reference docs with autoupdate commands

* Documentation feedback

---------

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

* Update docs/pages/reference/cli/tctl.mdx

Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>

---------

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>
2025-02-28 17:39:02 +00:00