概要
は、シンプルな2つのステップで取引パートナーとのAS2 接続を確立できます。まず、ローカルのAS2 詳細(識別子、プライベート証明書など)でAS2 プロファイルを設定します。次に、フローページで、特定の取引パートナーのAS2 詳細を使用してAS2 コネクタを設定します。ビデオリソース
AS2 コネクタを素早くセットアップする方法については、こちらの短い動画をご覧ください。AS2 プロファイルの設定
プロファイルページには、ローカルのAS2 詳細を設定するAS2 セクションがあります。主な設定項目は次のとおりです:- AS2 識別子(この値は、AS2 エンティティとして を取引パートナーに識別させるものです)
- プライベート証明書(受信メッセージの復号と送信メッセージの署名に使用される証明書)
AS2 識別子
AS2 識別子は送信されるAS2 メッセージに含まれ、送信者としてのあなたを識別します。さらに、受信されるAS2 メッセージは、アプリケーションに受け入れられるためにこの識別子宛てになっている必要があります。AS2 識別子にはいくつかの制限があります。例えば、空白文字を含めることはできず、大文字と小文字が区別されます。それら(および取引パートナーが課す制限)を除けば、AS2 識別子は相互に合意した任意の値にできます。
プライベート証明書
プライベート証明書は、デジタル暗号化(復号とデジタル署名)に使用されます。プライベート証明書には、パブリック暗号化キーと対になるプライベートキーが含まれています。取引パートナーがあなたのパブリック暗号化キーを使用してAS2 メッセージを保護する場合、これにより(対になるプライベートキーで)あなただけがそのメッセージを復号できることが保証されます。 は、PKCS#12 形式(.pfx または.p12 ファイル)のプライベート証明書、およびPEM エンコードされたパブリックキー証明書(.cer ファイル)をサポートしています。
新しい証明書ペアの作成
AS2 セキュリティに使用するプライベートキーとパブリックキーのペアをまだ持っていない場合、 は自己署名証明書の作成をサポートしています。自己署名証明書はAS2 の領域では一般的ですが、信頼された認証局(CA)から証明書を購入することをパートナーが要求する場合もあります。 新しい証明書ペアを作成するには、プライベート証明書ドロップダウンで証明書を作成を選択します:
- Common Name:証明書を使用するサーバーのホスト名。シリアル番号と組み合わせて証明書を識別するために使用されます。
- File Name:
.pfx拡張子を持つ証明書ファイルの名前。対応するパブリックキー証明書には、.cer拡張子で同じ名前が付けられます。 - Serial Number:Common Name と組み合わせて証明書を識別するために使用される一意のシリアル番号。
- Password:プライベートキーへのアクセスに必要なパスワード。
- Validity Period:証明書の有効期限を決定します。
- Key Size:512、1024、2048、または4096 ビットのキーのいずれを作成するか。
- Public Key Type:X.509、OpenSSH、またはSSH2 のパブリックキーのいずれを作成するか。
- Signature Algorithm:証明書の真正性を検証するためにデジタル署名を適用する際に使用するアルゴリズム。
data ディレクトリに配置されます。このディレクトリ内の証明書ファイルは、アプリケーション内の証明書タイプの設定のドロップダウンリストに含まれます。
アプリケーションURL
AS2 プロファイルのアプリケーションURL セクションは、取引パートナーが にAS2 メッセージを送信できる、公開アクセス可能なエンドポイントを定義します。設定 > 高度な設定ページの追加設定部分にあるベースURL フィールドに、 がホストされているマシンまたはネットワークへのベースURL(例:https://mydomain.com/{siteNameShort})を設定します。次のエンドポイントは、このドメイン値とアプリケーションのWeb サーバーがリッスンしているポートに基づいて生成されます:
- 非同期MDN URL(非同期MDN が必要な場合に、パートナーが非同期MDN レシートを送信すべきエンドポイント)
- 受信URL(パートナーがAS2 メッセージを送信すべきエンドポイント)

AS2 コネクタの設定
AS2 プロファイルの設定後、フローページに移動してAS2 コネクタのインスタンスを作成します。各AS2 コネクタは、単一の取引パートナーのAS2 詳細を使用して設定されます。
必須の設定
AS2 設定詳細は取引パートナーから提供される必要があります。少なくとも、取引パートナーが提供しなければならない詳細には次が含まれます:- AS2 識別子
- 送信するAS2 メッセージの送信先URL またはエンドポイント
- 暗号化用のパブリック証明書またはキー


追加の設定
パートナーは、次のような追加要件を含めることができます:- 同期または非同期のMDN(設定タブのMDN レシートをリクエスト部分で設定)
- HTTPS サーバーへの接続用のTLS サーバー証明書(設定タブの取引パートナー証明書部分で設定)
- 特定の暗号化アルゴリズムまたは署名アルゴリズム(高度な設定タブの暗号化アルゴリズムおよび署名アルゴリズムで設定)
- 署名を検証するための(暗号化証明書に加えた)別個の証明書(高度な設定タブのパートナー署名証明書で設定)
AS2 接続のテスト
取引パートナーの設定が完了したら、テストドキュメントを生成して送信接続をテストできます。AS2 コネクタのトランザクションタブに移動し、More > Create Test Files を選択します。 オートメーションタブで送信のオートメーションが無効化されていない限り、コネクタはこれらのテストファイルを自動的に処理しようとします。設定済みのパートナーにテストファイルを送信する際に発生したエラーは、エラーに関するコンテキストと詳細を含むログファイルとともに、トランザクションタブに報告されます。接続の問題をさらに診断するには、高度な設定タブのログレベルおよびログメッセージオプションを使用します。 正常に処理されたファイルは、トランザクションタブに緑色のSent ステータスで表示されます。テストファイルの送信に成功すれば、AS2 設定が正しいことが確認できます。取引パートナーへのAS2 詳細の提供
取引パートナーが、そのパートナー用のAS2 コネクタを設定するためにあなたにAS2 設定詳細を提供しなければならないのと同様に、あなたもパートナーにAS2 設定詳細を提供する必要があります。 少なくとも、パートナーに次を提供する必要があります:- あなたのAS2 識別子
- あなたのパブリックキーまたは暗号化証明書
- あなたの受信URL
パブリックURL
この情報をパートナーに提供する最も簡単な方法は、AS2 プロファイルのアプリケーションURLでAS2 プロファイル設定をPublic.rst に公開するオプションを有効にすることです。パブリックURL フィールドには、パートナーに提供できるリンクが含まれています。このリンクから、パートナーはあなたのAS2 設定を閲覧し、あなたのパブリックキーまたは暗号化証明書をダウンロードできます。パブリックURL の値は、取引パートナーがAS2 メッセージを送信すべき受信URL フィールド、および取引パートナーが(非同期MDN が必要な場合に)非同期MDN レシートを送信すべきAsynchronous MDN URL フィールドとは異なります。
手動で詳細を提供する
あるいは、これらの詳細を手動でパートナーに送信することもできます。AS2 識別子および受信URL の値は、AS2 プロファイルで確認できます。 パブリックキーまたは暗号化証明書をパートナーに送信するには、ディスク上の.cer ファイルに移動します:
- のルートインストールディレクトリに移動します
- ルートディレクトリの
dataフォルダを開きます - AS2 プロファイルのプライベート証明書と同じファイル名(
.pfxの代わりに.cer拡張子が付いた同じファイル名)の.cerファイルを見つけます .cerファイルをコピーしてパートナーと共有します
AS2 メッセージの送信
送信AS2 接続が正常に確立されると、ファイルを取引パートナーに安全かつ確実に送信できます。トランザクションタブ
AS2 コネクタのトランザクションタブに配置されたファイルは、コネクタによって送信されるようスケジュールされます。 オートメーションタブで送信のオートメーションが有効になっている場合(デフォルトで有効)、コネクタは処理するファイルがないかこのフォルダを自動的にポーリングします。あるいは、トランザクションタブから手動でファイルを送信することもできます。対象ファイルの左側にあるチェックボックスをクリックし、送信ボタンをクリックします。 次の画像に示すように、トランザクションタブを使用してSend フォルダにファイルをアップロードすることもできます:
フローの一部として送信する
ほとんどのワークフローでは、ファイルはAS2 コネクタによって送信される前に、他の コネクタによって処理されます。フロー内で別のコネクタがAS2 コネクタに接続されている場合、ファイルは自動的にAS2 コネクタのSend フォルダに渡されます。 以下のフロー例では、ファイルがX12 コネクタによって処理された後、自動的にAS2 コネクタのSend フォルダに追加されます:
MDN レシートの受信
MDN レシートをリクエストが有効になっている場合、AS2 コネクタは自動的にMDN レシートを待ちます。MDN レシートに否定的な応答が含まれている場合(例えば、パートナーが何らかの理由で交換を拒否した場合)、コネクタは送信成功ではなくエラーを報告します。 非同期MDN がリクエストされた場合、コネクタはパートナーがMDN を返すまで pending MDN ステータスのままになります。 は、AS2 で交換するファイルが非常に大きい(500MB 以上)場合を除き、同期MDN の使用を推奨しています。AS2 メッセージの受信
AS2 メッセージが のWeb サーバーに到着すると、アプリケーションはそのメッセージを特定のAS2 コネクタにルーティングします。 はメッセージヘッダーのAS2 識別子(AS2-To およびAS2-From ヘッダー)を使用して、受信ファイルを、メッセージを送信したパートナー用に設定されたAS2 コネクタにルーティングします。 アプリケーションが(AS2 識別子に基づいて)受信メッセージ用に設定されたAS2 コネクタを見つけられない場合、アプリケーションログにエラーが記録され、ファイルは受信されません。Output タブ
AS2 で受信したファイルが(設定済みのAS2 識別子に基づいて)特定のAS2 コネクタにルーティングされると、ファイルはそのコネクタのOutput タブに到着します。 AS2 コネクタがフロー内の他のコネクタに接続されている場合、ファイルはReceive フォルダに留まらず、代わりにフロー内の次のコネクタに渡されます。以下のフロー例では、AS2 で受信された(そしてこのAS2 コネクタにルーティングされた)ファイルは、さらなる処理のために自動的にX12 コネクタに渡されます。