Hackage :: [Package]

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]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 0.0.1
Change log ChangeLog.md
Dependencies attoparsec (>=0.9 && <0.14), base (>=3 && <5), base64-bytestring (>=1.0 && <1.1), bytestring (>=0.10 && <0.11), cereal (>=0.5 && <0.6), crypto-pubkey-openssh (>=0.2 && <0.3), crypto-pubkey-types (>=0.4 && <0.5), directory (>=1 && <2), filepath (>=1 && <2), HsOpenSSL (>=0.11 && <0.12), network (>=2 && <3), openssh-protocol (>=0.0 && <0.1), optparse-applicative (>=0.11 && <0.15), smith-client (>=0.0 && <0.1), text (>=1 && <2), transformers (>=0.4 && <0.6), transformers-bifunctors (<1), 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 2019-02-08T22:16:32Z
Distributions
Executables smith
Downloads 562 total (3 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Last success reported on 2019-02-09 [all 2 reports]

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