Commit Graph
3083 Commits
Author SHA1 Message Date
Brian Joerger 9415702773 Update affected docs. (#37960) 2024-02-12 18:41:54 +00:00
Edward Dowling 3455f3b6b1 Fix opsgenie plugin to use correct annotation to determine whether or not to create alerts (#37929)
* Fix bug in opsgenie plugin mixing up notify-services and schedules

* Update docs for opsgenie plugin to use correct schedules

* Remove accidental change to opsgenie client

* Update opsgenie client tests
2024-02-12 17:38:15 +00:00
Gus Luxton 8b6db1d117 docs: Recommend correct versions of Docker images for Teleport Team/Teleport Cloud (#38033) 2024-02-12 14:49:19 +00:00
6fafba9119 Update backend reference with working proxy configuration (#37934)
* Update backend reference with working proxy configuration

the local loopback does not work in this case.  After discussing internally, recommendation is to use 0.0.0.0 for the diag addr but with a warning this should NOT be exposed to the public internet or used on other instances

* Update backends.mdx

* Update docs/pages/reference/backends.mdx

Co-authored-by: Steven Martin <steven@goteleport.com>

* Update docs/pages/reference/backends.mdx

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

* Update backends.mdx

* Update docs/pages/reference/backends.mdx

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

---------

Co-authored-by: Steven Martin <steven@goteleport.com>
Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>
2024-02-12 14:43:16 +00:00
Gus Luxton 44819b675e docs: Use different versions of Teleport Windows auth package for Team/Cloud (#38010)
* docs: Use different versions of Teleport Windows auth package for Team/Cloud

* Combine OSS/Enterprise and Team/Cloud for tidiness

* Disable lint for out-of-order markers

Using the regular 1. 1. 1. style does not work when broken by tabs
2024-02-09 19:42:10 +00:00
rosstimothy 5ba0488858 Recommend on-demand mode and continuous backups in DynamoDB docs (#37920)
* Recommend on-demand mode and continuous backups in DynamoDB docs

Removes mention to provisioned mode and manually setting capacity
in favor of using on-demand mode. Enabling continuous backups was
also elevated into the main configuration reference since they are
strongly encouraged.

Additionally all occurrences of `back-end` were replaced with
`backend` to be consistent with all other usages.

* remove autoscaling references from aws chart docs
2024-02-08 17:36:18 +00:00
dec9de9e4f Add a guide for setting up Access Graph on-prem (#37661)
* Add a guide for setting up Access Graph on-prem

* Update docs/pages/access-graph/getting-started-on-prem.mdx

Co-authored-by: Tiago Silva <tiago.silva@goteleport.com>

* Update minimum required Teleport version

* Address review suggestions

* Note support for Amazon RDS

* Add a note about Teleport Policy

* Move license requirement to "Prerequisites"

* Bump TAG version in docs

* Address review comments

* Update docs/pages/access-graph/getting-started-on-prem.mdx

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

* Update Access Graph menu item image

* Update wording in Teleport Team notice

* Expand on requirements for the TLS certificate

* Apply suggestions from code review

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

* Move access-graph pages under access-controls

* Get rid of extraneous tags

* Add a short introduction to the guide

* Elaborate where the TAG config should live

* nit

* Rename the TAG self-hosted guide

* Fix image paths after access-graph renaming

---------

Co-authored-by: Tiago Silva <tiago.silva@goteleport.com>
Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>
Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2024-02-08 16:18:17 +00:00
STeve (Xin) Huang 902c3e22cd More DB auto-user troubleshooting (#37659)
* More DB auto-user troubleshooting

* review comments

* fix lint/spell

* remove Admonitions for mysql compat
2024-02-08 14:28:13 +00:00
Brendan O'Halloran 071fe0a774 docs: cloud tenant upgrade - bump v14.3.4 (#37807) 2024-02-08 12:38:13 +00:00
Tiago Silva d3d9c1f73f Update cert-manager instructions in Teleport cluster guides (#37840)
This commit updates the `cert-manager` installation instructions to configure the `cert-manager` leader election to use `cert-manager` namespace instead of `kube-system`.

This is required because in GCP Autopilot clusters lock down access to `kube-system` and helm installation can't be successful.

By default, `cert-manager` uses `kube-system` as leader election to prevent multiple parallel installations of `cert-manager` in the same cluster, but if it's already running in the target cluster, the installation will fail with a non clear error. Given the above, it's preferred to use a separate namespace for leader election to prevent races.

Fixes #25312

Signed-off-by: Tiago Silva <tiago.silva@goteleport.com>
2024-02-08 09:47:34 +00:00
Gavin Frazar e95f884283 [docs] update self-hosted db guides (#37606)
* fix indentation of note in mongo guide

* note redis version limits next to version prereq

* extract custom db tls CA snippet from MongoDB

* update pre-reqs for self-hosted cluster databases

* expand tls config setup in CockroachDB guide

* remove redis cluster tls-cluster no config tab

This config still requires a custom CA, so it's pointless
and less secure.
It also doesn't work with the rest of the guide steps currently.

* use code block instead of sh in redis cluster doc

* dont explain tctl auth sign setup when unused

* fix redis-cluster code block

* describe teleport trust setup last

* clarify cluster creation certs

* use more descriptive tab labels for cockroachdb

* only mention lack of support for RESP3

redis 7.0 is supported with RESP2, no need to call it out.
2024-02-08 00:27:42 +00:00
Steven MartinandPaul Gottschling 22efef8ef4 docs: update docker installation for distroless info (#37801)
* docs: update docker installation for distroless info

* remove version change info for distroless

* add instrs on interacting with distroless

* Update language

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

* Update installation.mdx

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

---------

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2024-02-07 23:49:12 +00:00
Olu Oshati a7db4ec0e2 add spec section to automatic-agent update docs (#37729) 2024-02-07 20:56:02 +00:00
Alan Parra 5602d9c24e chore: Bump Go toolchain to 1.22.0 (#37845)
* chore: Bump Go to 1.22.0

* Bump Go version on docs

* Fix testing bug in ./lib/auth/webauthn
2024-02-07 19:50:26 +00:00
Hugo Shaka a2f748ccbb charts/kube-agent: support restricted PSS by default (#37821)
* charts/kube-agent: update secContext to support restricetd PSS

* re-render templates entirely
2024-02-06 18:37:36 +00:00
Noah Stride 55ed0660f6 Fix image name for Kubernetes/Machine ID guide (#37786)
* Fix image name for Kubernetes/Machine ID guide

* Fix other reference to old non-distroless image
2024-02-06 15:34:41 +00:00
Noah Stride 33f228427e Avoid use of canonical hostname in Ansible guide (#37744) 2024-02-06 09:21:30 +00:00
Steven Martin 06c1a05fae docs: include separate in helm reference for proxyListenerMode (#37733) 2024-02-05 15:52:28 +00:00
Reed Loden e2d69aedde Post-major version release activities (#37676)
From `docs/postrelease.md`:
- [x] Update `branchMajorVersion` const in Dronegen `/dronegen/container_images.go`, then run `make dronegen`
- [x] Update `CURRENT_VERSION_ROOT`, `PREVIOUS_VERSION_ONE_ROOT`, and `PREVIOUS_VERSION_TWO_ROOT` variables in `.drone.yml`, then run `make dronegen`
  - Example: https://github.com/gravitational/teleport/pull/4602
- [x] Create PR to update default Teleport image referenced in docker/teleport-quickstart.yml
  - Example: https://github.com/gravitational/teleport/pull/4655
- [x] Create PR to update default Teleport image referenced in docker/teleport-lab.yml
2024-02-01 22:08:58 +00:00
Steven Martin 103991751f docs: move team to cloud uninstall section instructions (#37632) 2024-02-01 20:24:35 +00:00
Brian JoergerandPaul Gottschling 272732dbbd Add MFA for admin actions docs (#37631)
* Add MFA for admin actions docs.

* Address comment.

* Fix broken links.

* Edits.

* Apply suggestions from code review

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

---------

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2024-02-01 19:37:09 +00:00
STeve (Xin) Huang c26314652a [docs] IAM-auth-as-IAM-roles for Redshift (#34940)
* [docs] IAM-auth-as-IAM-roles for Redshift

* new section for iam role auth

* clarify two methods

* review comments

* fix spelling, thanks to docs lint!
2024-02-01 16:52:50 +00:00
Paul Gottschling ca1dc578c9 Update the edition comparison chart (#37370)
Closes #37106

- Add a section re: IGS and move applicable row items into it
- Rename "Open Source" to "Community Edition" in line with guidance
- Alphabetize sections and rows within each section
2024-02-01 15:40:12 +00:00
Paul Gottschling 6c074b4ed0 Update the index page for v15 (#37124)
- Fix a minor error in the Prerequisites section that refers to the
  "prerequisites above" when they are, in fact, below.
- Update the resource view screenshot.
- Update the explanation of the UI flow for enrolling a new resource.
2024-02-01 15:28:56 +00:00
Hugo ShakaandRoman Tkachenko b8deacfaff update tf ref and changelog (#37590)
* update tf ref and changelog

* Apply suggestions from code review

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

* fix md

* typos

* typo2

* lint

---------

Co-authored-by: Roman Tkachenko <roman@goteleport.com>
2024-01-31 19:16:29 +00:00
Nic KlaassenandPaul Gottschling e42dfc5621 docs: AWS KMS (#37388)
* docs: AWS KMS

* Apply suggestions from code review

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

* use aws-credentials partial

* add mention to enterprise introduction

* remove "on disk" from gcp page too

* fix cspell

---------

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2024-01-31 16:48:02 +00:00
Rafał Cieślak d7e36b2f3d Add docs for application access in Teleport Connect (#37177)
* Move Connect My Computer section after sections dedicated to resources

Connect My Computer is not that important to have it before sections
dedicated to different kinds of resources.

* Adjust existing resource sections to changes brought by Unified Resources

* Add docs for application access in Connect

* Update link to docs in app gateway document

* Update supported app kinds

* Update instructions based on recent UI changes

* HTTP apps -> web apps
2024-01-31 15:18:01 +00:00
Rafał Cieślak 5d4b01231d Update Connect screenshots to match look of v15 (#37522) 2024-01-30 17:21:25 +00:00
Hugo Shaka 6841c77574 helm: make proxies replicable when usign an ingress (#37430) 2024-01-29 21:54:25 +00:00
Hugo Shaka 70b37da284 document role versions 5, 6 and 7 (#37360) 2024-01-29 16:57:48 +00:00
Ben Arent 21e3b666d7 Change Labs invite (#37380) 2024-01-29 16:44:02 +00:00
Steven MartinandMarco André Dinis bb323eace0 update access request plugin download domain (#37413)
* update access request plugin download domain

* teleport version spec

Co-authored-by: Marco André Dinis <marco.dinis@goteleport.com>

---------

Co-authored-by: Marco André Dinis <marco.dinis@goteleport.com>
2024-01-29 15:29:14 +00:00
Paul Gottschling 87907ede34 Update version variables for v15 (#37116)
Change the `docs/config.json` version variable values for `teleport` to
reflect the fact that the `master` branch represents v16.
2024-01-26 20:52:13 +00:00
Paul Gottschling 9bf68d510b Update docs version mentions to reflect v15 (#37094)
* Update docs version mentions to reflect v15

- Remove mentions of pre-v12 versions. We mention the version prior to
  the earliest supported version in case some users still need to
  upgrade.

  This includes removing the Helm migration guide from v11 to v12. The
  idea is that Teleport users should be on v12 already (the earliest
  supported version before we released v15), so this guide should not be
  needed.

- Updated the supported version table in the FAQ.

* Respond to feedback

Restore the v12 migration guide with a note to remove it in v16.
2024-01-26 20:30:37 +00:00
Paul SchisaandZac Bergquist c6ba1cbca1 Update usage docs with the reporting endpoint (#37359)
* Update usage docs with the reporting endpoint

adding the actual reporting endpoint to our public docs for customers who need to whitelist a specific outbound reporting endpoint

* Update docs/pages/usage-billing.mdx

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

* Update cspell.json

fix lint issue

---------

Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>
2024-01-26 20:20:30 +00:00
21209affb7 Document operator changes in v15 (#37294)
* Document operator changes in v15

* Apply suggestions from code review

Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>
Co-authored-by: Tiago Silva <tiago.silva@goteleport.com>

* address feedback

* make docs linter happy

---------

Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>
Co-authored-by: Tiago Silva <tiago.silva@goteleport.com>
2024-01-26 20:09:20 +00:00
Paul Gottschling 969ad63063 Update the Team Getting Started guide (#37340)
- Update instructions and images to match the v15 UI.
- Minor readability improvements.
- Replace `mytenant` with `example` in example URLs since we're phasing
  out the "tenant" language.
2024-01-26 17:52:03 +00:00
Paul Gottschling d217b87d76 Add an overview of the Teleport documentation (#34476)
* Add an overview of the Teleport documentation

Closes #34038

Help visitors to the Teleport documentation find their way through the
docs site by including a description of each docs page in an overview
guide.

This change is based on adapting the former Teleport index page (prior
to #27703).

* Minor grammar and language tweaks
2024-01-25 19:25:08 +00:00
Sakshyam Shah 1b2ba5c2a1 docs: SAML attribute mapping (#36650)
* saml attribute mapping reference

* formatting

* rename test_attribute_mapping to test-attribute-mapping

* - copy edits
- update add method to show set().add() and set(values) syntax
- update strings.split() syntax

* address review comments:
- move prerequisite up
- remove description from predicate evaluation context table
- copy edits

* - add attribute mapping reference to idp.mdx (root page)
- add a line explaining the context of the page
- move attribute mapping context inside Predicate expressions heading
- remove tctl reference

* revert previous commit on saml-attribute-mapping.mdx

* - move concept to top of the page
- add tctl reference back

* single identation for sub nesting

* single indent for attribute mapping name format

* update saml reference copy on idp.mdx (root page)
2024-01-25 15:59:24 +00:00
Steven Martin 6858df833f docs: update signature urls to use cdn.teleport.dev (#37205) 2024-01-24 21:17:53 +00:00
Paul Gottschling 2848500c40 Remove the Restricted Session page (#37189)
We removed this feature in v15, so remove the guide from the docs and
add a redirect. v14 users can refer to v14 of the docs, which includes
the guide along with a deprecation notice.
2024-01-24 21:05:53 +00:00
Paul Gottschling ee09f96330 Minor improvements to the Kubernetes Cluster guide (#37176)
Based on following the guide per the v15 test plan:

- Be more explicit that we expect the `member` role to be defined in a
  file called `member.yaml`.
- Be more explicit re: replacing the `myuser` variable with the name of
  your user.
2024-01-24 20:43:17 +00:00
Mike Jensen 09a33d86d6 Remove account lockout from failed recovery attempts (#35325)
* Remove account lockout from failed recovery attempts

This account lockout looks to be unecessary and potentially problematic.  Recovery codes and recovery through MFA are not possible to brute force.

In addition the potential to lockout an account from being able to use a recovery method could result in them being unable to unlock their account from other potential abuse cases (for example an attacker locking the account from failed password attempts).

As discussed in the RFD (https://github.com/gravitational/teleport/pull/35533) this includes the removal of all the API used for this locking mechanism.

* accountrecovery: Update `WithLock` function names

* accountrecovery: Combine verifyRecoveryCode and verifyRecoveryCodeWithRecord into one function

* Further GRPC cleanup after PR feedback

* Apply PR Feedback
2024-01-24 18:17:52 +00:00
5c27bc62ea docs: mention supported AWS regions for cloud (#37109)
* docs: describe for ent cloud ability to select auth, backend location

* update avail zone desc

Co-authored-by: Brendan O'Halloran <bpdohall@gmail.com>

* verbiage updates

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

---------

Co-authored-by: Brendan O'Halloran <bpdohall@gmail.com>
Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>
2024-01-24 15:15:21 +00:00
Gavin Frazar e156419135 update self-hosted database guides (#36260)
* update self-hosted database guides

* update cockroach db pre-req

* update mongo db pre-req

* update redis cluster labels example
2024-01-24 01:41:00 +00:00
Nic Klaassen 8cbb77f442 docs: testplan updates (#37069)
* update EAS screenshot

* minor improvements to CloudHSM instructions
2024-01-24 01:00:39 +00:00
Krzysztof SkrzętnickiandPaul Gottschling 0d877b1c5b Add a note regarding default db permissions (#37086)
* Add a note regarding default db permissions

* Reformat, steer away from modifying `teleport-auto-user`

* Update docs/pages/database-access/auto-user-provisioning/mysql.mdx

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

* Update docs/pages/database-access/auto-user-provisioning/mysql.mdx

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

---------

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2024-01-24 00:46:43 +00:00
Cam Hutchison 4d0aeda012 docs: Fix description of location of -fips suffix on AMIs (#36999)
* docs: Fix description of location of -fips suffix on AMIs

The `-fips` suffix appears after the `<arch>` component, not before as I
previously documented in 1548a43 (I saw some v15 dev builds with -fips
after the version, but they were from before <arch> was added).

This can be seen with:

    aws --region us-west-2 ec2 describe-images --owners 146628656107 --filters 'Name=name,Values=teleport-ent-15.0.0-alpha.5-*-fips-*'

* docs: Add example for FIPS AMI
2024-01-23 21:49:19 +00:00
Steven Martin 875e9337e0 docs: updates for GCP discovery instructions (#36952)
* docs: updates for GCP discovery instructions

* Include required permissions
2024-01-23 17:41:53 +00:00
Sakshyam Shah 9eac64c723 docs: Add SAML service provider with entity id and acs url (#36467)
* add service provider with entity id and acs url. make entity descriptor optional config

* move dedicate role creation to end of the guide

* review comments:
- copy edits
- use add-role-to-user.mdx to reference role update

* reference content of entity descrptor takes priority over other values

* copy edits:
- use lower case for service provider
- use generic service provider name instead of directly referencing samltest.id
- update test saml application copy

* fix typo
2024-01-23 01:00:36 +00:00