本記事では、SFTPを利用してb→dashにデータを取り込む方法について紹介しています。SFTP連携には下記の2つのパターンがあり、それぞれで設定方法が異なります。下記の俯瞰図に沿って、貴社の環境に合ったパターンを選択してください。

　1. b→dashが貴社のサーバーからデータを受け取るパターン: 貴社サーバー側で「SSH公開鍵/秘密鍵」を発行し、b→dashの中間サーバーにファイルを転送する方式
　2. b→dashが貴社のサーバーへデータを取りに行くパターン: b→dashの公開鍵を貴社サーバーに登録し、b→dashが指定時刻に貴社サーバーからファイルを取得する方式

どちらのパターンも、b→dashに連携したいデータを基幹システムから抽出して中間サーバーへ転送する前提作業が必要です(SQLを利用して処理を組むことが一般的、抽出/転送方法は環境により異なるため本記事では割愛)。

[前提] SFTP連携で取込可能なファイル形式と仕様

SFTP連携での設定に進む前に、取り込み対象のデータファイルが下記の仕様に準拠しているか確認しましょう。

1. b→dashが貴社のサーバーからデータを受け取るパターン

このパターンでは、貴社サーバー側でSSH公開鍵/秘密鍵を発行し、貴社サーバーからb→dashの中間サーバーへファイルを転送します。

設定方法

1.「データパレット」をクリックします
2.「データを連携」をクリックします
3. 右上の「新規追加」をクリックします
4.「SFTP」を選択し、「適用」をクリックします
5.「b→dashが貴社のサーバーからデータを受け取る」を選択し、「次へ」をクリックします
6.「SSH公開鍵」を入力します(SSH公開鍵の作成方法は下記参照)
7. [任意]「パスワード」をb→dashに入力します
8. b→dashの「接続情報」(ホスト名/ポート番号/ユーザー名)を中間サーバーに登録します
9. 入力が完了したら「次へ」をクリックします
10. 名前を入力し、「保存」をクリックします

SSH公開鍵の作成方法

SFTP連携には「SSH公開鍵」の作成が必要です。貴社環境の中間サーバーによって作成方法は異なりますが、ここでは「Unix/Linux環境」と「Windows環境(WinSCP利用)」の2つを例に紹介します。

Unix/Linux環境の場合

1. サーバーにログインし、任意のユーザーで以下のコマンドを入力
　 ssh-keygen -t rsa (パスフレーズなしで実行)
2. 以下のコマンドで公開鍵ファイル(id_rsa.pub)と秘密鍵ファイル(id_rsa)が生成されていることを確認
　 ls -ltr ~/.ssh
3. 以下のコマンドで公開鍵ファイルの中身を表示
　 cat ~/.ssh/id_rsa.pub
4.「ssh-rsa」から始まる文字列をb→dash画面に入力(最初から最後の文字までコピー、途中で改行が入らないように注意)

Windows環境の場合(WinSCP利用)

1. WinSCPをダウンロードし、貴社の中間サーバーにインストール
2. 「WinSCP」を開き、画面左下の「ツール」から「PuTTYgenを実行」を選択
3. 「Parameters」から「RSA」を選択し、「Generate」をクリック
4. 「Public key for pasting into OpenSSH authorized_keys file」に表示された公開鍵をb→dash画面に入力
5. 「Save private key」を選択し、任意のファイル名を付けて「.ppk」ファイルをローカルに保存(b→dashとの疎通確認時に使用)

※ 公開鍵ファイル(.pub/.pbk)の内容を確認するには、「メモ帳(テキストエディタ)」を使ってファイルを開く必要があります(右クリック → プログラムから開く → メモ帳)

疎通確認・ファイル転送の方法

設定完了後、サーバー間で疎通ができていることを確認し、b→dashへファイルを転送します。具体的な方法は、貴社環境の中間サーバーによって異なります。

Unix/Linux環境の場合

1. b→dashに連携するファイルがあることを確認
　 ls -ltr
2. 以下のSFTPコマンドを入力(「100025_13」の部分はb→dashアカウントのユーザー名に差し替え)
　 sftp -oPort=10222 -i ~/.ssh/id_rsa management_console_100025_13@sftp.smart-bdash.com:input/
3.「Connected to sftp.smart-bdash.com.」のカーソルが表示されたら疎通確認は完了
4. ファイル転送はシェルなどを用いて自動化(cronで実行スケジュールを設定)

Windows環境の場合

1. WinSCPのログイン画面で「設定」を選択し、「認証」→秘密鍵欄で先ほど作成した「.ppk」ファイルを選択
2. b→dashの接続情報を参照し「ホスト名」「ポート番号」「ユーザー名」を入力してログイン
3. WinSCP画面右フレームに「input」「output」ディレクトリが表示されれば疎通成功
4. ファイル転送はWinSCPの「.bat」スクリプト+「タスクスケジューラ」で自動化

検証方法

貴社中間サーバーで設定した「連携タイミング」の時間になると、b→dashに対してファイルを転送する処理が実施されます。

1. 連携のステータスを確認します(ステータスはアイコンで把握できます)
2. ステータスが「接続完了」になった連携設定をクリックします
3. 連携設定をクリックすると連携されているデータを確認でき、「取込設定」を行うことができます

※ b→dashの中間サーバーからb→dashに取込まれたデータファイルは、b→dashの中間サーバーから削除されます
　 取込設定の詳細については「データを取り込みたい」をご参照ください
　 セキュリティ上の理由で接続を制御する必要がある場合は、b→dashのIPアドレスのみアクセス許可してください(取込/出力で設定するIPアドレスを知りたい参照)

2. b→dashが貴社のサーバーへデータを取りに行くパターン

このパターンでは、接続情報として「ホスト名」「ポート番号」「ユーザー名」「ディレクトリパス」の4項目を事前に準備する必要がありますが、貴社のサーバーで「SSH公開鍵/秘密鍵」を発行・準備する必要はありません。b→dashが発行する公開鍵を貴社サーバーに登録する形になります。

設定方法

1.「データパレット」をクリックします
2.「データを連携」をクリックします
3. 右上の「新規作成」をクリックします
4.「SFTP」を選択し、「適用」をクリックします
5.「b→dashが貴社のサーバーからデータを取りに行く」を選択し、「次へ」をクリックします
6. 貴社の中間サーバーの「接続情報」(ホスト名/ポート番号/ユーザー名/ディレクトリパス)をb→dashに入力します
7. [任意]「パスワード」をb→dashに入力します
8. 表示されている「SSH公開鍵」をコピーし、貴社の中間サーバーに登録します
9. 入力が完了したら「次へ」をクリックします
10. 連携頻度と時間を設定の上「追加」を選択し、「次へ」をクリックします
11. 名前を入力し、「保存」をクリックします

※ ディレクトリパス配下にあるデータファイルはすべて取得されるため、b→dashに連携したいデータファイルだけをディレクトリパスに置いてください
　 連携タイミングは複数設定可能(b→dashの中間サーバーから貴社の中間サーバーへファイルを取りに行く処理が実施されます)

中間サーバーの接続情報を変更する手順

1.「SFTPの連携システム」を選択し「編集」をクリックします
2. 変更した中間サーバーの「接続情報(ホスト名/ポート番号/ユーザー名/ディレクトリパス/パスワード)」を入力し「次へ」をクリックします
3. 連携頻度と時間を設定の上「追加」を選択し、「次へ」をクリックします
4.「保存」をクリックします

検証方法

b→dash管理画面に設定した「連携タイミング」の時間になると、貴社の中間サーバーに対してファイルを取得する処理が実施されます。

1. 連携のステータスを確認します(ステータスはアイコンで把握できます)
2. ステータスが「接続完了」になったら連携設定をクリックします
3. 連携設定をクリックすると連携されているデータを確認でき、「取込設定」を行うことができます

※ 貴社の中間サーバーからb→dashの中間サーバーに転送したデータファイルは、貴社の中間サーバーから削除されません(貴社でデータファイルの削除対応が必要)

[参考] 0レコード/0バイトファイルの挙動とレコード表示の仕様

SFTP連携設定完了後の挙動について、特殊なケースの仕様を下記にまとめます。

レコード数「0件」もしくは「0バイト」のデータファイルを連携した場合