概要

Parasoft 录制器包含以下组件：

Parasoft 录制器 Chrome 扩展程序：
SOAtest Web 代理: 该代理安装在本机机器上，用来处理通讯报文和在 SOAtest 中创建 .tst 文件。
Parasoft 根证书颁发机构：CA 允许记录 HTTPS 通讯报文。

SOAtest, Virtualize, and CTP 2020.1 (Chinese) > Getting Started with SOAtest Smart API Test Generator > parasoft-recorder.png

系统要求

本章对 Parasoft 录制器组件以及相关功能要求进行了说明。

浏览器扩展程序

Google Chrome 最新版
记录 API 通讯报文，还必须运行 SOAtest Web 代理。

SOAtest Web 代理

端口 40090 必须可用于 web 代理。

生成 API 测试

SOAtest 桌面版或服务器版 9.10.5 及以上版本

创建和管理 Selenium 测试

许可证

可以免费下载和安装 Parasoft 录制器，但若要使用 SOAtest 中的 API 测试生成功能或 Parasoft Selenic 中 Selenium 测试生成和管理功能，则要求有一个有效的许可证。有关许可证信息，请联系 Parasoft 技术支持。

API 测试许可证

录制通讯报文和生成测试需要一个高级的测试生成许可证。可使用以下许可证选项：

高级测试生成桌面：不允许从远程机器连接。
高级测试生成 5 个用户：最多有 5 个用户可以从任何可以连接到 SOAtest 服务器的机器上创建资产。
高级测试生成 25 个用户：最多有 25 个用户可以从任何可以连接到 SOAtest 服务器的机器上创建资产。
高级测试生成 100 个用户：最多有 100 个用户可以从任何可以连接到 SOAtest 服务器的机器上创建资产。

Selenium 测试许可证

关于许可证的详细信息，请查阅 Parasoft Selenic 文档。

安装指南

运行 Windows 上用于安装的 parasoft_recorder_<version>_win32.exe 文件，或 Mac OS 上用于安装的 parasoft_recorder_<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）。

SOAtest, Virtualize, and CTP 2020.1 (Chinese) > Getting Started with SOAtest Smart API Test Generator > parasoft-recorder-install-as-service-win-9108.png

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

SOAtest, Virtualize, and CTP 2020.1 (Chinese) > Getting Started with SOAtest Smart API Test Generator > parasoft-recorder-install-chrome-store-win-9108.png

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

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

SOAtest, Virtualize, and CTP 2020.1 (Chinese) > Getting Started with SOAtest Smart API Test Generator > parasoft-recorder-installer-mac-autostart-9108.png

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

SOAtest, Virtualize, and CTP 2020.1 (Chinese) > Getting Started with SOAtest Smart API Test Generator > web-proxy-macos-settings.png

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

SOAtest, Virtualize, and CTP 2020.1 (Chinese) > Getting Started with SOAtest Smart API Test Generator > parasoft-recorder-installer-mac-view-apple-cert-9108.png

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

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

SOAtest, Virtualize, and CTP 2020.1 (Chinese) > Getting Started with SOAtest Smart API Test Generator > smart-api-test-gen-installer-enable.png

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

卸载浏览器扩展和代理

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

手动安装

以下说明描述了如果不能使用安装程序，如何手动安装 Parasoft 录制器组件。

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

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

安装 Parasoft 根证书颁发机构

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

Windows

通常通过 SOAtest Windows 安装程序和 Parasoft 录制器安装程序自动安装 Parasoft 根证书颁发机构。如果有必要，还可以使用 -installcertificate 选项运行 soatestcli 进行手动安装。

soatestcli -installcertificate

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

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

Mac OS

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

启动 Web 代理

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

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

SOAtest, Virtualize, and CTP 2020.1 (Chinese) > Getting Started with SOAtest Smart API Test Generator > smart-api-test-gen-man-web-proxy.png

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

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

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

SOAtest, Virtualize, and CTP 2020.1 (Chinese) > Getting Started with SOAtest Smart API Test Generator > parasoft-recorder-start-web-proxy-macos-9108.png

手动启动 Web 代理

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

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

Parasoft 录制器附带了自己的 Java 实例，然而也可以使用系统上已安装的任何 Java 8 或以上版本。

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

检查 Web 代理版本

例如：

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

如果要使用 Parasoft 录制器对问题进行故障排除，版本号将非常有用。

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

有关其他信息，请查阅 Parasoft 录制器高级配置

配置浏览器扩展

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

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