github-auth
A command-line tool for managing SSH keys from GitHub users to enable secure pair programming sessions.
What is github-auth?
github-auth is a command-line tool that automates SSH key management for GitHub users, allowing developers to easily add or remove public SSH keys from their `authorized_keys` file. It solves the problem of securely granting temporary SSH access for pair programming sessions without manual key handling.
Developers who frequently engage in remote pair programming and need a secure, efficient way to manage SSH access for collaborators with GitHub accounts.
It eliminates the friction of manually exchanging SSH keys, reduces security risks by avoiding password sharing, and integrates seamlessly with GitHub's public key infrastructure.
Overview
SSH key management for GitHub users
Use Cases
Best For
- Setting up secure SSH access for remote pair programming sessions
- Quickly onboarding GitHub collaborators to a shared development environment
- Managing temporary SSH access for workshops or coding interviews
- Automating SSH key rotation for team-based development machines
- Integrating SSH key management into Ruby-based DevOps scripts
- Facilitating ad-hoc coding collaborations without complex infrastructure
Not Ideal For
- Teams where collaborators lack GitHub accounts or use other version control systems
- Environments requiring granular SSH key control (e.g., managing specific keys per device)
- Projects with existing automated SSH key management via tools like Ansible or Puppet
- Non-Ruby setups where installing a gem adds unnecessary dependency overhead
Pros & Cons
Pros
Fetches public SSH keys directly from GitHub, eliminating manual copying and pasting, as shown in the command examples for adding users.
Uses public key authentication instead of password sharing, reducing security risks for remote collaborations, per the project's philosophy.
Allows specifying SSH commands like 'tmux attach' for automatic session joining, streamlining the pairing workflow as demonstrated in the README.
Supports adding or removing multiple users at once and listing all authorized users, saving time for group operations.
Cons
Relies entirely on GitHub for key storage; it cannot manage keys from other sources, limiting flexibility for teams using Bitbucket or GitLab.
Does not automate network setup like port forwarding, requiring manual configuration as admitted in the troubleshooting section.
Adds all public keys from a GitHub user, which may include inactive or unintended keys, potentially cluttering the authorized_keys file.
Frequently Asked Questions
Related Projects
krDEPRECATED A dev tool for SSH auth + Git commit/tag signing using a key stored in Krypton.
totp-ssh-fluxerTake security by obscurity to the next level (this is a bad idea, don't really use this please)
authy-sshEasy two-factor authentication for ssh servers
HIBAHIBA is a system built on top of regular OpenSSH certificate-based authentication that allows to manage flexible authorization of principals on pools of target hosts without the need to push customized authorized_users files periodically.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.