SOAtest 智能 API 测试生成器使您能够捕获通讯报文，并通过与 web 应用程序的交互创建 API 测试。在本章节中：

概要

SOAtest 智能 API 测试生成器包括以下组件：

智能 API 测试生成器连接到 SOAtest 桌面或服务器，这使得您能够配置并运行测试。

浏览器扩展需求

许可证

您可以免费下载并安装智能 API 测试生成器，但是需要 SOAtest 中的高级测试生成许可证功能的有效许可证才能记录通讯报文并生成测试。可使用以下许可证选项：

有关其他许可证信息，请联系 Parasoft 技术团队。 

安装指南

运行 Windows 上用于安装的 parasoft_soatest_smart_api_test_generator_<version>_win32.exe 文件，或 Mac OS 上用于安装的 parasoft_soatest_smart_api_test_generator_<version>_macos.dmg。如果 Mac OS 因为安全原因，不可运行 .dmg，则右键单击文件并选择 Open With> Installer 

按照 OS 系统的安装向导完成安装。如果您在使用安装程序时遇到了问题，请查阅 Manual Installation    

在 Windows 安装期间，将提示您将 Parasoft SOAtest Web 代理安装为 Windows 服务。这使您能够使用 Windows 控制面板下的 services 控件启用和停止代理，以及使用 Windows 启动菜单中的 SOAtest Web 代理控件（请查阅 Starting the Web Proxy）。还可以通过运行可执行 JAR 文件手动启动代理（请查阅 Manually Starting the Web Proxy）。

Windows 和 Mac 安装程序也将提示您从 Google Chrome 商店（窗口显示）中安装 SOAtest 通讯报文记录仪。如果禁止访问 Google Chrome 商店或在使用安装程序时遇到问题，请查阅 Manual Installation    

如果安装程序没有检测到 Parasoft 根证书颁发机构，它将提示您对其进行安装。要求 CA 记录 HTTPS 上的通讯报文。CA 通常与 SOAtest/Virtualize 桌面应用程序一起安装。您还可以手动添加 CA（请查阅 Installing the Parasoft Root Certificate Authority）。

在 Mac OS 上安装期间，您可以在登录计算机时启用 web 代理自动启动。

通过 System Preferences>  Users & Groups> Login Items 设置您可以在安装后启用或禁用 web 代理的自动启动。

您可以单击挂锁图标查看 Apple 开发人员 ID 证书颁发机构（CA）。证书识别 Parasoft 为 Apple services 受信任的软件源。

安装程序完成后，在启动 Chrome 时，将提示您启动扩展。 

此操作将卸载扩展，并将其放入黑名单中。因此，您将无法自动安装或更新扩展。为了修复该扩展的自动安装，您将需要卸载并重装 Chrome。

在安装完成时，安装程序将提示您启动 Parasoft SOAtest Web 代理。如果您选择在不需启动代理的情况下完成安装，请参阅有关按需启动代理的说明 Starting the Web Proxy  如果代理正在运行，请查阅 Using the Browser Extension 以获得下一步操作。在使用扩展之前，必须运行 SOAtest 服务器。

卸载浏览器扩展和代理

使用控制面板中常规的 Windows 卸载程序来完成卸载该工具。Mac OS 安装程序附带一个 卸载 SOAtest 智能 API 测试生成器 实用程序，如果您希望完全卸载该工具，可以运行该实用程序。Mac OS 实用程序将位于您的 Applications/Parasoft 文件夹中。

手动安装

以下说明描述了如果不能使用 Windows 安装程序，如何手动安装 SOAtest 智能 API 测试生成器组件。

  1. 下载 TrafficRecordingExtension.zip 文件夹（联系 Parasoft 技术团队）。
  2. 将压缩文件夹解压到计算机上的任何位置。运行 Parasoft SOAtest Web 代理不需要其他安装。
  3. 打开 Chrome 浏览器窗口并打开扩展页面（chrome://extensions）。
  4. 启用 Developer mode 选项并单击 Load unpacked extension。
  5. 导航到 [TrafficRecordingExtension_INSTALL]/chrome-extension 目录并选择安装扩展。该工具将可在浏览器栏中使用。

使用扩展之前，必须运行 Parasoft SOAtest Web 代理和 SOAtest 服务器（请查阅 Starting the Web Proxy）。如果正在运行 SOAtest 服务器，并且使用默认配置启动代理，则可以开始使用扩展来记录通讯报文。如果这些组件正在运行，请查阅 SOAtest 智能 API 测试生成器使用说明  一旦安装了浏览器扩展，还需要配置到 Parasoft SOAtest Web 代理和 SOAtest 服务器的连接。 

安装 Parasoft 根证书颁发机构

Parasoft 根证书颁发机构必须安装位一个受信任的证书，以启用 HTTPS 通讯报文的记录。如果没有安装证书颁发机构，浏览器将不认为连接是安全的，并可能拒绝允许连接。

Windows

通常通过 SOAtest Windows 安装程序和 SOAtest 智能 API 测试生成器安装程序自动安装 Parasoft 根证书颁发机构。如果有必要，您还可以使用 -installcertificate 选项运行 soatestcli 进行手动安装。例如：

soatestcli -installcertificate

如果本地机器上没有安装 SOAtest，那您可以手动将证书添加到 Chrome 上。

  1. 打开 Chrome 设置页面 (chrome://settings) 并展开 Advanced 部分。
  2. 单击隐私安全部分中的 Manage certificates  
  3. 单击证书对话框中的 Trusted Root Certification Authorities 标签。  
  4. 单击 Import ，然后在证书‘导入’向导打开时单击‘下一步’。 
  5. 浏览到 [TrafficRecordingExtension_INSTALL]/parasoft.cer 文件，然后单击 Next
  6. 验证向导是否将证书放在受信任的根证书颁发机构文件夹中，然后单击 Next
  7. 单击 Finish ，如果出现提示，请确认要添加 Parasoft 根证书颁发机构。

Mac OS 

  1. 打开 Chrome 设置页面 (chrome://settings) 并展开 Advanced 部分。
  2. 单击隐私安全部分中的 Manage certificates密钥链访问应用程序将打开。 
  3. 选择密钥链下的 login ，并选择类别下的 Certificates 
  4. 选择 File> Import items 并导航到 [TrafficRecordingExtension_INSTALL] 目录中的 parasoft.cer。
  5. 右键单击出现的 Parasoft 根证书颁发机构，并选择 Get Info
  6. 展开信任中心部分，并从 When using this certificate 下拉菜单中选择 Always Trust 
  7. 提示保存配置时，输入您的凭证。

启动 Web 代理

如果将 Parasoft Web 代理安装为 Windows 服务，则可以使用 SOAtest Web 代理控件启动和停止代理。 

  1. 从 Windows 开始菜单中选择 SOAtest Web Proxy 或双击桌面图标（如果安装期间选择这个选项）
  2. 单击 General 选项卡中的 Start 

默认情况下，将在端口 40090 上启动 web 代理 API。用来记录的代理端口将通过扫描从端口 40443开始的打开端口来分配。在 web 代理控制台中启动代理时，可以配置端口号和其他选项。有关其他信息，请查阅 高级的 SOAtest 智能 API 测试生成器配置 

打开控制台并单击 Stop 停止代理。  

在 Mac OS 上，web 代理将位于您的 Applications/Parasoft 文件夹中。

手动启动 Web 代理 

Web 代理是一个 JAR 文件，您可以使用 java 命令来运行：

%INSTALLDIR%/jre/bin/java -jar com.parasoft.traffic.proxy.jar

智能 API 测试生成器附带了自己的 Java 实例，然而也可以使用系统上已安装的任何 Java 8 或以上版本。

默认情况下，将在端口 40090 上启动 web 代理 API。用来记录的代理端口将通过扫描从端口 40443开始的打开端口来分配。在启用代理时，可以指定系统属性来配置端口号和其它选项。有关其他信息，请查阅 高级的 SOAtest 智能 API 测试生成器配置

检查 Web 代理版本

使用 --version 参数(-v shorthand) 执行 JAR 文件，以在命令行上打印版本号。例如：

%INSTALLDIR%/jre/bin/java -jar com.parasoft.traffic.proxy.jar --version

如果要使用 SOAtest 智能 API 测试生成器对问题进行故障排除，版本号将非常有用。

使用此参数执行 JAR 只能让代理报告版本，而不启动代理。 

有关其他信息，请查阅 高级的 SOAtest 智能 API 测试生成器配置

配置浏览器扩展

  1. 右键单击 Parasoft 图标并选择 Options 以打开配置设置。您还可以通过单击 chrome://extensions 主页上的 Options 链接访问配置设置。
  2. 指定代理 API 端口（请查阅 高级的 SOAtest 智能 API 测试生成器配置） 和 SOAtest 服务器连接设置。



    启用 Secure (HTTPS) 选项通过 HTTPS 进行与 SOAtest 的通信。 
  3. 单击 Test Connection 以验证设置，如果成功，单击 Save