Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Network Requirements

The Teleport service is configured to use only standard ports 22, 80, and 443, to help with access wherever users are.

Additional configuration at the local user site may be required to allow outgoing connections. The diagram below shows the TCP ports and destination hosts used.

Note

Currently Versions 8.3.5 and newer of the tsh application does not support use of proxies (HTTP_PROXY , etc).  The developers are actively working on a fix for this which will be available in a forthcoming release.
Workaround options are to use a TCP proxy wrapper app, such as proxychains-ng, or to make use of the Web Shell facility.However, if the HTTPS_PROXY , etc, environment variable is set, tsh  will also attempt to make an ssh connection on port 22 using the proxy.  If your proxy does not support ssh connections to port 22 then set:

No Format
$ export no_proxy="jump.ecmwf.int:22"

  • The "tsh login" step uses ports 80 and 443 in order to log in to the service and obtain the client certificate. 
    • initially it contacts shell jump.ecmwf.int  on port 443 (the user is able to see these steps by using the "tsh login --debug switch"  option)
    • then it opens a local http client on a high port 64xxx, produces a URL link on the localhost for the user to follow (like such as:  http://127.0.0.1:64068/da92794b-9d41-4008-ae6f-83fb77f64486) and waits for a callback from shelljump.ecmwf.int.
    • that localhost url URL then redirects the user for OIDC authentication at https://accounts.ec,wfecmwf.int (on port 443) involving Keycloak linked to user accounts on ActiveDirectory and HID the TOTP security token
    • upon successful authentication, tsh receives a callback from shell jump.ecmwf.int  and receives the client certificate completing it's its login workflow
    • from this point on, with the client certificate which is valid for 24 hours, the user is authorised to access hosts behind the teleport proxy either via tsh ssh or OpenSSH workflows
  • Your ssh client uses the standard port 22 for server access.
  • The Teleport web shell service also uses port 443 on the same host.

Gliffy Diagram
nameGravitational Teleport ECMWF Implementation v1.0 Copy Copy
pagePin12