AS2 メッセージ
このトピックでは、AS2 メッセージの構造、コンテキスト プロパティ、ヘッダーなど、AS2 メッセージについて説明します。
AS2 メッセージの構造
BizTalk Serverでは、AS2 メッセージは RFC 4130 に従って構造化されています。"HTTP を使用した MIME ベースの Secure Peer-to-Peer Business Data Interchange,Applicability Statement 2 (AS2) (https://go.microsoft.com/fwlink/?LinkID=184212)。
AS2 メッセージの基本構造は、AS2 固有のヘッダーが追加された HTTP メッセージ内の MIME 形式で構成されます。 HTTP、AS2、および MIME の各ヘッダーの下のメッセージの性質は、次のメッセージの種類によって異なります。
署名済み – メッセージが署名されている場合は、ドキュメント ペイロードの周囲に署名ラッパーが追加されます。
圧縮 – メッセージが圧縮されている場合、ドキュメントと署名ペイロードの周囲に圧縮ラッパーが追加されます。
Encrypted – メッセージが暗号化されている場合、ドキュメント、署名、および圧縮ペイロードの周囲に暗号化ラッパーが追加されます。
暗号化、署名、および圧縮に基づいた AS2 メッセージのメッセージ構造を次の表に示します。
| AS2 メッセージのオプション | メッセージ構造 |
|---|---|
| - 圧縮なし - 暗号化なし - 署名なし |
HTTP, AS2, MIME Header EDI/XML Payload |
| -圧縮 - 暗号化なし - 署名なし |
HTTP, AS2, MIME Header PKCS7-MIME Compression EDI/XML Payload (compressed) |
| -署名 - 圧縮なし - 暗号化なし |
HTTP, AS2, MIME Header MIME Security Multipart (signed) EDI/XML Payload CMS-PKCS7 Signature |
| -署名 -圧縮 - 暗号化なし |
HTTP, AS2, MIME Header PKCS7-MIME Compression MIME Security Multipart (signed)(compressed) EDI/XML Payload (compressed) CMS-PKCS7 Signature (compressed) |
| - Encrypted - 圧縮なし - 署名なし |
HTTP, AS2, MIME Header CMS-PKCS7 MIME Encryption EDI/XML Payload (encrypted) |
| -圧縮 - Encrypted - 署名なし |
HTTP, AS2, MIME Header CMS-PKCS7 MIME Encryption PKCS7-MIME Compression (encrypted) EDI/XML Payload (compressed)(encrypted) |
| - Encrypted -署名 - 圧縮なし |
HTTP, AS2, MIME Header CMS-PKCS7 MIME Encryption MIME Security Multiparts (signed)(encrypted) EDI/XML Payload (encrypted) CMS-PKCS7 Signature (encrypted) |
| -圧縮 - Encrypted -署名 |
HTTP, AS2, MIME Header CMS-PKCS7 MIME Encryption PKCS7-MIME Compression (encrypted) MIME Security Multiparts (signed)(compressed)(encrypted) EDI/XML Payload (compressed)(encrypted) CMS-PKCS7 Signature (compressed)(encrypted) |
ドキュメント ペイロードが複数のドキュメントで構成されている場合、これらは RFC 2387 に記述されているように、Multipart/Related MIME エンベロープ内に格納されます。 Content-Disposition MIME ヘッダーは、メッセージ内の各ドキュメントのファイル名を指定するために使用できます。
次の表に、メッセージの暗号化、署名、および圧縮の各オプションに基づいた、複数の添付ファイルを含む AS2 メッセージのメッセージ構造を示します。
| AS2 メッセージのオプション | メッセージ構造 |
|---|---|
| - 圧縮なし - 暗号化なし - 署名なし |
HTTP, AS2, MIME Header MIME Multipart/related EDI/XML Payloads |
| -圧縮 - 暗号化なし - 署名なし |
HTTP, AS2, MIME Header PKCS7-MIME Compression MIME Multipart/related EDI/XML Payload (compressed) |
| -署名 - 圧縮なし - 署名なし |
HTTP, AS2, MIME Header MIME Security Multipart (signed) MIME Multipart/related EDI/XML Payload CMS-PKCS7 Signature |
| -圧縮 -署名 - 暗号化なし |
HTTP, AS2, MIME Header PKCS7-MIME Compression MIME Security Multipart (signed)(compressed) MIME Multipart/related (compressed) EDI/XML Payload (compressed) CMS-PKCS7 Signature (compressed) |
| - 暗号化 - 圧縮なし - 署名なし |
HTTP, AS2, MIME Header CMS-PKCS7 MIME Encryption MIME Multipart/related (encrypted) EDI/XML Payload (encrypted) |
| -圧縮 - Encrypted - 署名なし |
HTTP, AS2, MIME Header CMS-PKCS7 MIME Encryption PKCS7-MIME Compression (encrypted) MIME Multipart/related EDI/XML Payload (compressed)(encrypted) |
| - Encrypted -署名 - 圧縮なし |
HTTP, AS2, MIME Header CMS-PKCS7 MIME Encryption MIME Security Multiparts (signed)(encrypted) MIME Multipart/related EDI/XML Payload (encrypted) CMS-PKCS7 Signature (encrypted) |
| -圧縮 - Encrypted -署名 |
HTTP, AS2, MIME Header CMS-PKCS7 MIME Encryption PKCS7-MIME Compression (encrypted) MIME Security Multiparts (signed)(compressed)(encrypted) MIME Multipart/related EDI/XML Payload (compressed)(encrypted) CMS-PKCS7 Signature (compressed)(encrypted) |
AS2 のコンテキスト プロパティ
AS2 メッセージの処理に使用されるコンテキスト プロパティには、昇格できるプロパティや非公開のプロパティが含まれますが、これらのプロパティは中断されたメッセージや追跡メッセージで表示できます。 AS2 コンテキスト プロパティの一覧については、「 AS2 コンテキスト プロパティ」を参照してください。
AS2 のヘッダー
AS2 メッセージの AS2 ヘッダーは受信側パーティと送信元パーティを記述し、受信側パーティが MDN 応答を送信するために必要な情報を提供します。 受信側は、AS2 アグリーメントでメッセージ ヘッダー プロパティではなく検証と MDN の使用契約設定 が選択されていない限り、または情報が契約プロパティで使用できない場合は、MDN ヘッダーを使用します。
AS2-From ヘッダー、AS2-To ヘッダー、および MessageID コンテキスト プロパティは、AS2 メッセージを一意に記述します。 これらは、MDN を応答対象の AS2 メッセージに関連付けるためにも使用されます。
これらのヘッダーを次の表に示します (アルファベット順)。
| AS2 ヘッダー | 必須/省略可能 | 値 |
|---|---|---|
| AS2-Version | Optional | "1.1" |
| AS2-From | 必須 | AS2 メッセージを送信した会社の名前。 値: 文字列、印刷可能な ASCII、長さ 1 ～ 128 文字 |
| AS2-To | 必須 | AS2 メッセージが送信される会社の名前。 値: 文字列、印刷可能な ASCII、長さ 1 ～ 128 文字 |
| AS2-Text | 必須 | テキスト (メッセージのこのヘッダー) 値: 文字列、印刷可能な ASCII、長さ 1 ～ 128 文字 |
| Disposition-Notification-To | 必須 | 存在する場合は、返される MDN に対する要求として機能します。 receipt-delivery-option ヘッダーを伴う場合は、非同期 MDN に対する要求になります。 それ以外の場合は、同期 MDN に対する要求になります。 存在しない場合、MDN は必須ではありません。 値: 必要なメール アドレス。 ただし、MDN を返す位置の識別にメール アドレスを使用することはできません。 受信側アプリケーションはメール アドレスを無視し、アドレス構文の違反を示すエラーを表示しません。 |
| EDIINT-Features | 必須 | 発信元システムがサポートしている機能を示します。 BizTalk ではこのヘッダーを使用して、複数の添付ファイルのサポートを示します。 値: "MA" |
| Receipt-Delivery-Option | 必須 | MDN が送信される URL を示します。 Receipt-Delivery-Option が存在する場合、Disposition-notification-to は非同期 MDN に対する要求として機能します。 Receipt-Delivery-Option は常に Disposition-Notification-To を伴う必要があります。 Receipt-Delivery-Option が存在せず、Disposition-notification-to が存在する場合、Disposition-notification-to は同期 MDN に対する要求として機能します。 値: URL 文字列 |
| signed-receipt-protocol (Disposition-Notification-Options 内) |
省略可能 | "pcks7-signature" に設定した場合は、受信側パーティから署名付きの確認メッセージを要求するために使用され、署名付きの受信確認が要求側に返される形式を示します。 値: 省略可能、pcks7-signature |
| signed-receipt-micalg (Disposition-Notification-Options 内) |
省略可能 | 確認メッセージに署名する際に要求側によって優先的に使用される MIC アルゴリズムの一覧です。 受信側パーティは、左から順に MIC アルゴリズムの一覧に従う必要があります。 値: 省略可能、MD5、または SHA1 |
受信メッセージでは、AS2EdiReceive および AS2Receive 受信パイプラインは、AS2 アグリーメント プロパティの Signed Receipt Protocol および Signed Receipt MIC Algorithm の値を検証します。
送信 AS2 メッセージでは、AS2EdiSend および AS2Send 送信パイプラインは、AS2 アグリーメントに入力された値から前の AS2 ヘッダーを設定します (ただし、1.1 としてハードコーディングされている AS2-Version を除きます)。
MDN に対する要求
受信側パーティが MDN (Message Disposition Notification) を返す要求は、送信されるメッセージに次のヘッダーを配置することで行われます。
MDN-request-header = "Disposition-notification-to" ":" メール アドレス
MDN を返す位置の識別にはメール アドレスは使用されません。 受信側アプリケーションは値を無視し、アドレス構文の違反に関するエラーを送信しません。