keybase / bot-sshca

A chat bot that can manage your team's SSH accounts
BSD 3-Clause "New" or "Revised" License
222 stars 30 forks source link

kssh install #72

Open fishcharlie opened 4 years ago

fishcharlie commented 4 years ago

The documentation for this project is very poor. Few specific examples.

On the Keybase SSH announcement blog post it says See the Getting Started directions on Github for information about setting up and deploying the Keybase SSH CA bot, with Getting Started linking to https://github.com/keybase/bot-sshca#getting-started, which is no longer a valid URL. It looks like that URL needs to be updated to https://keybase-ssh-ca-bot.readthedocs.io/en/latest/getting_started.html instead.

On that Getting Started page it says Now download the kssh binary and start SSHing! See https://github.com/keybase/bot-sshca/releases to download the most recent version of kssh for your platform. But when downloading the macOS version it downloads a .dms file. Which seems really weird, and a file format that I have never seen before, nor does Google seem to have much solid information on (one link I found on Google said the solution is to rename to .dmg, which I do not believe is accurate in this case, but if it is, that is something Keybase should correct on their end). So I tried to make this file executable, chmod +x kssh-mac.dms, then ran it ./kssh-mac.dms, but I got a dialog that says “kssh-mac.dms” cannot be opened because the developer cannot be verified.

What am I missing here?

RayOei commented 4 years ago

According to this reference: https://fileinfo.com/extension/dms the extension is a problem with Safari. Although

I assume something can be improved on the documentation as the download is easy to miss in the first place (it is not a link, although in the Github source it seems to be one?). And I assume there might be a way to convince Safari to download it without this renaming?