SCP

$Date: 2023/07/06 20:30:27 $

• 概要
• 注意事項
• 対応機種とファームウェアリビジョン
• 詳細
• コマンド
• SYSLOGメッセージ
• 関連文書

概要

SCP (Secure CoPy) は、SSHによってリモートホストとの間に張られたセッションを通して安全にファイルの転送を行うプログラムです。 SCPを使用して、ルーターへファイルの書き込みやルーターからファイルを読み出すことができます。

SFTPサーバ機能がSSHサーバ機能を利用してSFTPクライアントとの間でファイル転送を行うのに対して、SCPではSSHクライアントを利用してSSHサーバへ接続し、ファイルの転送を行います。

本機能の主な仕様および制限は次の通りです。

• SSHプロトコルバージョン2 に対応します。
• SSHの認証方式として、パスワード認証およびチャレンジ・レスポンス認証に対応しています。
• ルーター上のファイルとリモートホストのファイルの間で送受信が可能です。
• ルーター間でのファイル転送は行えません。
• リモートホスト間のファイル転送を中継することはできません。
• 送信先に複数のファイルを指定することはできません。
• ディレクトリの転送は行えません。
• 転送可能ファイルサイズは2GBまでです。

注意事項

• ルーター内蔵のフラッシュROM ( RTFS ) は、Luaスクリプト機能のスクリプトファイルやカスタムGUIのHTMLファイルなど、読み出し専用データを保存する用途として使用してください。RTFS領域や外部メモリへの頻繁な書き込みはデバイスの消耗を早めます。頻繁に書き込みを行ったことが原因でフラッシュROMの故障に至った場合は、保証期間内であっても無償修理の保証対象外になります。
• メモリ使用率が高い状態でサイズの大きいファイルの読み出しや書き込みを行う場合は、メモリ不足によって転送に失敗することがあります。
• メモリ使用率が高い状態でRTFS領域にアクセスすると、メモリ不足により処理を完了できずファイルシステムに不整合が生じる可能性があるのでRTFS領域のファイルの書き込みや読み出しはできるだけメモリ使用率が低い状態で行ってください。
• RTFS領域へのアクセス中に電源を落としたり再起動したりすると、ファイルシステムが壊れてデータを読み出せなくなる恐れがあるので絶対に行わないでください。
• フラッシュROMは頻繁に読み書きすることを想定したデバイスではないので、アクセス速度はあまり速くありません。ファイルシステムの状態によってはアクセスを開始してから処理が完了するまで十数秒程度かかる場合もあります。

対応機種とファームウェアリビジョン

ヤマハルーターでは以下の機種およびファームウェアで、SCP機能をサポートしています。

詳細

SCPを実行する

ルーターのコンソールから scp コマンドを実行し、SCPによるファイル転送を行います。

scp ＜送信元ファイル＞ ＜送信先ファイル＞ ＜リモートホストのポート番号＞

リモートホストのファイルを指定する場合、ファイル名の前に、「＜ユーザ名＞@＜ホスト名＞:」を付加します。
ルーター上のファイルとリモートホストのファイルとの転送のみをサポートしていますので、どちらか片方のファイルは、ルーター上のファイルを絶対パスで指定し、もう片方のファイルにはリモートホストのファイルを指定します。
＜リモートホストのポート番号＞のデフォルト値は 22です。22番ポート以外を使用している場合には、接続するリモートホストのポート番号に合わせて適宜指定してください。
22番ポートに接続する場合には＜リモートホストのポート番号＞を省略することができます。

ファイルを送信する

scpコマンド

scp ＜送信元ファイル＞ ＜ユーザ名＞@＜ホスト名＞:＜送信先ファイル＞ ＜リモートホストのポート番号＞

ルーター上にある次のファイルを送信することができます。

ファイルを受信する

scpコマンド

scp ＜ユーザ名＞@＜ホスト名＞:＜送信元ファイル＞ ＜送信先ファイル＞ ＜リモートホストのポート番号＞

ルーター上にある次のファイルへ書き込むことができます。

ファイル転送を中止する

ファイルの送信、または受信を中止したい場合、コンソールから Ctrl+C を入力(Ctrlキーと'C'キーを同時に入力) します。
RTFSおよび外部メモリのファイルに書き込んでいる最中にファイル転送を中止した場合、それまでに受信したデータがファイルに保存されます。

ただし、受信したファームウェアや設定ファイルをFLROMに書き込んでいる最中や、ユーザ認証および公開鍵の確認など入力を求められているときには、Ctrl+Cを入力して転送を中止することはできません。

known_hostsファイルを利用したサーバ公開鍵の確認

SCPが接続に利用する SSH では、サーバの公開鍵情報をknown_hostsと呼ばれるファイルに保存し、接続する毎にサーバから受信した公開鍵とknown_hostsに記録されている公開鍵を照合し、信頼するサーバか否かを確認しています。
known_hostsに記録されていないサーバに初めて接続する場合、コンソールにサーバの公開鍵情報を出力し、サーバへの接続処理を継続するか否かを問うメッセージが出力されます。

# scp /sample.txt test@192.168.0.1:sample.txt
The authenticity of host '192.168.0.1 (192.168.0.1)' can't be established.
RSA key fingerprint is aa:bb:cc:dd:ee:ff:gg:hh:ii:jj:kk:ll:mm:nn:oo:pp.
Are you sure you want to continue connecting (yes/no)?

'yes' を入力すると公開鍵をknown_hostsに登録し、サーバへの接続を行います。 'no' を入力すると、サーバとの接続を終了します。

2回目以降の接続でサーバの公開鍵が確認できた場合には、上記メッセージは出力されず、クライアントのユーザ認証が開始されます。
もし、初めてサーバに接続する場合と同様のメッセージが表示された場合には、known_hostsに登録されていないことになります。この場合には、次の理由が考えられます。

• known_hosts の保存先ファイルが変更された
• known_hosts に指定したファイルが削除された
• 外部メモリ上に保存先を指定しているが、外部メモリが接続されていない

また、次のような場合においても公開鍵の確認を求めるメッセージが出力されます。

• サーバから受信した公開鍵暗号方式と、known_hostsに保存されている公開鍵暗号方式が異なる場合、接続するか否かを問います。
  初めてサーバに接続する場合と同様、'yes'を入力すると公開鍵を登録し、サーバとのSSHセッションを継続します。

  # scp /sample.txt test@192.168.0.1:sample.txt
  WARNING: DSA key found for host 192.168.0.1
  in /ssh/known_hosts:1
  DSA key fingerprint aa:bb:cc:dd:ee:ff:gg:hh:ii:jj:kk:ll:mm:nn:oo:pp.
  The authenticity of host '192.168.0.1 (192.168.0.1)' can't be established
  but keys of different type are already known for this host.
  RSA key fingerprint is 00:11:22:33:44:55:66:77:88:99:aa:bb:cc:dd:ee:ff.
  Are you sure you want to continue connecting (yes/no)?
  

• サーバから受信した公開鍵と、known_hostsに保存されている公開鍵が異なる場合、次のメッセージを出力しセッションを終了します。サーバ管理者に連絡を取るなどして、公開鍵が変更されたかどうかを確認してください。

  # scp /sample.txt test@aaa.example.com:sample.txt
  @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
  @    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
  @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
  IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
  Someone could be eavesdropping on you right now (man-in-the-middle attack)!
  It is also possible that the DSA host key has just been changed.
  The fingerprint for the DSA key sent by the remote host is
  aa:bb:cc:dd:ee:ff:gg:hh:ii:jj:kk:ll:mm:nn:oo:pp.
  Please contact your system administrator.
  

コマンド

• SCPの実行

  [書式]

  scp [[USER@]HOST:]FILE1 [[USER@]HOST:]FILE2 [PORT]

  [設定値及び初期値]

  • USER
    • [設定値]: リモートホストにログインする際に使用するユーザ名
  • HOST
    • [設定値]: リモートホストのホスト名、またはIPアドレス
  • FILE1
    • [設定値]: 転送元ファイル名
  • FILE2
    • [設定値]: 転送先ファイル名
  • PORT
    • [設定値]: リモートホストのポート番号
    • [初期値]: 22

  [説明]

  SCPを実行する。

  FILE1またはFILE2のどちらか一方はリモートホスト上のファイルを指定し、もう一方にはルータのファイルシステムにあるファイルを指定する。
  FILE1、FILE2の両方にリモートホストのファイルを指定することはできない。
  同様にFILE1、FILE2の両方にルータのファイルシステムにあるファイルを指定することはできない。

  RTFSおよび外部メモリにあるファイルを指定する場合、USERおよびHOSTを省略しFILEのみを絶対パスで指定する。

  ルータの設定ファイル (config、config0〜config4) やファームウェア (exec、exec0、exec1) を指定する場合には、FILEに"config"や"exec0"のようにファイル名のみを指定する。

  HOSTにIPv6アドレスを指定する場合には、"["、"]"でIPアドレスを囲む。

  [実行例]

  • リモートホスト(192.168.1.1)から、ルータの exec0 にファイルをコピーする。

    scp user@192.168.1.1:rtx1200.bin exec0

  • ルータ上のファイル usb1:/log.txt を、リモートホスト(2001:1::1)へコピーする。

    scp usb1:/log.txt user@[2001:1::1]:log.txt

  
  
• SSHクライアントで利用可能な暗号アルゴリズムの設定

  [書式]

  ssh encrypt algorithm [ALGORITHM ...]
  no ssh encrypt algorithm [...]

  [設定値及び初期値]

  • ALGORITHM
    • [設定値]: 暗号アルゴリズム(空白で区切って複数指定可能)
      

      設定値	説明
      aes128-ctr	AES128-CTR
      aes192-ctr	AES192-CTR
      aes256-ctr	AES256-CTR
      aes128-cbc	AES128-CBC
      aes192-cbc	AES192-CBC
      aes256-cbc	AES256-CBC
      3des-cbc	3DES-CBC
      blowfish-cbc	Blowfish-CBC
      cast128-cbc	CAST-128-CBC
      arcfour	Arcfour

    • [初期値]: aes128-ctr aes192-ctr aes256-ctr

  [説明]

  SSHクライアントで利用可能な暗号アルゴリズムを設定する。

  ALGORITHMで指定した暗号アルゴリズムのリストをSSH接続時にサーバーへ提案する。

  [ノート]

  ALGORITHMで指定した暗号アルゴリズムをサーバーがサポートしていない場合には、そのサーバーとSSHによる接続ができない。

  blowfish-cbc, cast128-cbc, arcfour のパラメータは次のリビジョン以降で非対応。
  

  機種	ファームウェア
  RTX1210	Rev.14.01.34 以降
  NVR700W	Rev.15.00.16 以降
  NVR510	Rev.15.01.15 以降
  RTX830	Rev.15.02.10 以降
  RTX1220	すべてのリビジョン
  RTX1300
  RTX3510
  vRX Amazon EC2版
  vRX VMware ESXi版

  
  
• SSHサーバの公開鍵情報を保存するファイルの設定

  [書式]

  ssh known hosts FILE
  no ssh known hosts [FILE]

  [設定値及び初期値]

  • FILE
    • [設定値]: SSHサーバーの公開鍵情報を保存するファイル名
    • [初期値]: /ssh/known_hosts

  [説明]

  SSHサーバの公開鍵情報を保存するファイルを指定する。

SYSLOGメッセージ

本機能において出力されるSYSLOGメッセージの一覧を以下に示します。なお、実際に出力される各メッセージの先頭には"[SCP] "または"[SSH] "というプレフィックスが付与されます。

これら以外にも、サーバから受信したエラーメッセージをSYSLOGとして出力しています。

関連文書

• RTFS
• 外部メモリの利用
• TLS