ssh config

SSH 構成

組織内にアクティブなメンテナがいないため、このプロジェクトは読み取り専用に設定されています。

SSH クライアント構成の自動維持を支援するツール。これは、リモート ホストへのログインのデータベースを維持するために使用できます。

SSH-Config には、DNS サービスを使用して (新しい) ホストを調査し、そのホストを SSH 構成に追加する機能があります。そこから SSH サーバーに接続し、どのサーバーに到達可能か、どのサーバーに到達できないかを調べることができます。

目的

SSH-Config の目的は、多数のホストを含​​む SSH クライアント構成のメンテナンスを簡素化することです。 SSH クライアント構成が適切に維持されている場合、入力中にホスト名を展開するのに役立つ Unix シェル補完メカニズムがあります。ここでツールが登場します。

使用法

コマンドラインで使用してください。複数のユースケースが実装されています。

• 検出 (-d): DNS ルックアップを使用して、コマンド ラインで指定された新しいホストを検出します。
• 更新 (-u): DNS を使用してデータベース内の既知のホストを更新し、ホストの到達可能性をテストします。
• エクスポート (-e):データベースをファイル / stdout にエクスポートします。ユーザーまたはグループ名によるフィルタリングをサポートします。
• インポート (-i):ファイル/標準入力からデータベースをインポートします。

完全なコマンドラインパラメータ:

 -database (-D) FILE : The database to use. (default: /home/$USER/.sshconfig.json
                       )
 -discover (-d)      : Discover hosts given in the command line using DNS.
                       (default: false)
 -export (-e)        : Export the database. Writes to stdout or file argument.
                       User and group parameters can be used for filtering.
                       (default: false)
 -group (-G) GROUP   : The group name to use for the entry for discovery or
                       export filtering.
 -help (-h)          : Show this command line help. (default: true)
 -import (-i)        : Import a database. Reads either from argument or stdin.
                       (default: false)
 -sshcfg (-s) FILE   : The ssh config to update. (default:
                       /home/$USER/.ssh/config)
 -update (-u)        : Update all database hosts IP addresses. (default: false)
 -user (-U) USER     : The user name to use for the entry for discovery or
                       export filtering.

使用例 1: $HOME/.ssh/configに新しいホストを追加する

新しいホストを SSH 構成に追加するには、通常、次のようなコマンドを発行します。

 $ ssh-config -d vm-alpha vm-beta vm-gamma
$

この後、データベース$HOME/.sshconfig.jsonにエントリが追加されます。

 ...
   {
      "name" : "vm-alpha",
      "createdAt" : 1504778353193,
      "enabled" : true,
      "fqdn" : "vm-alpha.foo.domain",
      "sshServerVersion" : "SSH-2.0-OpenSSH_6.7p1 Debian-5+deb8u3",
      "id" : "a7369847-e833-49bd-af95-e0d1292b3ed6",
      "updatedAt" : 1520958429041,
      "ips" : [
         "10.123.123.123"
      ]
   },
...

$HOME/.ssh/config では次のようになります。

 ...
# <<< BEGIN{a7369847-e833-49bd-af95-e0d1292b3ed6}
Host vm-alpha
	Hostname vm-alpha.foo.domain
	Hostname 10.123.123.123
# >>> END{a7369847-e833-49bd-af95-e0d1292b3ed6}
...

使用例 2: ホストを ~/.ssh/config に更新する

既存のホストを SSH 構成に更新するには、通常、次のようなコマンドを発行します。

 $ ssh-config -u
$

この後、データベース $HOME/.sshconfig.json 内のエントリが更新されます。

 ...
   {
      "name" : "vm-alpha",
      "createdAt" : 1504778353193,
      "enabled" : false,
      "fqdn" : "vm-alpha.foo.domain",
      "sshServerVersion" : "SSH-2.0-OpenSSH_6.7p1 Debian-5+deb8u3",
      "id" : "a7369847-e833-49bd-af95-e0d1292b3ed6",
      "updatedAt" : 1520959605730,
      "ips" : [
         "10.123.123.123"
      ]
   },
...

$HOME/.ssh/config に到達できなくなったため、ホストは削除されます。

ファイル

関連するファイルは次のとおりです。

• ~/.ssh/config : 読み書きされる SSH 構成。 SSH 構成固有の部分には特別なマジック マーカーが付けられているため、構成が完全に台無しになることはありません。
• ~/.sshconfig.json : すべてのホストのデータを保持する JSON ファイル。上記の SSH クライアント設定には到達可能なホストのみが取り込まれるため、どのホストが到達可能かどうかを追跡するために使用されます。

インストール

インストール用に Debian および CentOS パッケージが提供されています。 Github の「リリース」セクションを参照してください。どちらも/usr/bin/ssh-configにシェル ラッパーをインストールします。

建物

ビルドに必要なシステム要件は次のとおりです。

• オラクル JDK 8
• ビルド用の Apache Maven

ビルドはコマンドでトリガーできます

 mvn clean package

ライセンス

Copyright 2018 1&1 Internet SE Copyright 2019 1&1 Ionos SE

Apache License バージョン 2.0 (「ライセンス」) に基づいてライセンスされています。ライセンスに準拠する場合を除き、このファイルを使用することはできません。ライセンスのコピーは次の場所で入手できます。

http://www.apache.org/licenses/LICENSE-2.0

適用される法律で義務付けられている場合または書面による同意がない限り、ライセンスに基づいて配布されるソフトウェアは、明示または黙示を問わず、いかなる種類の保証や条件もなく、「現状のまま」で配布されます。ライセンスに基づく許可と制限を規定する特定の言語については、ライセンスを参照してください。