Repository files navigation

Tpot is a simple tsh teleport wrapper. Currently, we are not able to get list of available node in tsh. Usually, to get thelist of nodes we need to go through teleport web ui then creating an alias to accessible through tsh. This make you're able toget list of nodes from Terminal, pick one then login to the node bytsh.

• Support multiple environment
• Browsing the node list and search it
• You're able to get the node list from a cache or fresh from the teleport server

this tool simply store the proxy environment under your$HOME/.tpot/ directory.whenever you try to get the node list it'll ask the teleport server to give the latest node list. Once, we got it, it'll storein the configuration file for caching purpose.

This tool requirestsh is installed in your machine.if you don't have it yet, you can download & install fromthis.

brew tap adzimzf/tpotbrew install tpot

to install this tool you can run this command.

curl  https://raw.githubusercontent.com/adzimzf/tpot/master/download.sh| sh

or

wget -O - https://raw.githubusercontent.com/adzimzf/tpot/master/download.sh| sh

It'll copy the binary to/usr/bin.

If you want to install into a specific directory you can add arguments-s -- -b "directory", for example:

curl  https://raw.githubusercontent.com/adzimzf/tpot/master/download.sh| sh -s -- -b"/home/myuser/Desktop"

If you are familiar withGolang/Go and yourGolang version isgo1.16 you can install usinggo install by running this command:

go get github.com/adzimzf/tpotgo install github.com/adzimzf/tpot

Before use this tools you need to add proxy configuration first by run this command

tpot -c --add

It'll prompt your config editor, by default it'll usenano

• Environment is an identifier for your proxy config, eg.staging andprod
• Proxy address is a valid proxy address in http protocol, eg.https://teleport.myport.com:3080
• User name ia a user name used for teleport login. eg.adzimzf
• Auth Connector ia a 3rd party auth connector for SSO. eg.gsuite
• Need 2Fa does the proxy need 2FA or not. egtrue orfalse

you can change the default editor by running this command

tpot -c --edit

or

tpot --config --edit

if the configuration installed successfully you can start usetpot by running this command

tpot staging

or

tpot staging -a

will get the node from the server then append to the cache,or

tpot staging -r

When the list of node shows, you can navigate byRIGHT,LEFT,UP andDOWN. For searching the node, you can type thenode name then hitTAB.HitENTER to select the node and login.

to get the node server instead ofcache. if it gives you an errorPermision denied, you can manually addtpot config dir by running this command

mkdir$HOME/.tpot

with775 permission, then you can re-add the configuration

That's all hope you find your need