SSIS调用REST API指南:使用基本身份验证和Base64编码授权头

作者:API传播员 · 2025-10-10 · 阅读时间:4分钟
本文详细介绍了在SSIS中通过基本身份验证调用REST API的两种方法:自动使用ZS-HTTP连接管理器和手动设置Base64编码的HTTP授权头。文章还展示了如何在SSIS REST API任务和JSON/XML源中传递基本凭证,以及如何通过Fiddler验证授权头的正确性。

一. 在HTTP Web请求中传递基本凭证

在HTTP标准中,**基本身份验证(Basic Authentication)**是一种简单而有效的方式,用于传递凭证(用户ID和密码)。在SSIS中,您可以通过以下两种方式实现:

  1. 自动方法:使用ZS-HTTP连接管理器自动生成Base64编码的授权头。
  2. 手动方法:手动提供Base64编码的用户ID和密码作为授权头。

二. 自动方法 – 使用ZS-HTTP连接管理器

ZS-HTTP连接管理器提供便捷方式,可以自动生成Base64编码的授权头。以下介绍在不同任务和组件中使用该方法的详细步骤。

1. 在SSIS REST API任务中传递基本凭证

a. 使用SSIS REST API任务(通过连接管理器传递凭证)

最简单的方式是通过HTTP连接管理器传递凭证。在REST API任务中:

  1. 选择“来自连接的URL”作为访问模式
  2. 在连接管理器中指定用户ID密码

系统会自动生成Base64编码的HTTP授权头,如下图所示:

HTTP连接管理器生成的Base64编码授权头

您还可以使用调试工具(如Fiddler)分析Web请求,验证授权头是否正确生成:

通过Fiddler查看授权头


2. 使用SSIS JSON/XML源(通过连接管理器传递凭证)

在JSON源和XML源中,同样可以使用HTTP连接管理器传递凭证:

  1. 设置访问模式为“文件路径或Web URL”
  2. 勾选“使用凭证”选项
  3. 从下拉列表中选择相应的HTTP连接管理器

该方法简化了凭证管理,并保证请求安全。


三. 手动方法 – 提供Base64编码的用户ID/密码

如果需要更灵活的控制,可以选择手动方法,将Base64编码字符串作为授权头传递。JSON源、XML源和REST API任务均支持此功能。

1. 手动设置Base64编码的授权头

在HTTP连接管理器中设置用户ID和密码效果与手动设置相同。可通过以下格式在变量中指定Base64编码:

{{User::varUserAndPassword**,BASE64ENC**}}

下面截图展示了在SSIS JSON源任务中传递Base64编码授权头的示例:

SSIS JSON源任务 - 传递Base64编码的授权头


2. 示例:SSIS JSON源任务操作步骤

在SSIS JSON源任务中实现Base64编码授权头:

  1. 启用“使用凭证”选项
  2. 提供Base64编码的用户ID和密码
  3. 验证授权头是否正确生成

截图示例如下:

SSIS JSON源任务 - 示例


四. 总结

本文介绍了如何在SSIS中使用基本身份验证调用REST API。无论是:

  • 自动方法:通过ZS-HTTP连接管理器生成Base64编码授权头
  • 手动方法:自行提供Base64编码的用户ID和密码

都可以轻松实现HTTP授权头的传递。根据需求选择合适方法,能帮助您更高效地集成和调用REST API。

原文链接: https://zappysys.com/blog/how-to-set-base64-encoded-authorization-header-for-http-web-request/