概要
は、シンプルな2ステップのプロセスで、トレーディングパートナーとのOdette FTP（OFTP）接続の確立をサポートします。まず、OFTP プロファイルにローカルのOFTP の詳細（識別子、プライベート証明書など）を設定します。次に、Flowsページで、特定のトレーディングパートナーのOFTP の詳細を持つOFTP コネクタを設定します。 OFTP プロトコルはメッセージルーティングおよびクリアリングハウスサーバーをサポートしており、新しい接続を確立する際に混乱を招くことがあります。メッセージルーティング、SSID、SFID、およびこれらの概念が でどのように捉えられているかの詳細については、SSID とSFIDを参照してください。OFTP プロファイルの設定
プロファイルページには、ローカルのOFTP の詳細を設定するOFTP セクションがあります。主な設定の詳細は次のとおりです：- Odette 識別子（OFTP エンティティとしてのあなたを識別する、Odette から提供される値）
- サーバー設定（ポートおよびTLS 設定に関連するパラメータ）
- パスワード（識別子に関連付けられたパスワード。これは、トレーディングパートナーに提供する任意の値です）
- プライベート証明書（受信メッセージを復号し、送信メッセージに署名するために使用される証明書）
Odette 識別子
Odette 識別子はOdette によって割り当てられ、OFTP エンティティとしてのあなたを識別します。これは送信OFTP メッセージに含まれ、あなたを送信者として識別します。さらに、受信OFTP メッセージは、アプリケーションによって受け入れられるためにこの識別子宛てになっている必要があります。OFTP は、メッセージの受信者を識別するためにSSID とSFID という2つの異なる値を使用します。これらは同じ値の場合もあれば、異なる場合もあり、混乱を招くことがあります。SSID とSFID（およびそれらが の設定とどう関連するか）については、SSID とSFIDで詳しく説明します。
パスワード
識別子とは異なり、パスワードはトレーディングパートナーと合意する必要がある任意の値です（言い換えると、パートナーに送信し、パスワードがどうあるべきかについて両者が合意する限り、この値は自由に決めることができます）。 OFTP メッセージを正常に送受信するには、パスワードの値を送信者と受信者の両方が知っている必要があります。サーバー設定
プロファイルのServer Settings セクションは、受信メッセージをリッスンするOFTP サーバーのコアパラメータを定義します。Port は受信OFTP 接続を受け付けるポートを指定し、Use SSL/TLS 設定は受信接続をTLS/SSL セキュリティで暗号化する必要があるかどうかを決定します。TLS を有効にする場合は、サーバーを識別するためのTLS/SSL 証明書とパスワードをセットアップする必要があります。これは、以下で説明するPersonal Certificate 設定とは異なります。後者は、接続チャネル経由で受信した後 のOFTP メッセージを復号するために使用されます。パーソナル証明書
パーソナル証明書はデジタル暗号化（復号およびデジタル署名）に使用されます。Data Decryption Certificate は、あなたの公開暗号鍵とペアになる秘密鍵を持つ証明書です。トレーディングパートナーがあなたのData Decryption Certificate の公開鍵を使用してOFTP メッセージを保護すると、（ペアの秘密鍵を持つ）あなただけがメッセージを復号できることが保証されます。
新しい証明書ペアの作成
OFTP セキュリティに使用する秘密鍵と公開鍵のペアがまだない場合、 は自己署名証明書の作成をサポートしています。自己署名証明書はOFTP の領域では一般的ですが、信頼できる認証局（CA）から証明書を購入する必要があるパートナーもいます。 新しい証明書ペアを作成するには、Data Decryption Certificate ドロップダウンでCreate Certificate を選択します：
- Common Name：証明書を使用するサーバーのホスト名。シリアル番号と組み合わせて証明書を識別するために使用されます。
- File Name：
.pfx拡張子の証明書ファイルの名前。対応する公開鍵証明書には、同じ名前で.cer拡張子が付けられます。 - Serial Number：コモンネームと組み合わせて証明書を識別するために使用される一意のシリアル番号。
- Password：秘密鍵にアクセスするために必要なパスワード。
- Validity Period：証明書の有効期限を決定します。
- Key Size：512、1024、2048、または4096 ビットのいずれの鍵を作成するか。
- Public Key Type：X.509、OpenSSH、またはSSH2 のいずれの公開鍵を作成するか。
- Signature Algorithm：証明書の真正性を検証するためにデジタル署名を適用する際に使用するアルゴリズム。
data ディレクトリに配置されます。このディレクトリ内の証明書ファイルは、アプリケーション内の証明書タイプの設定のドロップダウンリストに含まれます。
OFTP コネクタの設定
OFTP プロファイルを設定したら、Flows ページに移動してOFTP コネクタのインスタンスを作成します。
必須の設定項目
OFTP の設定の詳細は、トレーディングパートナーから提供される必要があります。トレーディングパートナーが提供する必要がある詳細には、最低限、次のものが含まれます：- Odette 識別子
- パスワード
- 送信OFTP メッセージの送信先となるホスト名またはIP アドレス
- リモートホストがリッスンしているポート
- 暗号化用の公開証明書または鍵
追加の設定項目
パートナーは、次のような追加の要件を含める場合があります：- SSL/TLS および追加のTLS サーバー証明書：SSL/TLS はSettings タブで設定し、追加の証明書はAdvanced タブで設定します。これが指定されていない場合は、必須ではない とみなします。
- Secure Odette Authentication：Settings タブで設定します。これが指定されていない場合は、必須である とみなします。
- Virtual File Format：Settings タブで設定します。これが指定されていない場合は、ファイル形式は非構造化であるとみなします。
ログ記録
サーバー側のログ記録を有効にすると、OFTP 接続の問題のデバッグに役立ちます。デバッグの際、 は、コネクタのAdvanced タブのLog Level をDebug に設定することを推奨します。ログは、選択した間隔に従ってローテーション（つまり、圧縮されてアーカイブ場所に移動）したり、削除したりするように設定できます。積極的にデバッグしていないときは、Log Level をInfo に設定したままにしてください。
OFTP 接続のテスト
トレーディングパートナーの設定が完了したら、テスト文書を生成して送信接続をテストできます。OFTP コネクタのTransactions タブに移動し、More > Create Test Files を選択します。 AutomationタブでSend Automation が無効になっていない限り、コネクタはこれらのテストファイルの処理を自動的に試みます。設定したパートナーにテストファイルを送信する際に発生したエラーは、エラーのコンテキストと詳細を含むログファイルとともに、Transactions タブに報告されます。接続の問題をさらに診断するには、Advanced タブのLog Level およびLog Messages オプションを使用します。 正常に処理されたファイルは、Transactions タブに緑色のSent ステータスで表示されます。テストファイルの送信に成功すれば、OFTP の設定が正しいことが確認できます。トレーディングパートナーへのOFTP の詳細の提供
そのパートナー用のOFTP コネクタを設定するためにトレーディングパートナーからOFTP の設定の詳細を提供してもらう必要があるのと同様に、あなたもパートナーにOFTP の設定の詳細を提供する必要があります。 最低限、パートナーに次のものを提供する必要があります：- あなたのOdette 識別子
- あなたのパスワード
- あなたの公開鍵または暗号化証明書
- あなたの受信ホスト名またはIP アドレスとポート（サーバー設定プロファイルタブのHostname およびPort の値）
OFTP メッセージの送信
OFTP コネクタが送信OFTP 接続の確立に成功すると、ファイルを安全かつ確実にトレーディングパートナーに送信できます。Transactions タブ
OFTP コネクタのTransactions タブに配置されたファイルは、コネクタによって送信されるようスケジュールされます。 Automation タブでSend Automation が有効になっている場合（デフォルトで有効）、コネクタは処理するファイルがないかこのフォルダを自動的にポーリングします。あるいは、Transactions タブから手動でファイルを送信することもできます。対象のファイルの左側にあるチェックボックスをクリックし、Send ボタンをクリックします。 Transactions タブを使用して、Send フォルダにファイルをアップロードすることもできます。フローの一部としての送信
ほとんどのワークフローでは、ファイルはOFTP コネクタによって送信される前に、他の コネクタによって処理されます。フロー内で別のコネクタがOFTP コネクタに接続されている場合、ファイルは自動的にOFTP コネクタのSend フォルダに渡されます。レシートの受信
Settings タブで署名済みレシートをリクエスト が有効になっている場合、コネクタは自動的にOFTP レシートを待ちます。レシートに否定的な応答が含まれている場合（例えば、パートナーが何らかの理由で交換を拒否した場合）、コネクタは正常な送信ではなくエラーを報告します。OFTP メッセージの受信
OFTP メッセージが のOFTP サーバーに到着すると、アプリケーションはメッセージを特定のOFTP コネクタにルーティングしようとします。 は、メッセージヘッダー内のOdette 識別子を使用して、受信ファイルを、メッセージを送信したパートナー用に設定されたOFTP コネクタにルーティングします。 アプリケーションが（OFTP 識別子に基づいて）受信メッセージ用に設定されたOFTP コネクタを見つけられない場合、アプリケーションログにエラーが記録され、ファイルは受信されません。タブ
OFTP 経由で受信したファイルが（設定されたOdette 識別子に基づいて）特定のOFTP コネクタにルーティングされると、ファイルはそのコネクタの**** タブに到着します。 OFTP コネクタがフロー内の他のコネクタに接続されている場合、ファイルはReceive フォルダに留まらず、代わりにフロー内の次のコネクタに渡されます。 OFTP コネクタがフロー内の別のコネクタに接続されていない場合、OFTP コネクタが受信したファイルはReceive フォルダに残ります。これらのファイルは、コネクタの**** タブで確認できます。レシートの送信
受信したOFTP メッセージがレシートをリクエストしている場合、OFTP コネクタは自動的にレシートを生成して送信します。OFTP メッセージの受信中にエラーが発生した場合、このエラーは に記録され、トレーディングパートナーに返されるレシートに含まれます。 レシートの送信に必要な設定は受信OFTP メッセージに含まれており、OFTP コネクタで明示的に設定する必要はありません。SSID とSFID
このセクションでは、SSID とSFID の値、メッセージルーティング、および の設定が接続動作を定義・制御するためにどのように使用されるかの概念的な概要を説明します。OFTP におけるメッセージルーティングを概念的に理解することで、接続の確立とファイルの転送におけるSSID とSFID の値の役割が明確になります。メッセージルーティング
OFTP クライアントがOFTP サーバーにファイルを送信する際、クライアントはOFTP サーバーに対して、そのファイルを別のOFTP エンティティまたはサーバーに転送するよう要求できます。serverA に送信したファイルがserverB にルーティングされることを期待してファイルを送信するこのプロセスが、メッセージルーティング と呼ばれるものです。
メッセージルーティングの一般的なユースケースは、単一のサーバーを複数のOFTP エンドポイントのゲートウェイ、またはクリアリングハウスとして機能させることです。例えば、それぞれが固有のOFTP メッセージを受信する必要がある3つの支社を持つ企業を想像してください。単一のOFTP サーバーが企業全体のクリアリングハウスとして機能し、外部からOFTP メッセージを受信して、適切な内部OFTP エンドポイント（各支社専用のOFTP サーバー）にルーティングできます。
ただし、OFTP 接続はメッセージルーティングを使用する必要 はありません。あるエンドポイントから別のエンドポイントへ直接接続を確立し、中間ステップなしでメッセージを渡すこともできます。
SSID
OFTP クライアントがOFTP サーバーに接続する際、クライアントはサーバーに自身のOdette 識別子と関連するパスワードを送信することで、自身のアイデンティティをサーバーに通知します。サーバーがこのId を認識し、接続を許可すべきと判断した場合、サーバーは自身のOdette 識別子とパスワードを返送します。両者が（Id によって）互いを認識した場合にのみ、接続が成功します。 これらのId 値は、Start Session ID の略であるSSID コマンドを使用して交換されます。SSID 値は、OFTP セッション（接続）を確立する際にリモート側のアイデンティティを確認するために使用されるId であると考えてください。SFID
Start File ID の略であるSFID も、Odette 識別子の値ですが、SSID とは異なる方法で使用されます。SSID がOFTP サーバーとのセッション（接続）を開始するために使用されるのに対し、SFID はファイルの最終的な受信者を識別するために使用されます。クライアントがOFTP 経由でファイルを送信する際、ファイルを別のOFTP エンティティにルーティングすべきかどうかをリモート側に知らせるためにSFID 値を含めます。 これは、ファイルがターゲットサーバーに留まることを意図している場合、SFID 値がサーバーのSSID と同じになり得ることを意味します。また、クライアントがクリアリングハウスまたはゲートウェイのOFTP サーバーに接続し、そのサーバーがファイルを最終受信者にルーティングする必要がある場合は、異なる値になることもあります。でのSSID とSFID 値の使用
で正しいSSID とSFID の値を設定するかどうかは、OFTP トレーディングパートナーがメッセージルーティングを必要とするかどうかに依存します。トレーディングパートナーがSSID とSFID に2つの異なる識別子の値を提供する場合、これはパートナーがメッセージルーティングを必要としていることを示します。メッセージをルーティングする場合の設定
パートナーがメッセージルーティングを必要とする場合、2つの別々のOFTP コネクタを設定する必要があります。一方のコネクタ（connectorA と呼びます）にはクリアリングハウスサーバー（中間のサーバー）の接続の詳細を設定し、もう一方のコネクタ（connectorB）には最終受信者サーバーの接続の詳細を設定します。
connectorA のOdette Identifier フィールドには、パートナーのSSID 値、つまりクリアリングハウスサーバーを識別するために使用される値を保持します。connectorB のOdette Identifier フィールドには、パートナーのSFID 値、つまり最終受信者サーバーを識別するために使用される値を保持します。さらに、connectorB では、Settings タブのRouting Partner フィールドをconnectorA に設定する必要があります。
このセットアップを設定すると、パートナーに送信されるファイルはconnectorB にアップロードまたは入力されます。このコネクタは（Routing Partner を設定した結果として）connectorA を使用してクリアリングハウスサーバーに接続し、connectorB のOdette Identifier フィールドのSFID 値を使用して、ファイルを正しいターゲットの送信先にルーティングします。