#api-bindings

bin+lib smith-ssh

Smith client. Command line tools for interacting with https://smith.st services.

3 releases

0.1.2 Aug 31, 2019
0.1.1 Aug 31, 2019
0.1.0 Aug 31, 2019

#850 in Authentication

BSD-3-Clause

44KB
995 lines

smith.rs

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

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

Dependencies

~30MB
~715K SLoC