[v14] docs: update server access guides (#47037)

* docs: update server access guides * docs: remove version 12.1 reference * docs: update api user --------- Co-authored-by: Steven Martin <[email protected]>
gravitational · Oct 1, 2024 · 9c75249 · 9c75249
1 parent c987b82
commit 9c75249
Show file tree

Hide file tree

Showing 5 changed files with 15 additions and 7 deletions.
diff --git a/docs/pages/admin-guides/access-controls/idps.mdx b/docs/pages/admin-guides/access-controls/idps.mdx
@@ -3,8 +3,8 @@ title: Configure Teleport as an identity provider
 description: How to set up Teleport's identity provider functionality
 ---
 
-Since Teleport 12.1 users can authenticate to both internal and external applications
-through the use of a built in identity provider.
+Users can authenticate to both internal and external applications
+through the use of a built in identity provider in Teleport.
 
 - [SAML Guide](./idps/saml-guide.mdx): A guide for setting up an example application to integration with the SAML identity provider.
 - [SAML Attribute Mapping](./idps/saml-attribute-mapping.mdx): A reference on how attribute mapping works in Teleport and how to

diff --git a/docs/pages/admin-guides/api/getting-started.mdx b/docs/pages/admin-guides/api/getting-started.mdx
@@ -31,9 +31,7 @@ Here are the steps we'll walkthrough:
 Create a user `api-admin` with the built-in role `editor`:
 
 ```code
-# Run this directly on your Auth Server unless you are using Teleport Cloud
-# Add a user and login via the Proxy Service
-$ sudo tctl users add api-admin --roles=editor
+$ tctl users add api-admin --roles=editor
 ```
 
 ## Step 2/3. Generate client credentials

diff --git a/docs/pages/enroll-resources/server-access/guides/jetbrains-sftp.mdx b/docs/pages/enroll-resources/server-access/guides/jetbrains-sftp.mdx
@@ -12,7 +12,7 @@ This guide explains how to use Teleport and a JetBrains IDE to access files with
 
 ## Prerequisites
 
-(!docs/pages/includes/edition-prereqs-tabs.mdx!)
+(!docs/pages/includes/edition-prereqs-tabs-not-admin.mdx!)
 
 - JetBrains IDE like PyCharm, IntelliJ, GoLand etc. See [Products](https://www.jetbrains.com/products/#type=ide) for a full list of JetBrains IDEs.
 - One or more Teleport SSH Service instances. If you have not yet done this,

diff --git a/docs/pages/enroll-resources/server-access/guides/vscode.mdx b/docs/pages/enroll-resources/server-access/guides/vscode.mdx
@@ -8,7 +8,7 @@ This guide explains how to use Teleport and Visual Studio Code's remote SSH exte
 
 ## Prerequisites
 
-(!docs/pages/includes/edition-prereqs-tabs.mdx!)
+(!docs/pages/includes/edition-prereqs-tabs-not-admin.mdx!)
 
 - OpenSSH client.
 - Visual Studio Code with the [Remote - SSH extension](https://code.visualstudio.com/docs/remote/ssh#_system-requirements)

diff --git a/docs/pages/includes/edition-prereqs-tabs-not-admin.mdx b/docs/pages/includes/edition-prereqs-tabs-not-admin.mdx
@@ -0,0 +1,10 @@
+{{ version="(=teleport.version=)" }}
+
+- A running Teleport cluster version {{ version }} or above. If you want to get started with Teleport, [sign
+  up](https://goteleport.com/signup) for a free trial or [set up a demo
+  environment](../admin-guides/deploy-a-cluster/linux-demo.mdx).
+
+- The `tsh` client tool.
+
+  Visit [Installation](../installation.mdx) for instructions on downloading
+  `tsh`.