MuleSoft ESB调用SOAP API：用户名、密码及API KEY配置位置咨询

嘿，刚上手MuleSoft ESB就碰到SOAP API认证的问题，太正常啦！我来给你一步步捋清楚用户名密码、API Key该在哪配置，帮你搞定连通测试～

首先得确认你的SOAP API要求哪种认证方式——是基本认证（用户名+密码）、API Key认证，还是两者结合？不同方式的配置位置和步骤略有不同，下面分情况说：

一、配置用户名密码（Basic Authentication） #

方式1：直接在HTTP Request组件里配置 #

这是最直观的方法：

• 找到你的HTTP Request组件，双击打开配置窗口
• 切换到「Authorization」标签页
• 认证类型选择「Basic Auth」，然后输入你的用户名和密码
• 勾选「Enable」激活这个配置就好
• 💡 小提示：如果是Mule 4及以上版本，建议把用户名密码存在mule.yaml配置文件里，比如：

  soap:
    api:
      username: "your-username"
      password: "your-password"
  

  然后在HTTP Request里用${soap.api.username}和${soap.api.password}引用，避免硬编码敏感信息。

方式2：用Transform Message手动添加请求头 #

如果需要更灵活的控制（比如动态生成认证信息），可以在HTTP Request前加一个Transform Message组件：

• 在组件里添加Authorization请求头，值是Basic 加上「用户名:密码」的Base64编码
• 举个DataWeave 2.0的例子：

  output application/json
  ---
  headers: {
      "Authorization": "Basic " ++ dw::core::Binaries::base64("${soap.api.username}:${soap.api.password}")
  }
  

二、配置API Key #

API Key的配置要看API要求的传递方式，常见的有两种：

方式1：放在请求头里 #

• 打开HTTP Request组件的「Headers」标签页，添加一个键值对，比如键是X-API-Key（具体看API文档要求的键名），值是你的API Key
• 同样推荐用配置文件引用：${soap.api.key}，在mule.yaml里定义：

  soap:
    api:
      key: "your-api-key"
  

• 或者用Transform Message组件添加：

  output application/json
  ---
  headers: {
      "X-API-Key": "${soap.api.key}"
  }
  

方式2：作为URL查询参数 #

如果API要求把API Key放在URL的查询参数里（比如https://api.example.com/soap?apiKey=xxx）：

• 在HTTP Request的「Query Parameters」标签页添加参数，键是apiKey（按API要求的键名来），值是你的API Key
• 同样建议用配置文件引用，不要直接写在URL里。

三、测试连通性的小技巧 #

配置完之后，怎么确认能不能连通呢？

• 在HTTP Request组件后面加一个Logger组件，把payload或者attributes打印出来，看看有没有返回正常的SOAP响应
• 开启Mule的Debug模式，一步步调试，检查请求头里有没有带上正确的认证信息
• 如果遇到401 Unauthorized错误，先核对认证信息是否正确，再确认API要求的认证方式是不是你配置的那种

额外提醒 #

• 永远不要在代码里硬编码敏感信息（用户名、密码、API Key），用Mule的配置文件或者Vault存储更安全
• 如果你的SOAP API要求WS-Security认证（比如UsernameToken），那别用普通的HTTP Request组件，改用Mule的「SOAP Client」组件——在它的配置里有专门的WS-Security选项，可以直接设置用户名和密码

内容的提问来源于stack exchange，提问作者Hatem Ahmed