docs: add TCP guide (#1714)

This commit is contained in:
Travis Groth 2020-12-23 16:24:49 -05:00 committed by GitHub
parent 661005c497
commit 74db362634
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
10 changed files with 383 additions and 0 deletions

29
examples/tcp/README.md Normal file
View file

@ -0,0 +1,29 @@
# 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](https://www.pomerium.com/docs/installation.html#pomerium-cli) `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