5 ms·
Show HN: Keypub.sh – OAuth for the terminal using SSH keys
Hi HN! I built KeyPub.sh to solve the problem of user verification for CLI applications. It's essentially OAuth for the terminal, but using SSH keys that developers and users already have.
- No installation needed - works with existing SSH setup
- Privacy-focused: users control what email info is shared
- Simple email verification process
- Free public service
- Perfect for CLI app developers who don't want to build user verification
Try it with:
`$ ssh keypub.sh about`
Source code: https://github.com/skariel/keypub https://github.com/skariel/keypub
- hirsin 2y agoOauth usually implies some variability of access - ie selective permissions. Is this more a pure authn layer as opposed to authz? You have a repo on GitHub... Have you looked at using account public keys for anything? Ie https://github.com/hpsin.keys https://github.com/hpsin.keys I hear a lot about how those keys should get used to bootstrap pki systems but I've not seen it happen yet.
- Cyphus 2y agoUbuntu's installer supports bootstrapping ssh access with this method. Put in your GitHub username and it takes care of the rest. Works for interactive and headless installs.
- eichin 2y agoThe `ssh-import-id` package is the basic mechanism for this.
- messh 2y agoit does have authorization with the `allow` and `deny` commands for granular control of who can can see what. Currently very simple, only for email but maybe other fields in the future
- lufte 2y ago"about" didn't work for me but "help" did.
- aftbit 2y ago"why" doesn't work either.
- johntdyer 2y agoLooks interesting but your tls cert isn’t valid on your site
- jwilk 2y agoWhat do you mean? https://www.ssllabs.com/ssltest/analyze.html?d=keypub.sh https://www.ssllabs.com/ssltest/analyze.html?d=keypub.sh says the cert is OK.
- gwynforthewyn 2y agoSounds like a similar family of problems to [Wish](https://github.com/charmbracelet/wish https://github.com/charmbracelet/wish) by charm.sh. They've been pushing this curious paradigm of "ssh apps", where ssh keys are used to automatically create identities for small self-hosted CLI/TUI apps. As a useful comment for messh, it looks like you've committed the ssh_server binary file to git; you may want to add that to gitignore, as binary file handling isn't a traditional git strength. I _think_ it's better than it was a decade ago when I last investigated this, but I can see that Pro Git still recommends explicitly setting gitattributes to mark a file as binary https://git-scm.com/book/en/v2/Customizing-Git-Git-Attributes#Binary-Files https://git-scm.com/book/en/v2/Customizing-Git-Git-Attribute...
- akshayKMR 2y agoRegarding ssh-apps, this seems super duper niche to me even for developers. Like, I get that many devs are terminal savvy, and it's cool that it's possible to serve apps like this but is it practical (to pick for your new product /internal app)?
- qudat 2y agoWe are pretty successful over at https://pico.sh https://pico.sh using the same techniques — and using wish
- latchkey 2y agoAs a bare metal cloud service provider, we built a little TUI app over ssh so that people could upload their public keys to us without having to use a web interface. It has worked out really well because it makes it possible to "upload" the public key without having to do anything but login. We automatically configure ssh on the servers to auth against our own internal api for serving up the keys. This way, customers can add to authorized_keys and also use our TUI for management as well.
- hamandcheese 2y agoAs a developer, I agree. Give me a great CLI, please, not a server rendered TUI. This gives me another thought though, a "server-rendered" CLI. A tiny shim binary that just sends argv to the server, and the server sends back stdout/stderr. Haven't seen anyone try that.
- aftbit 2y agoWhen you say "OAuth", what exactly do you mean? It looks like this is really just a tool for associating email addresses with SSH keys. This is an interesting concept, but it smells a bit like a solution in search of a problem. Perhaps it will feel more useful to me once there are two or three SSH apps that I want to access. Even then, I would suggest that prospective SSH app developers just lean on github's public SSH keys instead, as basically all developers will have a github account and this reduces your (already high, relative to webapp) startup friction.
- messh 2y agogithub public ssh keys are not connected to mails. and using the api from the terminal requires installing some tool. I hope there will be lots of apps for the the terminal, for e.g. cde (cloud dev env) managing, task management, project management, compute as a service, etc.
- hnlmorg 2y ago> using the api from the terminal requires installing some tool. It really doesn’t. It’s just a HTTP API. So basically anything that can form a TLS connection will work. But the bigger problem here is that email addresses can be private in GitHub. Also you never know when GitHub might change their API.
- sneak 2y agoOAuth means a specific technical thing, and this is not that thing.
- rzzzt 2y ago"X for Y" should make you draw a metaphorical, not literal comparison to X - it is something like X, applied in the context/audience/etc. of Y. "Tinder for boats"¹ is not Tinder. ¹https://www.buzzfeed.com/michellerial/is-your-startup-idea-already-taken https://www.buzzfeed.com/michellerial/is-your-startup-idea-a...
- orblivion 2y agoBased on current downvotes it seems that people object to this. And I did take this literally myself before going to the comments. Still, I think the metaphorical thing has value as a succinct explainer. Maybe a small change in wording or some quotation marks is the way to go?
- eichin 2y agoPart of the issue is that "bootstrapping real oauth with ssh" is something people actually want, so there's some (unearned) disappointment in finding out that this isn't it.
- rzzzt 2y agoI have no horse in this race, was just commenting from a generic point of view. The project's README.md says "Lightweight alternative to OAuth for CLI applications" in section "Use Cases", and there is no further mention of OAuth in it, maybe that's more acceptable.
- benatkin 2y agoIndeed. It also doesn't have anything like PKCE.
- qudat 2y agoNice job! Have you thought about implementing 2fa? I know platform.sh supports 2fa via ssh.
- wutwutwat 2y ago``` ).WHERE( AND( table.SSHKeys.Email.EQ(String(to_email)), table.SSHKeys.Fingerprint.EQ(String(fingerprint)), ), ) ``` If not using a `citext` column then you're going to want to normalize (ie downcase/tolower) everywhere you're doing arbitrary string comparisons, or you're going to get incorrect counts. Also I don't see any null or "" checking taking place before querying... I'm not going to trust that your service can give me any reasonable confidence about the identity of the ssh key or the email it's attached to. That aside, I'm not understanding what the goal here is. I've never once needed my ssh key tied to my email address, but if I did, it's included in the public key already...
- messh 2y agothere is email validation, and the public key is handled between the ssh client and server. If there is no valid public key this code would not even run. The fingerprint is prepared from this valid public key. Regarding having the email in the ssh pub key: maybe it is there, but it is no validated. Anyone could write anything there
- h43z 2y agoJust a reminder for everyone that by default SSH leaks all of the below public keys (if they exist) + all public keys in your ssh-agent to every server you connect to. ~/.ssh/id_ecdsa.pub ~/.ssh/id_ecdsa_sk.pub ~/.ssh/id_ed25519.pub ~/.ssh/id_ed25519_sk.pub ~/.ssh/id_xmss.pub ~/.ssh/id_dsa.pub Your "leaked" public keys can be used to check if a certain server recognizes that key.
- chasil 2y agoLoading an alternate client, like Dropbear or PuTTY for Linux is one way to avoid this.
- logicziller 2y agoOr just set `IdentityFile` with the path to the key and set `IdentitiesOnly` to yes for the specific host you connect to, and disable public key authentication by default for everything else.
- jclulow 2y agoCare should always be taken when using an SSH client to connect to untrusted hosts. Make sure you’re not actually forwarding your SSH agent to the remote host, or they’ll be able to hijack your keys. Consider also that any output is processed by your terminal, and there have been a number of serious security bugs in terminal escape sequence handling in a variety of terminal emulators in the past.
- bityard 2y ago"Hijack your keys" is somewhat overstating it, all they can do with it is log into other hosts that you can log into, assuming key auth is the only factor. And only while you are connected to the original host. Terminal security bugs are not more or less serious than your average Chrome 0day.
- wkat4242 2y agoMy yubikey always requires a physical touch so even if the agent is forwarded my keys can't be used. And I'll notice when it tries because I see it flashing.
- rfdonnelly 2y agoBest to use an agent that prompts you for signing. 1Password and Yubikey do this. Are there others?
- xyst 2y agoI agree with other commenters that the “oauth” keyword in title is misleading. I assumed this was compliant with oauth spec. It’s an interesting service, but I doubt I would use this for anything serious beyond toy apps. There was an article in October mentioning CF acquiring a company that dabbled in this space though. [1] It’s more for managing authN/Z for internal infra (k8s, servers,) but via existing IdP (with MFA). Underlying tech is “openpubkey”. [2]. I can see this adapted towards authN for CLI apps. Wanted to test this on my homelab infra but life has gotten in the way. [1] https://news.ycombinator.com/item?id=41923429 https://news.ycombinator.com/item?id=41923429 [2] https://github.com/openpubkey/openpubkey https://github.com/openpubkey/openpubkey
- tonymet 2y ago> Lightweight alternative to OAuth for CLI applications - just use SSH keys that users already have I'd love to see more support for this application. I've contributed a number of oauth-based CLI apps and the user onboarding step (3-legged init) is atrocious.
- tonymet 2y agoI love that you are approaching this space. SSH keys are an under-valued identity credential. Most big companies i've worked at have a clumsy sync & storage system that I think you could sell to. I'd encourage the next version using a more distributed approach (instead of a centralized credential DB & email token). A gpg signature or CA (using openssl) are alternative trust models that would provide trust without the DB
- bramhaag 2y agoPGP keys are associated with emails and there are various fully decentralized options to discover these keys (keyservers, WKD, ...). (How) does Keypub improve on this?
- messh 2y agoBest practice: Use SSH keys for SSH connections and authentication Use PGP keys for email encryption and file signing Keep these systems separate as they're designed for different purposes
- nine_k 2y agoPGP is hairy and many developers don't have it installed and configured. It's full of non-obvious options and capabilities. SSH is a common tool which most developers have installed, keep in a working order, use often, and reasonably understand. Guess which tool is easier to piggyback on and achieve easier and faster adoption.
- wkat4242 2y agoI like PGP keys for ssh auth because they can be hardware backed through openPGP. That makes it a great option (and also the actual crypto is then executed on the key itself, not by the gpg software)
- dcow 2y agoYou can do this with ssh keys too. And ssh keys can sign git commits. There’s no reason these days to even install a pgp suite. Stop using it.
- raggi 2y agoNo SSHFP record, TOFU clients. This is not secure. I wish people would stop trying to use SSH for things like this. PKI has features that are missing here and those features matter. This is unsafe. "but raggi, mitm before tofu is a really unrealistic scenario" ok, well, consider that some large percentage of gas stations in the US have hardware installed to skim your credit cards. those same folks are perfectly well motivated to drop a wifi dns mitm in conference buildings (trivial). new tech conference, handful of credit cards as people gossip about exactly these kinds of things in the hallway track. the roi on these installs would be pretty high, because tech folks tend to have a high credit balance. so yeah, "totally unrealistic" (this is more about terminal.shop, but same principle here as soon as someone uses it for actual value).
- dcow 2y agoAre you serious? A MITM here cannot sign things with your private key. People who care can add the keypub’s fingerprint before connecting. Adding an sshfp record is completely trivial too. There is no more tofu here than any other ssh connection and the solution is the same. And the added advantage of a PKI means, in a properly designed system, a threat actor can’t do anything useful sitting on the wire. I’m not saying ssh apps are going to take off, just that your reaction is quite hyperbolic.
- raggi 2y agoThere’s no separate signing in use here except for the ssh connection, which can be trivially mitm’d in common targeted scenarios because of the lack of webpki and the lack of other preparations. SSHFP would help, but only if configured both in dns, and if the client is both configured to look for it, using secure dns, and the user understands the failure UX and doesn’t just bypass it. On DNS: DoH would help but it is only in widespread use in browsers. DoT would help but it is only in widespread use on android. In addition to this a further scan of the code reveals it’s also using a btree index lookup for code comparison and no limitation on attempts, so it is likely that this is relatively trivial to attack with timing as well. Trivialize mitm all you want, you say concerns of mitm are hyperbolic, I gave a practical example of a target rich environment and there are plenty more folks could come up with. SSH may have long been skirting the lack of a better host key distribution system, but this is largely a matter of luck, access and bespoke usage. These new deployments demonstrate a change on two of these factors, increasing risk substantially if this grows.
- wkat4242 2y agoI really wish I could have the opposite. To authenticate with my SSH key (openpgp on yubikey) on the web. I'm not really happy with the Fido options.
- pisipisipisi 2y agoWhy? What is wrong with fido?
- wkat4242 2y agoSeveral things. I can't use it for file encryption as well, and it's not possible to make a software key as backup (as far as I know) in case I lose both my yubikeys. With pgp I have a break glass key on an encrypted pen drive. Also, with SSH it requires a recent version which is not on all the boxes I need access to. It requires pin code entry for every authentication unlike openpgp where I enter the pin once and then I just touch it for every subsequent authentication. I like that because I use it not only for login but also for other stuff like root elevation. And I think agent forwarding doesn't work with it. It's not really something I've looked into though as it's just not something I can use yet for the other reasons. For now pgp is just much better for me, though I wish I could use it on the web as well.
- deleted 2y ago[deleted]
- SoftTalker 2y agoI'm not sure I understand what this is useful for. I have dozens of ssh keys I use for various services. Do I register all of them?
- lormayna 2y agoFew years ago, I have worked to integrate SSH trough a major IDP via PAM modules. It was a bit tricky (especially for a bug in PAM in CentOS) but in the long run it worked fine.
- mooreds 2y agoWhy not use the device grant? It's designed for this use case (among others), is standards compliant, and leverages the OAuth ecosystem. RFC: https://datatracker.ietf.org/doc/html/rfc8628 https://datatracker.ietf.org/doc/html/rfc8628 An example golang CLI tool that uses it: https://fusionauth.io/blog/building-cli-app-with-device-grant-and-golang https://fusionauth.io/blog/building-cli-app-with-device-gran...