nssh

package module
v0.4.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 10, 2023 License: MIT Imports: 15 Imported by: 0

README

nssh

SSH client for SORACOM Napter. You can easily open an SSH connection with your SIM's name.

How it works

Napter is an on-demand networking service for devices using Soracom Air for Cellular SIM cards, which enables you to quickly and securely access your devices remotely. Napter allows you to perform remote maintenance, troubleshooting, or other typical remote access tasks, without setting up any relay servers or installing agent software on the device.

Tested Platform

At this moment, the client is only tested on following platforms. It can be built for other Linux distributions and Windows but might not work due to x/crypto/ssh.readVersion hang, etc. PR's welcome.

  • Debian GNU/Linux 11 (bullseye) aarch64
  • macOS 13.4.1 (Ventura) arm64
  • Windows 11 with cmd.exe or PowerShell 7.3.6 amd64

Install

  1. Download the archive for your platform and architecture from Releases section.
  2. Unpack the archive.
  3. Move the executable to one of your PATH directories.

Or you can build executable from the source:

$ git clone https://github.com/0x6b/nssh
$ cd nssh
$ make # and you'll get `nssh` under the root directory

Usage

One-time Setup
  1. Create a SAM user with following permission (without comment including //): 
    {
  "statements": [
    {
      "api": [
        "Subscriber:listSubscribers",
        "PortMapping:listPortMappingsForSubscriber",
        "PortMapping:createPortMapping",
        "Query:subscribers" // for interactive mode
      ],
      "effect": "allow"
    }
  ]
}
  2. Generate authentication key for the user.
  3. Save the authentication information at $HOME/.soracom/nssh.json, or %HOMEPATH%\.soracom\nssh.json as below (without comment including //). 
    {
  "coverageType": "jp", // default coverage, specify "g" for global
  "authKeyId": "keyId-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "authKey": "secret-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
  4. Name your desired SIM at SORACOM User Console.
Connect
$ nssh connect pi@your-sim-name

You can specify coverage type, profile name, port number, connection duration, or identity file for SSH public key authentication. See nssh connect --help.

  • Override coverage type, jp or global: 
    $ nssh --coverage-type global connect pi@your-sim-name
  • Use another profile under $HOME/.soracom/ directory, without extension .json: 
    $ nssh --profile-name default connect pi@your-sim-name
  • Use public key authentication: 
    $ nssh connect pi@your-sim-name -i ~/.ssh/id_rsa
  • Specify another port number and connection duration: 
    $ nssh connect pi@your-sim-name --port 2222 --duration 120
  • Select online SIM to connect interactively: 
    $ nssh interactive -u pi -i ~/.ssh/id_rsa
    Online SIM list will be shown, then select one of them by navigating with arrow keys or filtering by typing /. Press enter to connect, or esc/Ctrl+c/q to quit.
Details

Global help:

$ nssh --help
nssh -- SSH client for SORACOM Napter

Usage:
  nssh [command]

Available Commands:
  connect     Connect to specified subscriber via SSH.
  help        Help about any command
  interactive List online subscribers and select one of them to connect, interactively.
  list        List port mappings for specified subscriber. If no subscriber name is specified, list all port mappings.
  version     Show version

Flags:
      --coverage-type string   Specify coverage type, "g" for Global, "jp" for Japan
  -h, --help                   help for nssh
      --profile-name string    Specify SORACOM CLI profile name (default "nssh")

Use "nssh [command] --help" for more information about a command.

Help for connect sub-command:

$ nssh connect --help
Create port mappings for specified subscriber and connect via SSH. If <user>@ is not specified, "pi" will be used as default. Quote with " if name contains spaces or special characters.

Usage:
  nssh connect [<user>@]<subscriber name> [flags]

Aliases:
  connect, c

Flags:
  -d, --duration int      Specify session duration in minutes (default 60)
  -h, --help              help for connect
  -i, --identity string   Specify a path to file from which the identity for public key authentication is read
  -p, --port int          Specify port number to connect (default 22)

Global Flags:
      --coverage-type string   Specify coverage type, "g" for Global, "jp" for Japan
      --profile-name string    Specify SORACOM CLI profile name (default "nssh")

Help for list sub-command:

$ nssh list --help
List port mappings for specified subscriber. If no subscriber name is specified, list all port mappings.

Usage:
  nssh list [subscriber name] [flags]

Aliases:
  list, l

Flags:
  -h, --help   help for list

Global Flags:
      --coverage-type string   Specify coverage type, "g" for Global, "jp" for Japan
      --profile-name string    Specify SORACOM CLI profile name (default "nssh")

Help for interactive sub-command:

List online subscribers and select one of them to connect, interactively.

Usage:
  nssh interactive [flags]

Aliases:
  interactive, i

Flags:
  -d, --duration int      Specify session duration in minutes (default 60)
  -h, --help              help for interactive
  -i, --identity string   Specify a path to file from which the identity for public key authentication is read
  -u, --login string      Specify login user name (default "pi")
  -p, --port int          Specify port number to connect (default 22)

Global Flags:
      --coverage-type string   Specify coverage type, "g" for Global, "jp" for Japan
      --profile-name string    Specify SORACOM CLI profile name (default "nssh")

References

License

MIT. See LICENSE for details.

Privacy

This program will send requests to following services:

Other than that, the program does not send user action/data to any server. Please consult each provider's privacy notices.

Enjoy remote connection with SORACOM Napter!

Documentation

Index

Constants

View Source 
const SIGWINCH = syscall.SIGWINCH

Variables

This section is empty.

Functions

func GetIP 

func GetIP() (net.IP, error)

GetIP gets current global IP address using https://checkip.amazonaws.com/

Types

type SoracomClient 

type SoracomClient struct {
	APIKey   string // API key
	Token    string // API token
	Client   *http.Client
	Endpoint string
}

A SoracomClient represents an API client for SORACOM API. See https://developers.soracom.io/en/docs/tools/api-reference/ or https://dev.soracom.io/jp/docs/api_guide/

func NewSoracomClient 

func NewSoracomClient(coverageType, profileName string) (*SoracomClient, error)

NewSoracomClient returns new SoracomClient for caller

func (*SoracomClient) Connect 

func (c *SoracomClient) Connect(login, identity string, portMapping *models.PortMapping) error

Connect connects to specified port mapping with login name and identity. If identity is specified, use it for public key authentication. If not, use password authentication instead.

func (*SoracomClient) CreatePortMappingForSIM added in v0.4.0 

func (c *SoracomClient) CreatePortMappingForSIM(sim models.SIM, port, duration int) (*models.PortMapping, error)

CreatePortMappingForSIM creates port mappings for specified subscriber, port, and duration

func (*SoracomClient) FindAvailablePortMappingsForSIM added in v0.4.0 

func (c *SoracomClient) FindAvailablePortMappingsForSIM(sim models.SIM, port int) ([]models.PortMapping, error)

FindAvailablePortMappingsForSIM finds available port mappings for specified SIM and port

func (*SoracomClient) FindOnlineSIMs added in v0.4.0 

func (c *SoracomClient) FindOnlineSIMs() ([]models.SIM, error)

FindOnlineSIMs finds online subscribers

func (*SoracomClient) FindOnlineSIMsByName added in v0.4.0 

func (c *SoracomClient) FindOnlineSIMsByName(name string) ([]models.SIM, error)

FindOnlineSIMsByName finds online SIMs which has the specified name

func (*SoracomClient) FindPortMappingsForSIM added in v0.4.0 

func (c *SoracomClient) FindPortMappingsForSIM(sim models.SIM) ([]models.PortMapping, error)

FindPortMappingsForSIM finds port mappings for specified SIM

func (*SoracomClient) FindSIMsByName added in v0.4.0 

func (c *SoracomClient) FindSIMsByName(name string) ([]models.SIM, error)

FindSIMsByName finds SIMs which has the specified name

func (*SoracomClient) GetSIM added in v0.4.0 

func (c *SoracomClient) GetSIM(simID string) (*models.SIM, error)

GetSIM gets SIM information for specified SIM ID

func (*SoracomClient) ListPortMappings added in v0.4.0 

func (c *SoracomClient) ListPortMappings() ([]models.PortMapping, error)

ListPortMappings finds all port mappings

Source Files

View all Source files

Directories

Path Synopsis
cmd
nssh

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.