SFTP - 設定手順

目次

• SFTP - 設定手順
  • ホスティングと認証について
  • 設定方法
  • 転送頻度とスケジュール
  • レポートとエラー対応
    • 関連するよくあるご質問
  • SFTPサーバー用の公開SSHキーの作成方法
    • フォーマット
    • パターン
    • SSHキーの作成
    • サンプルキー
  • 各種レコードタイプごとの手順

ホスティングと認証について

お客様専用のSFTPフォルダは、AWS上の専用SFTPサーバーでご利用いただけます。お客様ごとに個別のユーザーアカウントが発行され、ご自身のSFTPフォルダへ直接アクセスできます。鍵認証方式に対応していますので、公開鍵と秘密鍵のペアを作成し、公開鍵欄に公開鍵を登録してください。openSSH RSA形式です。鍵の作成方法については、SFTPサーバー用の公開SSHキーの作成方法をご覧ください。

設定方法

1. 作成した公開鍵を「公開鍵」欄に入力してください。必要に応じて、ユーザー名欄も変更できます。ユーザー名は、英数字またはアンダースコアで始まり、3文字以上100文字以内で設定してください。英字、数字、アンダースコア、@、ドット（.）、ハイフン（-）が利用できます。

2. 「ユーザー名」、「SpotnanaドメインURL」、および「ポート番号」は、後でファイル送信設定を行う担当者が必要となるため、安全な場所に控えておいてください。
   ご注意:SFTPフォルダの設定が完了した後でも、これらの値は 管理 からいつでも確認できます。

3. ファイルアップロードに関するレポートを受け取りたいメールアドレスを、 SFTPメール通知 欄に入力してください。詳しくは、レポートとエラー対応 の項目をご覧ください。

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

公開鍵を追加すると、最初はステータスが 未確認 になります。実際にフォルダへファイルが届くまで、OBT上ではこのステータスが表示されます。送信するファイルはテスト用でも、実際のHRフィードやカスタムフィールドのファイルでも構いません（対応フォーマットのみ処理されます）。また、公開鍵を更新した場合も、次にファイルが届くまでステータスは再び 未確認 にリセットされます。

SFTPフォルダを削除したい場合は、切断 をクリックしてください。これで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フィード（ユーザー）
• カスタムフィールド
• オフィス
• 法人