SORACOM Napterをcliから使ってみる

SORACOM Napterとは

2019/7/2に発表されたSORACOMの新サービスで、SORACOM Air SIMの挿さっているデバイスに、簡単にリモートからセキュアなアクセスできるようになります。

WEBコンソールからsshする手順は公式ドキュメントにありますので、同じことをcliからやってみます。

cliのセットアップ

soracom cliのセットアップはここでは省略しますが、バージョン0.4.5以上にしてください。

%soracom version
SORACOM API client v0.4.5

jsonを準備

以下の内容をnapter.jsonに保存します。

{
    "destination": {
        "imsi": "アクセス先のIMSI",
        "port": 22
    },
    "duration": 1800,
    "tlsRequired": false
}

アクセス元を指定していない場合、cliを実行したマシンのグローバルIPアドレスが自動的に設定されます。
アクセス元を明記する場合はこんな感じで。

{
    "destination": {
        "imsi": "アクセス先のIMSI",
        "port": 22
    },
    "duration": 1800,
        "source": {
                "ipRanges":[
                       "x.x.x.x/x"
                ]
        },
    "tlsRequired": false
}

接続してみる

では、さっそくやってみましょう。

%soracom port-mappings create --body @napter.json
{
    "createdTime": **********,
    "destination": {
        "imsi": "**************",
        "port": 22
    },
    "duration": 1800,
    "endpoint": "**********:*****",
    "expired": false,
    "expiredTime": *******,
    "hostname": "******.napter.soracom.io",
    "imsi": "***************",
    "ipAddress": "*****",
    "operatorId": "*****",
    "port": ****,
    "source": {
        "ipRanges": [
            "******"
        ]
    },
    "tlsRequired": false
}

できました！
あとはこの情報に従って、

%ssh -p portの値 ユーザ名@ipAddressの値

でアクセスできます。

後片付け

終わったら削除しましょう。

%soracm port-mappings delete --port portの値 --ip-address ipAddressの値

で削除されます。

まとめ

Napterはお手軽かつセキュアにオンデマンドなリモートアクセスを提供してくれる素晴らしいサービスです。
cliで操作すると、シェルスクリプトなどにも組み込めて便利ですね。