Fork me on GitHub

Teleport

Getting Started With Teleport Cloud

Improve

Here is a simple set of steps to access your cloud from the command line and easily add your first Server access.

Step 1/5 Sign up

Sign up for a cloud account here.

Step 2/5 Access Web Console

Access Web Console Access Web Console

Select Add Server and press COPY to copy the script command Add Server Script

Step 3/5 Install Teleport Agent on Server

Paste and run script

Past Install Script

Teleport Agent Installed Completed Install

Step 4/5 Access Server

Select close and Server can be accessed Access Server

Step 5/5 Access from Command Line

Install client libraries:

curl -O https://get.gravitational.com/teleport-ent-v10.3.1-linux-amd64-bin.tar.gz

verify signature

echo "$(curl https://get.gravitational.com/teleport-ent-v10.3.1-linux-amd64-bin.tar.gz.sha256)" | sha256sum --check
tar -xzf teleport-ent-v10.3.1-linux-amd64-bin.tar.gz
cd teleport-ent
sudo ./install

Login into Teleport and test the connection:

tsh logs you in and receives short-lived certificates

tsh login --proxy=myinstance.teleport.sh [email protected]
tsh ls

Node Name Address Labels

--------- ---------- ------

myserver ⟵ Tunnel

When Teleport's Auth Service receives a request to list Teleport Nodes (e.g., to display Nodes in the Web UI or via tsh ls), it only returns the Nodes that the current user is authorized to view.

For each Node in the user's Teleport cluster, the Auth Service applies the following checks in order and, if one check fails, hides the Node from the user:

  • None of the user's roles contain a deny rule that matches the Node's labels.
  • None of the user's roles contain a deny rule that matches the user's login.
  • At least one of the user's roles contains an allow rule that matches the Node's labels.
  • At least one of the user's roles contains an allow rule that matches the user's login.

If you are not seeing Nodes when expected, make sure that your user's roles include the appropriate allow and deny rules as documented in the Teleport Access Controls Reference.

Type exit to end this session. Happy Teleporting!

Next Steps