Commit Graph
25 Commits
Author SHA1 Message Date
Noah Stride 4a43c5a252 Improve Access Plugins/Audit Exporter docs flows (#36083)
* Fix mattermost identity file path

* Adjust event handler docs

* Update rest of access plugins
2024-01-02 18:32:31 +00:00
Paul Gottschling 9ff60d63b2 Refresh the Jira Access Request plugin guide (#35635)
Closes #14580
Closes #17528

Get the Jira guide to follow the structure of other Access Request
plugin guides, including instructions for Teleport Cloud and Machine ID
users.

Also make some small adjustments for clarity and readability:
- Flesh out the intro to include sarchitectural information.
- Make the prerequisites list more comprehensive.
- Fix the list of columns required in the project board, which is out of
  date.
- Mention the `/status` endpoint of the webhook.
2023-12-19 21:39:53 +00:00
Brian Joerger cf6473feb9 Add gRPC error interceptors to API client (#30578)
* Move gRPC error intercetpors to api/utils/grpc/interceptors.

* Use error interceptors in api client and mock server.

* Apply suggestions from CR.

* Unwrap FromGRPC errors in middleware.

* Use gRPC auth service in tests instead of external example service.

* It's gRPC!!!

* Fix unit test.

* Add error interceptor to proxy client.

* Fix merge conflict.
2023-08-24 23:27:06 +00:00
Paul Gottschling 322cb2d026 Include consistent installation info (including Helm) across Access Request plugin docs (#26783)
* Use partial for Access Request plugin install docs

The Access Request plugin installation instructions are _almost_
standard. Make the instructions more consistent and easier to edit by
replacing them with a partial. Use our partial parameter substitution
syntax to supply the name of each plugin.

* Respond to alexfornuto feedback

* Add a missing `sudo`

Partially responds to stevenGravy feedback

* Add consistent Helm details

Ensure all Access Request plugin guides include the same Helm-related
steps. Excluding the Jira plugin because that guide is out of date and
will be addressed in a separate change.

Also removes the "Feedback" section from each Access Request plugin
guide.  These are out of step with the rest of the docs, which don't
include a feedback section, and do not reflect the current location of
the Access Request plugin source.

* Spelling and linter fixes
2023-08-14 16:16:40 +00:00
Steven Martin 32a6e6a5d1 remove sentence fragment and link (#28367) 2023-06-29 17:16:25 +00:00
Steven Martin bebef91be8 docs: make consistent access request plugins helm configuration and instructions (#24654)
* docs: make consistent helm configuration and instructions

* Language updates and identity file fix

* fix identity file refs

* label as Teleport Enterprise Cloud, not Teleport Cloud
2023-04-18 19:26:51 +00:00
Paul Gottschling 0cde85ebc0 Edit cluster joining info in Access Request docs (#23405)
* Edit cluster joining info in Access Request docs

See #21305

Edit Access Request plugin guides to remove the options to connect to
the Auth Service directly. This simplifies the guides and helps us
standardize the docs around connecting services via the Proxy Service.

Also make the Jira guide more consistent with other Access Request
plugin guides (this is not an attempt to refresh the guide, which is
still out of date, but will help us refresh the guide when the time
comes).

* Fix linter issues

* Respond to PR feedback
2023-03-29 19:28:58 +00:00
Steven Martin d281fd7c8e Examples spell fixes and discord example fix (#22606) 2023-03-03 22:45:08 +00:00
Hugo ShakaandPaul Gottschling a2b5a37f94 Document Discord access plugin (#17593)
* Document Discord access plugin

* Apply suggestions from code review

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

* fixup! Apply suggestions from code review

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2022-11-25 21:43:58 +00:00
Alex Fornuto e09671f562 remove apostrophe on non-possesive 'IDs' (#16837) 2022-10-28 19:22:53 +00:00
Steven Martin 9fb62b503f correct plugin name reference (#17013)
* correct plugin name

* correct plugin name
2022-10-04 19:37:49 +00:00
Bence Kiglics 41474a021d Add documentation for Slack Helm chart (#13726)
It includes an updated guide and the reference of the new Helm chart.
2022-09-26 10:11:17 +00:00
c9fbcc03ad Document MsTeams access plugin (#15941)
Co-authored-by: alexfornuto <alex@fornuto.com>
Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2022-09-22 18:35:06 +00:00
Bence Kiglics c522b38383 Add documentation for MatterMost Helm chart (#13728)
Includes an updated guide and the reference of the new Helm chart.
2022-09-08 11:49:30 +00:00
Bence Kiglics 5e476ed17d Add documentation for PagerDuty Helm chart (#13729) 2022-08-31 15:57:20 +00:00
Paul Gottschling 7204503cca Edit the PagerDuty Access Request plugin guide (#15498)
Fixes #14576

- Add updated instructions, as the behavior and configuration settings
  for the PagerDuty plugin have changed since we first added this guide.
- Ensure the guide can be followed as a set of step-by-step
  instructions. For example, this change tells the user to create two
  PagerDuty services and refers to these services throughout the page.
- Also edits example configs for the PagerDuty and Mattermost plugins.
2022-08-30 16:42:52 +00:00
Bence KiglicsandPaul Gottschling 6e246ab5c9 Add documentation for Jira Helm chart (#13730)
* Add documentation for Jira Helm chart

It includes an updated guide and the reference of the new Helm chart.

* Fixed some minor mistakes in the guides

* Reorganized Helm related examples

* Fixed a few minor mistakes

* Alphabetized jira.* settings

* Renamed Cloud to Executable in Testing

* Extended YAML config example with explanation

* Edit Jira Access Request plugin Helm chart docs

- Edit the configuration instructions so we don't instruct Helm users to
  use the `configure` subcommand. Also use the `Tabs` component's
  dropdown functionality so we can include both self-hosted and Teleport
  Cloud instructions for Helm and VM users.

- Minor style tweaks.

* Add Helm Chart example to Installation section

* Removed confusing (and broken) link
git push

* Fixed wrong default value

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2022-08-26 12:23:07 +00:00
Steven Martin 83256ed760 Spelling Fixes (#14815)
* Misspelling fixes
2022-07-23 20:24:45 +00:00
Brian JoergerandPaul Gottschling 5ec15cbbb9 Rework slack docs to reflect latest changes (#10607)
Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
2022-05-19 14:43:24 -07:00
Paul Gottschling 5f14bc5128 Add plugin setup instructions for cloud users (#9470)
* Add plugin setup instructions for cloud users

- Turn the identity file export and RBAC instructions into
includes, since these instructions are the same for each
plugin.

- Change the tab set re: an impersonation role to a detail box
scoped to cloud users.

- Add separate example config files for cloud and self-hosted
deployments of each plugin.

- Misc. changes for clarity

Fixes #8936

* Respond to PR feedback

Also make minor stylistic tweaks

* Respond to PR feedback with stylistic tweaks
2022-03-03 16:38:19 +00:00
Steven Martin 0a00f04665 Updated slack plugin instructions to allow for Teleport Cloud (#8540) 2021-10-14 08:33:10 -07:00
Alexander KlizhentasandBen Arent 06b7dc5fd2 Teleport Slackbot for latest slackbot (#6522)
Co-authored-by: Ben Arent <ben@goteleport.com>
2021-04-20 19:08:05 -07:00
Travis Swientek c538fb2e73 Workflow Documentation Fixes (#4111)
* Fixes documentation typo for Slack workflow.
* Improve the example workflow Slack toml comments.
* Remove --pid-file from workflow systemd units.
* PR feedback. teleport-slackbot -> teleport-slack
2020-07-24 10:17:59 -05:00
Ben Arent da216db761 Updated Teleport Jira Server Approval Plugin Docs & Updated Plugin TOML (#3879) 2020-06-25 10:11:38 -07:00
3976a99771 Teleport 4.3 Docs (#3423)
* Base fork for 4.3 docs

* [docs] external email identities and Kube Users (#3628)

* Base fork for 4.3 docs

* [docs] external email identities and Kube Users (#3628)

* Remove trailing whitespace from docs files

Some editors will do this automatically on save. This causes a lot of
diffs when editing the docs in such an editor.
Clean them up once now and we'll try to keep it tidy going forward.

* Add make rules for docs whitespace and milv

docs-test-whitespace: checks for trailing whitespace in all .md files
  under docs/.
docs-fix-whitespace: removes trailing whitespace in all .md files under
  docs/.
docs-test-links: runs milv in all docs/ subdirectories that have
  milv.config.yaml.
docs-test: runs whitespace and links tests, used during `make docs`

* Document the new `--use-local-ssh-agent` flag for tsh

The flag is used to bypass the local SSH agent even when it's running.
Specifically, this helps with agents that don't support certs.

The flag was added in #3721

* Remove pam_script.so docs from SSH PAM page

With #3725 we now populate teleport-specific env vars in a way that's
accessible to `pam_exec.so`. There's no longer any reason to install
pam_script.so separately and duplicate our docs.

Updates #3692

* Using the correct --insecure-no-tls flag

* Run docs-fix-whitespace make rule in a busybox container


* Fixes #3414

Co-authored-by: Andrew Lytvynov <andrew@gravitational.com>
Co-authored-by: Gus Luxton <gus@gravitational.com>
Co-authored-by: Steven Martin <steven@gravitational.com>
Co-authored-by: Gus Luxton <webvictim@gmail.com>
2020-06-17 17:09:41 -07:00