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

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

Warnings:

'ghc-options: -O2' is rarely needed. Check that it is giving a real benefit and not just imposing longer compile times on your users.

This is a command line tool for interacting with Smith.

[Skip to Readme]

Properties

Versions	0.0.1, 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:15:42Z

Downloads

smith-cli-0.0.1.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

MarkHibberd

For package maintainers and hackage trustees

edit package information

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