WSO2 EI与Developer Studio配置ESB代理对接HTTP基础认证外部服务

问题描述 #

我正在使用WSO2 EI 6.3.0和WSO2 Developer Studio 3.8.0开发包含Proxy Service的ESB Project。该Proxy Service为透传服务：接收Web应用请求并转发至SOAP Web Service，获取响应后返回给Web应用。此前配置运行正常，直到遇到带HTTP基础认证的外部Web服务端点。我手动编写了如下可正常运行的Proxy Service XML配置：

<?xml version="1.0" encoding="UTF-8"?>
<proxy name="ProxyWithBasicAuth" startOnLoad="true" trace="disable" transports="https" xmlns="http://ws.apache.org/ns/synapse">
  <target>
    <endpoint name="endpoint_urn_uuid_xxxxxxxx-yyyy-zzzz-1111-234567892345">
      <address trace="disable" uri="https://here.goes.the.uri.of.the.ws.endpoint"/>
    </endpoint>
    <inSequence>
      <property value="this_is_the_username" name="username" scope="default" type="STRING"/>
      <property value="this_is_the_password" name="password" scope="default" type="STRING"/>
      <property expression="fn:concat($ctx:username,':',$ctx:password)" name="credentials" scope="default" type="STRING"/>
      <property expression="fn:concat('Basic ', base64Encode($ctx:credentials))" name="Authorization" scope="transport" type="STRING" xmlns:ns="http://org.apache.synapse/xsd"/>
    </inSequence>
    <outSequence>
      <send/>
    </outSequence>
    <faultSequence/>
  </target>
</proxy>

现在有两个疑问：

1. 这种ESB代理对接外部服务HTTP基础认证的配置方式是否正确？
2. 是否存在可可视化完成该配置的GUI拖拽元素？

注：仅关注ESB代理与外部Web服务间的认证，不涉及客户端与ESB代理的认证。

回答 #

1. 你的手动配置是完全正确的 #

你当前的配置逻辑完全符合WSO2 EI处理HTTP Basic Auth的标准方式：

• 通过property Mediator在inSequence中逐步构建Basic Auth的Authorization头，逻辑清晰且无冗余
• 将用户名和密码拼接后进行Base64编码，最终设置到transport作用域的Authorization属性——这个作用域的属性会自动被添加到出站请求的HTTP头中，完美适配外部服务的认证要求
• 作为透传服务，你的outSequence仅保留<send/>是合理的，不需要额外修改响应内容，完全满足透传需求

从你描述的"可正常运行"来看，也验证了这个配置的正确性，是没问题的。

2. 存在可视化拖拽的GUI配置方式 #

在WSO2 Developer Studio 3.8.0中，你可以通过两种可视化方式实现相同的认证逻辑，无需手动编写XML：

方式一：使用Header Mediator直接生成认证头

1. 打开Proxy Service的可视化编辑器（双击Proxy文件即可进入可视化界面）
2. 在左侧Mediator面板中找到Header Mediator，拖拽到inSequence的画布区域
3. 双击Header Mediator打开配置窗口：
   • 设置Header Name为Authorization
   • 在Header Value中输入表达式：fn:concat('Basic ', base64Encode(fn:concat('your_username',':','your_password')))
   • 在Scope下拉框中选择transport
4. 保存配置后，Dev Studio会自动生成对应的XML代码，效果和你手动编写的一致

方式二：通过Endpoint的Security标签配置（更推荐）

这种方式将认证信息与Endpoint绑定，更利于后续维护：

1. 在Developer Studio中打开你的Endpoint文件（或右键新建一个Address Endpoint）
2. 切换到Security标签页
3. 勾选Enable Security，然后选择Basic Authentication类型
4. 填入对应的用户名和密码，点击保存
5. 在Proxy Service的可视化编辑器中，将这个配置好的Endpoint关联到Target的Endpoint选项中

这种方式的优势是认证信息集中管理，后续修改用户名密码时，只需修改Endpoint的配置，无需改动Proxy的序列逻辑，更符合模块化设计原则。

内容的提问来源于stack exchange，提问作者Roger 71