smith-cli: Command line tool for <https://smith.st/ Smith>.

[ bsd3, program, security ] [ Propose Tags ]

This is a command line tool for interacting with Smith.


[Skip to Readme]
Versions [faq] 0.0.1
Change log ChangeLog.md
Dependencies attoparsec (>=0.9 && <0.14), base (>=3 && <5), base64-bytestring (==1.0.*), bytestring (==0.10.*), cereal (==0.5.*), crypto-pubkey-openssh (==0.2.*), crypto-pubkey-types (==0.4.*), directory (==1.*), filepath (==1.*), HsOpenSSL (==0.11.*), network (==2.*), openssh-protocol (==0.0.*), optparse-applicative (>=0.11 && <0.15), smith-client (==0.0.*), text (==1.*), transformers (>=0.4 && <0.6), transformers-bifunctors (==0.*), unix [details]
License BSD-3-Clause
Copyright (c) 2019, HotelKilo
Author Mark Hibberd
Maintainer mth@smith.st
Category Security
Home page https://github.com/smith-security/smith-cli
Bug tracker https://github.com/smith-security/smith-cli/issues
Source repo head: git clone git@github.com:smith-security/smith-cli.git
Uploaded by MarkHibberd at Fri Feb 8 22:16:32 UTC 2019
Distributions NixOS:0.0.1
Executables smith
Downloads 82 total (10 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs not available [build log]
Last success reported on 2019-02-09 [all 2 reports]

Downloads

Maintainer's Corner

For package maintainers and hackage trustees


Readme for smith-cli-0.0.1

[back to package description]

smith-cli

This is a command line interface for the Smith.

The goal is to provide a convenient interface for working with smith.

Configuration

The smith cli will source credentials configuration as follows:

  • It will check for an environment provided API key in '$SMITH_JWK'.
  • It will fall-back to looking for '$SMITH_HOME/credentials.json' if '$SMITH_HOME' is set.
  • It will fall-back to looking for '$HOME/.smith/credentials.json'.

The smith cli will source endpoint configuration as follows:

  • It will check for an environment provided endpoint in '$SMITH_ENDPOINT'.
  • It will fall-back to the public production endpoint 'https://api.smith.st'.

Stability

This cli is new, and should have the disclaimers that normally comes with that. However, the command line aims to maintain compatibility unless there is a non-small issue that breaking compatibility will really address. Stable versions will always be available for downoad/install if you really need to lock things down.

Example

Using your ssh-agent.

# using ssh agent
eval $(ssh-agent)

# issue a certificate for the muppets environment
smith --environment muppets
smith -e muppets

Using smith to start ssh-agent.

# start ssh-agent issue a certificate for the muppets environment
eval $(smith --environment muppets)

Running a command with access to an agent configured with your certificate.

# start ssh-agent issue a certificate for the muppets environment
smith --environment muppets -- ssh user@kermit
smith --environment muppets -- rsync -aH www www@gonzo:/var/www