Commit Graph
534 Commits
Author SHA1 Message Date
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
Bernard Kim bd8933ef51 access_monitoring_rule: Support spec.automatic_approval field (#52274)
* Support automatic_approval in AMR spec

* Support filter by automatic_approval_name

* Update AMR validation

* Update terraform schema

* Fix import

* Add additional test case

* Improve amr spec godocs

* make -C integrations/terraform docs
2025-02-27 19:04:24 +00:00
Paul Gottschling 41310d2bca Address 67 Vale warnings (#52511)
- Fix "Auth Service" variations.
- Fix some AWS product naming violations.
- Ignore some false positives.
- Fix capitalization warnings.
- Address warnings re: outdated product names.

Some of the warning categories above include auto-generated pages. This
change does not touch the generators in order to simplify things.
2025-02-27 17:15:40 +00:00
Dan Upton 74fb5be7cb Workload ID: Support Predicate Language (#52460)
* Add new `expression` package in workload identity service

* Add traits to the `Attrs` proto message

* Add support for user traits to the `expression` package

* Use `expression` package to template Workload Identities

* Add support for expressions to Workload Identity rules

* Update terraform docs

* Error instead of returning zero value for unset fields

* Fix linting failures

* Codify edge cases
2025-02-27 10:52:08 +00:00
Hugo Shaka 61e58e9d82 helm: Support tuning readiness probe (#52535)
* helm: support setting the readiness in teleport-cluster

* update snapshots

* fix typo
2025-02-26 22:34:25 +00:00
Paul Gottschling ccfa399d35 Fix 45 Vale warnings (#52483)
- Fix Var components that only have a single instance on a page
- Replace "Teleport agent" with "Teleport Agent"
2025-02-25 20:53:25 +00:00
TarasandNoah Stride 417ffdda01 tbot env variable configurations (#52305)
* `tbot` add env var configs

* add `start` cmd to tbot-distroless images

* Update CLI reference

---------

Co-authored-by: Noah Stride <noah.stride@goteleport.com>
2025-02-20 12:54:13 +00:00
Dan Upton fd2edb678c Machine ID: Per-ouput credential_ttl and renewal_interval (#51956)
* Move `CertificateTTL` and `RenewalInterval` into a `CertificateLifetime` struct

These values are always required together, and moving them into a struct will
make it more straightforward to override them per-service/output.

* Support custom `certificate_ttl` and `renewal_interval` on identity output

* Support custom `certificate_ttl` and `renewal_interval` on application output

* Support custom `certificate_ttl` and `renewal_interval` on application tunnel

* Support custom `certificate_ttl` and `renewal_interval` on Kubernetes output

* Support custom `certificate_ttl` and `renewal_interval` on Kubernetes V2 output

* Support custom `certificate_ttl` and `renewal_interval` on database tunnel

* Support custom `certificate_ttl` and `renewal_interval` on SSH host output

* Support custom `certificate_ttl` and `renewal_interval` on SSH multiplexer

* Support custom `certificate_ttl` and `renewal_interval` on SPIFFE SVID output

* Support custom `certificate_ttl` and `renewal_interval` on database output

* Support custom `certificate_ttl` and `renewal_interval` on workload API

* Support custom `certificate_ttl` and `renewal_interval` on workload identity output

* Add `GetCertificateLifetime` to service config interface

* Update the docs

* Add more examples to the standard config

* Rename `CertificateLifetime` to `CredentialLifetime`

So it can be used for non-certificate credentials like JWTs

* Deprecate `certificate_ttl` option and replace it with `credential_ttl`

* Return TTL warnings as errors and let the caller decide what to do with them

* Add `CredentialLifetime` to the "full" service config tests

* Support `credential_ttl` and `renewal_interval` in workload-identity-jwt service

* Silence sloglint

* Replace duplicated helper with `cmp.Or`
2025-02-14 14:42:17 +00:00
Andrew Burke f3a18d09f8 Oracle join method - Add docs (#51936)
This change adds documentation for the Oracle join method
2025-02-10 21:41:27 +00:00
Edward Dowling e8435a55c2 Add flag to allow s3 virtual style addressing (#49835) 2025-02-10 16:47:34 +00:00