Skip to main content

概要

は、シンプルな2つのステップで取引パートナーとのAS4 接続を確立できます。まず、ローカルのAS4 詳細(識別子、プライベート証明書など)でAS4 プロファイルを設定します。次に、フローページで、特定の取引パートナーのAS4 詳細を使用してAS4 コネクタを設定します。

AS4 プロファイルの設定

プロファイルページには、ローカルのAS4 詳細を設定するAS4 セクションがあります。主な設定項目は次のとおりです:
  • パーティ識別子(AS4 エンティティとして を取引パートナーに識別させる値)
  • プライベート証明書(受信メッセージの復号と送信メッセージの署名に使用される証明書)
以下で説明するように、ナビゲーションバーのプロファイルをクリックしてAS4 プロファイル設定を構成します。

パーティ識別子

AS4 識別子は送信されるAS4 メッセージに含まれ、送信者としてのあなたを識別します。さらに、受信されるAS4 メッセージは、アプリケーションに受け入れられるためにこの識別子宛てになっている必要があります。AS4 識別子にはいくつかの制限があります。例えば、空白文字を含めることはできず、大文字と小文字が区別されます。それら(および取引パートナーが課す制限)を除けば、AS4 識別子は相互に合意した任意の値にできます。 一部の識別子は、識別子の値にコンテキストを提供するためにパーティ識別子の種類で修飾する必要があります。この値は、urn:oasis:names:tc:ebcore:partyid-type:iso6523:0060 のような、ID が属するドメインである必要があります。 パーティ識別子の設定

プライベート証明書

プライベート証明書は、デジタル暗号化(復号とデジタル署名)に使用されます。プライベート証明書には、パブリック暗号化キーと対になるプライベートキーが含まれています。取引パートナーがあなたのパブリック暗号化キーを使用してAS4 メッセージを保護する場合、これにより(対になるプライベートキーで)あなただけがそのメッセージを復号できることが保証されます。 は、PKCS#12 形式(.pfx または.p12 ファイル)のプライベート証明書、およびPEM エンコードされたパブリックキー証明書(.cer ファイル)をサポートしています。 プライベート証明書の設定

新しい証明書ペアの作成

AS4 セキュリティに使用するプライベートキーとパブリックキーのペアをまだ持っていない場合、 は自己署名証明書の作成をサポートしています。自己署名証明書はAS4 の領域では一般的ですが、信頼された認証局(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

AS4 プロファイルのアプリケーションURL セクションは、取引パートナーが にAS4 メッセージを送信できる、公開アクセス可能なエンドポイントを定義します。設定 > 高度な設定ページの追加設定部分にあるベースURL フィールドに、 がホストされているマシンまたはネットワークへのベースURL(例:https://mydomain.com/{siteNameShort})を設定します。受信URL エンドポイントは、このドメイン値とアプリケーションのWeb サーバーがリッスンしているポートに基づいて生成されます。

AS4 コネクタの設定

AS4 プロファイルの設定後、フローページに移動してAS4 コネクタのインスタンスを作成します。各AS4 コネクタは、単一の取引パートナーのAS4 詳細を使用して設定されます。 フローページのAS4 コネクタ

必須の設定

AS4 設定詳細は取引パートナーから提供される必要があります。これらの値は取引パートナーと相互に合意するものですので、これらのフィールドにどのような値を期待しているかを理解するために、パートナーと明確にコミュニケーションを取るようにしてください。少なくとも、取引パートナーが提供しなければならない詳細には次が含まれます:
  • パーティ識別子
  • 送信されるAS4 メッセージの送信先URL またはエンドポイント
  • 暗号化用のパブリック証明書またはキー
  • アグリーメント
  • ビジネスアグリーメントの詳細
AS4 コネクタの設定タブConnection フィールドでCreate をクリックし、Configure Connection ページで次の必須値を指定します:
  • Party Identifier: 対象の取引パートナーに固有の、大文字と小文字を区別するパーティ識別子。
  • URL: 送信されるAS4 メッセージの送信先となる取引パートナーのパブリックエンドポイント。
  • Agreement: 交換を管理する共有AS4 アグリーメント。
  • Encryption Certificate: メッセージ送信時のAS4 暗号化に使用されるパブリックキー証明書。
AS4 のConfigure Connection ページ 残りの必須のビジネスアグリーメントの詳細を、コネクタの設定タブで指定します。これらのメタデータは、AS4 メッセージをどのように受信し解釈すべきかに関する情報を伝えます:
  • Service: メッセージを受け入れるビジネスプロセス。
  • Service Action: ビジネスプロセスで実行される操作またはアクティビティ。
  • From Role: メッセージの発信元となるパーティの役割。
  • To Role: メッセージの配信先となるパーティの役割。
AS4 コネクタの設定タブのビジネスアグリーメントの詳細

追加の設定

パートナーは、次のような追加要件を含めることができます:
  • 同期または非同期のレシート(設定タブで設定。指定がない場合は同期を希望していると想定します)
  • HTTPS サーバーへの接続用のTLS サーバー証明書(Configure Connection ページで設定)
  • メッセージプロパティ(AS4 ペイロードに含める追加のメタデータ。コネクタ設定タブの高度な設定タブで設定)
  • 特定の暗号化アルゴリズムまたは署名アルゴリズム(Configure Connection ページの高度な設定タブで設定)
  • 署名を検証するための(暗号化証明書に加えた)別個の証明書(Configure Connection ページのAdvanced タブで設定)
パートナーは、AS4 のやり取りで特定のプロファイルを使用することを要求する場合もあります。これは、Configure Connection ページのプロファイルドロップダウンを使用して設定します。これは、パートナー間の互換性を確保するために共有される設定を決定するのに役立ちます。プロファイルを設定すると、コネクタの関連する設定オプションが自動的に更新されます。利用可能なプロファイルは、StandardENTSOGe-SENSDBEWENTSOG V4eDelivery V2 です。 Encryption AlgorithmSignature AlgorithmSecurity Token FormatSSL Enabled Protocols など、いくつかの高度な設定の値としてAuto を選択できます。Auto に設定すると、コネクタは選択されたプロファイルに基づいて各設定の適切な値を自動的に選択しますが、必要に応じてこれらの値を手動で上書きできます。
接続を作成した後に編集するには、Settings > Connections で接続を見つけ、その名前をクリックしてEdit Connection ペインを開きます。接続はAS4 コネクタでは編集できません。

AS4 接続のテスト

取引パートナーの設定が完了したら、テストドキュメントを生成して送信接続をテストできます。AS4 コネクタのトランザクションタブに移動し、Add Files > Add Test Files を選択します。 オートメーションタブで送信のオートメーションが無効化されていない限り、コネクタはこれらのテストファイルを自動的に処理しようとします。設定済みのパートナーにテストファイルを送信する際に発生したエラーは、エラーに関するコンテキストと詳細を含むログファイルとともに、トランザクションタブに報告されます。接続の問題をさらに診断するには、高度な設定タブログレベルおよびログメッセージオプションを使用します。 正常に処理されたファイルは、緑色のSent ステータスで表示されます。テストファイルの送信に成功すれば、AS4 設定が正しいことが確認できます。

取引パートナーへのAS4 詳細の提供

取引パートナーが、AS4 コネクタを設定するためにあなたにAS4 設定詳細を提供しなければならないのと同様に、あなたもパートナーにAS4 設定詳細を提供する責任があります。 少なくとも、パートナーに次を提供する必要があります:
  • あなたのAS4 識別子
  • あなたのパブリックキーまたは暗号化証明書
  • あなたの受信URL
さらに、AS4 メッセージ内のアグリーメントおよびビジネスアグリーメントの詳細のメタデータは、相互に合意する必要があります。

AS4 メッセージの送受信

AS4 コネクタがAS4 接続を正常に確立すると、ファイルを取引パートナーと安全かつ確実に共有できます。 AS4 メッセージが のWeb サーバーに到着すると、アプリケーションはそのメッセージを特定のAS4 コネクタにルーティングしようとします。 はメッセージヘッダーのAS4 識別子を使用して、受信ファイルを、メッセージを送信したパートナー用に設定されたAS4 コネクタにルーティングします。アプリケーションが(AS4 識別子に基づいて)受信メッセージ用に設定されたAS4 コネクタを見つけられない場合、アプリケーションログにエラーが記録され、ファイルは受信されません。

トランザクションタブ

AS4 コネクタのトランザクションタブに(手動で、または別のコネクタから渡されて)配置されたファイルは、コネクタによって送信されるようスケジュールされます。オートメーションタブで送信のオートメーションが有効になっている場合(デフォルトで有効)、コネクタは処理するファイルがないかこの場所を自動的にポーリングします。あるいは、トランザクションタブから手動でファイルを送信することもできます。対象ファイルの左側にあるチェックボックスをクリックし、Send をクリックします。 Add Files > Upload Files を選択することで、トランザクションタブを使用してSend フォルダにファイルをアップロードできます。ファイルは、接続されたフローの一部である場合にもAS4 コネクタに到着します。 AS4 で受信したファイルが(AS4 識別子に基づいて)特定のAS4 コネクタにルーティングされると、ファイルはそのコネクタのトランザクションタブにも到着します。AS4 コネクタがフロー内の別のコネクタに接続されていない場合、受信したファイルはトランザクションタブに留まり、そこで確認できます。

フローの一部としての送受信

ほとんどのワークフローでは、ファイルはAS4 コネクタによって送信される前に、他の コネクタによって処理されます。フロー内でAS4 コネクタの に別のコネクタが接続されている場合、ファイルは自動的にAS4 コネクタのトランザクションタブに渡されます。 AS4 コネクタのフロー内に 後続の コネクタがある場合、ファイルはトランザクションタブに留まらず、代わりに次のコネクタに渡されます。

レシートの管理

ファイルを送信した後、設定タブEnable Receipt がチェックされている場合、AS4 コネクタは自動的にレシートを待ちます。レシートに否定的な応答が含まれている場合(例えば、パートナーが交換を拒否した場合)、コネクタは送信成功ではなくエラーを報告します。非同期レシートがリクエストされた場合、コネクタはパートナーがレシートを返すまで pending ステータスのままになります。 は、AS4 で交換するファイルが非常に大きい(500MB 以上)場合を除き、同期レシートの使用を推奨しています。 受信AS4 メッセージがレシートをリクエストする場合、AS4 コネクタは自動的にそれを生成して送信します。AS4 メッセージの受信中にエラーが発生した場合、このエラーは に記録され、取引パートナーに返されるレシートに含まれます。レシートの送信に必要な設定は受信AS4 メッセージに含まれており、AS4 コネクタで明示的に設定する必要はありません。