pomerium/examples/tcp
Alex Fornuto b2b8c481d5
Refresh and Update TCP documentation (#2627)
* init client app doc

* init TCP section

* add redirect for TCP client doc

* Redis and Mysql

* finish TCP exampels

* init Draft template

* cleanup whitespace

* escape markdown image in template

* add redirect and update links

* copy edit

* Update readme.md

* fmt

Signed-off-by: Bobby DeSimone <bobbydesimone@gmail.com>

* optimize png

Signed-off-by: Bobby DeSimone <bobbydesimone@gmail.com>

* header cleanup and child listing

* Update docs/docs/tcp/ssh.md

Co-authored-by: bobby <1544881+desimone@users.noreply.github.com>

Co-authored-by: cmo-pomerium <91488121+cmo-pomerium@users.noreply.github.com>
Co-authored-by: Bobby DeSimone <bobbydesimone@gmail.com>
Co-authored-by: bobby <1544881+desimone@users.noreply.github.com>
2021-10-14 09:35:31 -05:00
..
_wildcard.localhost.pomerium.io-key.pem docs: add TCP guide (#1714) 2020-12-23 16:24:49 -05:00
_wildcard.localhost.pomerium.io.pem docs: add TCP guide (#1714) 2020-12-23 16:24:49 -05:00
config.yaml docs: add TCP guide (#1714) 2020-12-23 16:24:49 -05:00
docker-compose.yaml docs: add TCP guide (#1714) 2020-12-23 16:24:49 -05:00
pomerium-tunnel.sh Refresh and Update TCP documentation (#2627) 2021-10-14 09:35:31 -05:00
README.md docs: add TCP guide (#1714) 2020-12-23 16:24:49 -05:00
rootCA-key.pem docs: add TCP guide (#1714) 2020-12-23 16:24:49 -05:00
rootCA.pem docs: add TCP guide (#1714) 2020-12-23 16:24:49 -05:00
ssh_config docs: add TCP guide (#1714) 2020-12-23 16:24:49 -05:00

Pomerium as a TCP proxy for SSH and Redis

Run this demo locally on your docker-compose capable workstation, or replace localhost.pomerium.io with your own domain if running on a server.

Includes

  • TCP connection authentication and authorization managed by pomerium
  • SSH client configuration and demo server
  • Redis demo server
  • Postgres demo server

How

  • Install pomerium-cli in your $PATH
  • Update config.yaml for your e-mail address, if not using gmail/google
  • Replace secrets in config.yaml
  • Run docker-compose up from this directory
  • SSH:
    • Run ssh -F ssh_config myuser@ssh.localhost.pomerium.io
    • Log in with password supersecret
  • Redis:
    • Run pomerium-cli tcp redis.localhost.pomerium.io:6379 --listen localhost:6379 &
    • Run redis-cli
  • Postgres:
    • Run pomerium-cli tcp pgsql.localhost.pomerium.io:5432 --listen localhost:5432 &
    • Run psql -h localhost -W -U postgres
    • Log in with password supersecret
  • ???
  • Profit