README
¶
An SSH Server that Launches Containers in Kubernetes and Docker
ContainerSSH in One Minute
In a hurry? This one-minute video explains everything you need to know about ContainerSSH.
Need help?
Join the #containerssh Slack channel on the CNCF Slack »
Use cases
Build a lab
Building a lab environment can be time-consuming. ContainerSSH solves this by providing dynamic SSH access with APIs, automatic cleanup on logout using ephemeral containers, and persistent volumes for storing data. Perfect for vendor and student labs.
Debug a production system
Provide production access to your developers, give them their usual tools while logging all changes. Authorize their access and create short-lived credentials for the database using simple webhooks. Clean up the environment on disconnect.
Run a honeypot
Study SSH attack patterns up close. Drop attackers safely into network-isolated containers or even virtual machines, and capture their every move using the audit logging ContainerSSH provides. The built-in S3 upload ensures you don't lose your data.
How does it work?
- The user opens an SSH connection to ContainerSSH.
- ContainerSSH calls the authentication server with the users username and password/pubkey to check if its valid.
- ContainerSSH calls the config server to obtain backend location and configuration (if configured)
- ContainerSSH calls the container backend to launch the container with the specified configuration. All input from the user is sent directly to the backend, output from the container is sent to the user.
▶️ Watch as video » | 🚀 Get started »
Demo
Contributing
If you would like to contribute, please check out our Code of Conduct as well as our contribution documentation.
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
containerssh-testauthconfigserver
ContainerSSH Authentication and Configuration Server
|
ContainerSSH Authentication and Configuration Server |