AS2快速开始


AS2连接器简单易用,只需要下面三个步骤就开始使用。

  1. 配置您的个人资料
  2. 配置一个交易伙伴
  3. 发送和接收文件

配置您的个人资料

首先要做的是配置自己的AS2资料。您的AS2资料中包含了许多许多重要的信息使交易伙伴可以识别您。选择Profile菜单项来开始配置您的个人资料。

选择Profile菜单项可以显示本地应用程序的配置资料。这里包含了所有在AS2数据传输中用来标识您身份的信息。对于不同的应用场景,AS2连接器提供了很多实用的选项,但是绝大多数都是可选的。为了快速开始,您需要配置下面四项。

  1. AS2 Identifier(AS2 标识)
  2. Email Address(电子邮件)
  3. Personal Certificate(个人证书)
  4. Receive URL(接收地址)

1) AS2 标识:用来在一个AS2数据传输中标识您的身份,就像电子邮件中的邮件地址。更多

  • 这里的AS2 标识是TestAS2,只是为了测试的目的。在实际使用中,请使用一个更有意义的名字,比如您公司的名称或者部门的名称。
  • 在AS2数据传输中,AS2标识会被包含在发出信息的信息头上。这样您的交易伙伴就可以使用这些信息加载您的资料,并处理请求。
  • 当交换配置资料信息时,AS2 标识会被告知给您的交易伙伴。

2) 电子邮件:有两个作用,一个作用是在AS2数据传输中请求MDN回执,另一个作用是当传输错误发生时,作为管理员来接收错误的通知。更多

  • 在默认的测试资料中使用的邮件地址是testas2@freeas2.com,这只是为了示例目的伪造的邮件地址。但是它可以使AS2数据传输中请求MDN回执。如果您希望在AS2连接器中接收通知邮件,请将它改为您的管理员邮件地址。

3) 个人证书:私有密钥证书可以用来签名发出的文件和解密接收到的文件。AS2连接器使用PKCS#12格式的私有密钥证书文件(后缀名为.pfx或.p12)。更多

  • 为了测试目的的私有密钥证书test.pfx文件包含在安装包中。因为这个证书包含在所有下载的安装包中,所以它并不安全。请在实际的使用中,更换为您自己的证书。您可以选择导入一个已有的证书,或者创建一个自签名的证书。
  • 如果您通过应用程序创建了自己的个人证书,一个.cer后缀的文件会被同时创建在包含.pfx个人证书文件的目录中。请将这个.cer后缀的公有密钥证书文件发送给交易伙伴。

4) 接收地址:定义接收AS2数据通信的URL地址。这个设置依赖于AS2连接器是否托管在IIS或者运行在安装包自带的独立服务程序。更多

  • 您提供给交易伙伴的数据接收URL地址符合通用的URL定义。在决定URL地址前,请确认服务器的地址、监听端口以及是否使用HTTP或者HTTPS连接。举例来说,当AS2应用程序第一次安装时,会默认监听8181端口并使用HTTP连接。如果您从本地连接,可以使用localhost作为服务器地址,这样数据接收的URL就是http://localhost:8181/as2connector/pub/ReceiveFile.rsb。
  • 当然您可以使用以上地址从本机访问文件接收页面,但是这个地址对于其他机器并不能工作。您需要将localhost更换为本机的域名或者IP地址。如果您的域名是 www.mycompany.com 或者IP地址是aaa.bbb.ccc.ddd,请使用 http://www.mycompany.com:8181/as2connector/pub/ReceiveFile.rsb 或者 http://aaa.bbb.ccc.ddd:8181/as2connector/pub/ReceiveFile.rsb 作为数据接收的URL地址。
  • 如果您更换了托管AS2连接器的服务器,请务必通知您的交易伙伴更新到新的URL地址。
  • 您需要向交易伙伴提供这个信息,这样他们可以从外部通过浏览器测试这个URL地址是否可以访问。


配置一个交易伙伴

通常情况下,您的交易伙伴会提供连接所需的各种配置信息。请点击Partners菜单项来查看配置好的交易伙伴列表或者新增一个交易伙伴。

在页面左侧边栏中可以选择增加交易伙伴或者一个已有的交易伙伴,然后通过Settings标签页面就可以设置这个交易伙伴的各项配置信息。就像个人资料一样,许多的设置都是可选的。对许每一位交易伙伴,下面这些内容都是必须填写的。

  1. Partner AS2 Identifier(伙伴AS2标识)
  2. Organization Name(组织名称)
  3. Partner URL(伙伴地址)
  4. Certificate(证书)

1) 伙伴AS2标识:用来在一个AS2数据传输中标识一位交易伙伴,就像您的AS2标识用来标识自己。您的交易伙伴会在配置资料信息中提供他的AS2标识。更多

  • 在测试配置中伙伴AS2标识为TestAS2指向自己,这和个人资料中的AS2标识一致。当发出的请求送达交易伙伴时,在信息头中会指明这个数据传输接收者的AS2标识应该是TestAS2。
  • 如果您希望创建一个新的测试配置发送文件给自己,请确保这里配置的AS2标识和个人资料中的AS2标识保持一致。
  • 请注意这个AS2标识是大小写敏感的,当配置新的交易伙伴时务必确保大小写拼写正确。

2) 组织名称:您的交易伙伴并不会提供这个输入内容,他可以被设置为任何值。由于交易伙伴的AS2标识可能会难以被识别,所以这个输入框可以让您给每一个交易伙伴起一个更加容易识别的名字。更多

  • 在测试案例中,组织名称被定义为Test AS2 Partner。这个名字就会被显示在交易伙伴配置页面的左侧边栏中。如果您希望创建一个新的测试配置发送文件给自己,这里可以输入一个容易识别的名字比如Self Test。

3) 伙伴地址:您的交易伙伴通过这里设置的交易伙伴URL地址接收AS2数据传输。每一个交易伙伴必须拥有一个唯一的值。更多

  • 在默认安装的Test AS2 Partner测试交易伙伴中,您会发现这个地址http://localhost:8181/as2connector/pub/ReceiveFile.rsb和个人配置资料中的接收地址一致。即使您修改了个人资料配置中的一些设置,这里的地址也不需要发生变化,除非AS2连接器被托管到其他的服务器上。这个默认的交易伙伴可以作为快速测试使用。
  • 当新增一位交易伙伴的URL地址时,通常可以使用浏览器打开这个地址进行快速测试,确保URL地址是可以访问的。这是一个很好的测试网络连接的方法。
  • 在很多情况下,您的交易伙伴会提供多个URL地址。一个是接收数据的URL地址,另一个是接收异步MDN回执的URL地址。这里您只需要关心接收数据的URL地址。如果需要另一个不同的URL地址接收MDN回执,它会被包含在AS2通信的数据传输中,AS2连接器会自动的从传输数据中读取。


4) 证书:最后,为每一位交易伙伴需要配置一个或者多个数字证书。每一位交易伙伴都会提供和他的AS2应用程序通信的证书。AS2连接器可以接受X.509格式的公有密钥证书(文件后缀名为.cer、.der或者.pem)。更多

  • 在默认安装的测试交易伙伴中,test.cer公有密钥证书文件被设置为加密用证书,这个证书和个人配置资料中的test.pfx私有密钥证书文件配对。因为这个证书文件被设置为加密用证书,它同时会被AS2应用程序用来加密和验证签名。
  • 为了在应用程序中配置证书文件,请在这里输入服务器上的文件路径或者使用Import Certificate按钮来上传一个证书文件。如果您想使用一个证书生成工具来重新配置默认安装的Test AS2 Partner交易伙伴,请在这里使用生成的公有密钥证书文件,而不是私有密钥证书,通常文件后缀名为.cer。
  • 如果您的交易伙伴只提供了一个数字证书,请将它设置为加密用证书,AS2连接器会自动在其他的场景中使用它。
  • 请和您的交易伙伴反复确认每一个证书的用途。通常情况下,您的交易伙伴会从一个商用的凭证管理中心(Certificate Authority)获得证书,并提供给您证书信任链上的所有证书文件。在这里,您只需要设置证书信任链最末端的证书。


发送和接收文件

配置完成您的个人资料和交易伙伴后,就可以开始通过互联网发送和接收文件了。每一位配置好的交易伙伴都有一个 IncomingOutgoing 标签页来显示接收到的和可以发送的文件列表。如果您还没有配置交易伙伴,可以使用默认安装的Test AS2 Partner测试交易伙伴。


接收的文件
每一位交易伙伴的默认标签页就是接收文件的页面。这个页面会显示从指定的交易伙伴接收到的所有文件。


发送的文件
您可以在这个标签页面选择并发送文件到指定的交易伙伴。需要发送的文件应该被放置在这个交易伙伴名字下的磁盘目录中。当手动发送成功后,您可以配置应用程序自动发送所有磁盘目录中的文件。当您第一次配置一位交易伙伴资料时,可以通过以下步骤测试AS2数据传输是否成功。更多

  • 选择Create Test Files按钮来创建一系列用于测试AS2传输的文件。
  • 选择新创建文件左侧的复选框,然后选择Send按钮发送测试文件。


消息交换
向交易伙伴发送文件后,您可以在文件列表上方看到传输的状态。如果文件传输成功,可以看到绿色的成功状态消息。否则,会看到红色的包含详细原因的错误消息。文件列表也会被更新并包含最新的传输日志内容。更多

  • 展开发送的文件行可以看到最新的传输日志。
  • 如果您使用默认安装的Test AS2 Partner测试交易伙伴,发出的文件也可以在接收文件标签页看到。


发送和接收的文件是单独运行的,您需要确认发送和接收文件都可以成功运行。

  • 展开接收的文件行可以查看和该文件相关的传输日志信息。
  • 如果您选择文件连接,就可以直接从浏览器下载这个文件。