SFTP の設定手順

目次

• SFTP の設定手順
  • ホスティングと認証
  • 構成
  • 頻度とスケジューリング
  • レポートおよびエラー処理
    • 関連するよくあるご質問
  • SFTP サーバー用公開 SSH キーの作成方法
    • フォーマット
    • パターン
    • SSHキーの作成
    • サンプルキー
  • 特定のレコードタイプに関する手順

ホスティングと認証

お客様のSFTPフォルダは、専用のSFTPサーバー（AWS経由）上にホストされています。各クライアントには固有のユーザーアカウントが割り当てられており、それぞれのSFTPフォルダへ直接アクセスできます。当社では鍵認証に対応しております。そのため、公開鍵と秘密鍵のペアを作成し、フォルダ設定時にPublic Key欄に公開鍵をご入力いただく必要がございます。鍵はopenSSH RSA形式でご用意ください。鍵の作成方法については、SFTPサーバー用公開SSHキーの作成方法をご参照ください。

設定

1. 作成した公開鍵をPublic Key欄にご入力ください。必要に応じてUsername欄も更新できます。Username欄の値は、英字・数字・アンダースコアのいずれかで始まり、3～100文字である必要があります。使用可能な文字は、英字、数字、アンダースコア、アットマーク（@）、ドット（.）、ハイフン（-）です。

2. Copy the Username, Spotnana domain URL, and Port number values to a secure location as they will be needed later by the team within your organization that configures the sending of files to the newly created folder. 
   Note: Once the SFTP folder setup is complete, these values can be accessed again under Manage.

3. ファイルアップロードに関するレポートを受信したいメールアドレスをSFTP email notification欄にご入力ください。詳細については、下記のレポートとエラー処理をご参照ください。

4. Connectをクリックしてください。

公開鍵が追加されると、初期ステータスはUnverifiedに設定されます。このステータスは、実際にフォルダにファイルが受信されるまでOBT上に表示されます。送信するファイルは任意のテストファイル、または実際のHRフィードやカスタムフィールドファイルでも問題ありません（対応フォーマットのみ処理されます）。また、公開鍵を後から更新した場合も、次回ファイルが受信されるまでステータスはUnverifiedにリセットされます。

SFTPフォルダを削除するには、Disconnectをクリックしてください。これによりSFTPフォルダが削除されます。再度設定が必要な場合は、上記の情報を最初からすべてご入力いただく必要があります。

頻度およびスケジューリング

ファイルのアップロード頻度やスケジューリングは、お客様ご自身でご設定いただけます。ファイルオブジェクトの作成がトリガーとなり、ファイル処理が開始されます。つまり、お客様が当社のSFTPサーバー上のフォルダにファイルをアップロードされた時点で、当社のアプリケーションがアップロード処理を開始いたします。

各レコードタイプ（例：ユーザー、カスタムフィールド、法人など）ごとの推奨される頻度やスケジューリングについては、各レコードタイプのSFTP手順内にある頻度およびスケジューリングセクションをご参照ください。

レポートおよびエラー処理

お客様のファイルアップロードに関するデータを収集し、各ファイルアップロード後に社内レポートを作成しております。このレポートは、セットアップ時にSFTPメール通知欄でご指定いただいたメールアドレス宛に送信されます。アップロードされた各ファイルについて、レポートには以下の内容が含まれます。

• ファイルのアップロードが失敗した理由（フォーマットの誤り、列名の不足など）。

• ファイル内の特定の行がアップロードできなかった理由。部分的な更新は行わず、特定の列でエラーが発生した場合や必須項目が不足している場合、その行は失敗となります。

• アップロードのステータス（保留中、成功、失敗）。

このレポートの内容をもとにエラーの原因を特定し、トラブルシューティングを行うことができます。エラーが解決できない場合は、テクニカルサポートまでご連絡ください。

関連するよくあるご質問

1. 更新または追加が必要なレコードのみを含む増分ファイルの受け入れは可能ですか？

   • はい

2. アップロードするファイル（SFTP経由または手動アップロードの場合も含む）には、使用しないオプション列も含める必要がありますか？

   • いいえ

SFTPサーバー用公開SSHキーの作成方法

下記の手順に従い、弊社へご提出いただく公開SSHキーを作成してください。

フォーマット

• タイプ：文字列

• 長さの制約：最大2048文字

パターン

 ^ssh-rsa\s+[A-Za-z0-9+/]+[=]{0,3}(\s+.+)?\s*$

SSHキーの作成

SSHキーを作成するには、Windowsのコマンドライン、またはmacOS・Linux・UNIXのターミナルで以下のコマンドを実行してください。

ssh-keygen -t rsa -b 4096 -f key_name

場所

• -t は暗号化タイプを指定します

• -b は鍵長（ビット単位）を指定します

• -f は鍵名を指定します

サンプルキー

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDDJB9oBRPrBegMDPEQo+HmNDb/jKUJL6q2kQpNNMDjNps9mhhwJ1dP/lOavMitBPAndeXlwaNEm2XbGaSrZtD/tbQTX1HQjP6pacy+Alf8kYBm5QFfl/Z6lGC8qHys10fpRXgYE7UhdSv6VyRqt1gELGFQwVBZ2kJJuBGJF1IRywwvG/h68B8iWU1+6KEWYQoUcT45r3j3otnx4NhhzpTiNgDbMk0ix+kar4/IstobRLcb7rt7FoUerTLNrVDi69DqbsGY5LN+NM8jVx0sPQLRC/ruil8pTHP3k4rDCc7a80+sH4sUTW+mHc7MTqbi/CcyyFAD8h7p6WqxEydOaJjMnvqAbE17BOj0TSxv3HMohTf3skzE7PbzVcjIfHTpFPGxmJkghAYAMi5l9VvAs91IpVylxjqPss3xQQJIZEmQdG2k7zk/UpsUFlmaOj6lCHRicFKCixKekzzm3nFuJvDEklurtydOQjZ8WkPzTSJfZBdKMuMUi0SQ9m9ZAw99t0=

特定レコードタイプの手順

SFTPで特定のレコードタイプをアップロードする方法については、以下のレコードごとのトピックをご参照ください。

• HRフィード（ユーザー）
• カスタムフィールド
• オフィス
• 法人