示例：将 Web 用户标识映射到 MQMD 用户标识

将文件上载提交到 WebSphere® MQ Managed File Transfer Web 网关时， Web 网关会确定要用于传输的 IBM® WebSphere MQ 消息描述符 (MQMD) 用户标识。 您可以使用 Web 网关来定义 Web 用户标识和 MQMD 用户标识之间的映射集。

关于本任务

将 HTTP 请求提交到 Web 网关，在请求的正文中使用 XML 将 Web 用户标识映射到 MQMD 用户标识。 有关 XML 格式的更多信息，请参阅 用于将 Web 用户标识映射到 MQMD 用户标识的 XML 格式。 成功的请求将返回 HTTP 状态码 200。

要创建映射集，您的用户帐户必须与 wmqfte-admin 角色关联。 有关 Web 网关的安全角色的更多信息，请参阅 Web 网关的用户角色。

如果您具有安全角色 wmqfte-admin，那么还可以使用管理控制台将 Web 用户标识映射到 MQMD 用户标识。 有关更多信息，请参阅 Web Gateway 管理控制台。

以下步骤描述了如何提交创建映射集的 POST 请求。 在本例中，托管 Web 网关的服务器是 example.com，并且提交 HTTP 请求使用的是自身标识为 mozilla 的 Web 浏览器。 该请求包含两个用户的信息，这两个用户的 Web 用户标识分别为 jim 和 rachel。

1. 创建以下格式的 HTTP 请求：

   POST HTTP/1.1 /admin/user
   Host: example.com
   User-Agent: mozilla
   Content-Type: application/xml
   
   <?xml version="1.0" encoding="UTF-8"?>
   <users>
     <user>
       <userID>jim</userID>
       <mqmdUserID>mqjim</mqmdUserID>
     </user>
     <user>
       <userID>rachel</userID>
       <mqmdUserID>mqrachel</mqmdUserID>
     </user>
   </users>

2. 向 Web 网关提交该请求。 Web 网关将返回以下格式的 HTTP 响应：

   HTTP/1.1 200 OK
   Server: WAS/7.0
   Content-Length: 0

   无效请求将返回 HTTP 错误代码和 WebSphere MQ Managed File Transfer 错误信息。 要确定错误原因，请参阅 对 Web 网关进行故障诊断。

结果

当用户 jim 或 rachel 中的某一位通过 Web 网关提交文件上载请求时，传输将使用相应的 MQMD 用户标识 mqjim 或 mqrachel。 如果未定义 MQMD 用户标识的用户提交了文件上载请求，那么将使用 defaultMQMDUserID 参数的值。 在这种情况下，如果 Web 网关部署期间未定义该参数，那么传输将失败。 有关更多信息，请参阅 部署 Web Gateway with WebSphere Application Server Version 7.0 和 准备部署 Web Gateway with WebSphere Application Server Community Edition。