混合代理集成
父页面： PLM 集成
混合集成适用于以下情况：一家公司使用 Altium 365 并希望将其工作区与托管在公司网络内部、没有公共 IP 地址的 PLM 系统集成在一起——即它没有暴露在互联网上。
为了实现这一点，公司网络内部会运行一个名为混合代理的小程序。该程序与 Altium 365 通信，在 Altium 365 工作区和封闭网络内的 PLM 系统之间传递信息。与混合代理的通信通过 HTTPS 进行，不需要为来自互联网的入站流量打开任何网络端口。只需要标准 HTTPS 端口 443 用于出站流量。
设置混合集成
混合代理安装包可以从Altium 365 Workspace的混合代理页面获取，该页面可以通过（新的）PLM管理页面顶部的混合代理标签选项打开（管理员 – PLM集成）。
下载代理存档（
）并将其内容解压到一个已知位置。它包含一个Java应用程序（hybrid-agent.jar），需要在公司网络内部的一台机器上运行，从该机器可以访问本地PLM系统和Altium 365。
该机器不需要能够从互联网公开访问，但需要能够连接到贵公司使用的Altium 365环境。
混合代理需要Java开发工具包（JDK）版本11或更高。
可以使用Oracle JDK或OpenJDK。使用Oracle JDK时，请确保您有有效的许可证。
如果是从普通存档（而不是安装程序可执行文件）安装JDK，需要添加其路径环境变量。对于Windows机器/虚拟机，这些通常是：
PATH– 指向安装的bin文件夹。JAVA_HOME– 指向安装文件夹本身。
通过运行Java -version命令测试对Java可执行文件的访问。
- 在 Altium 365 工作区的 Hybrid Agent 页面生成 API 密钥 (
)。 - 使用该 API 密钥作为其值创建一个
HYBRID_AGENT_API_KEY环境变量。 -
使用以下命令上下文运行
agent.bat，其中 URL 参数应为您的 Altium 365 工作区的 URL：
agent.bat https://acme.365.altium.com
当激活时，混合代理将在应用程序的 hybrid-agent\logs 文件夹中生成一个日志文件。
强烈推荐在生产环境中将混合代理作为 Windows 服务运行，而不是直接在终端中运行，尽管后者可用于测试。
使用 NSSM 服务管理器将混合代理作为 Windows 服务运行的一个示例方法：
- 运行命令：
nssm install HybridAgent。 - 在 NSSM 对话窗口中（在应用程序标签下），在路径字段中输入
agent.bat文件路径，在参数字段中输入您的工作区 URL，然后点击安装服务。- 您可以在 NSSM 对话框的详细信息标签下使用启动类型选项设置服务启动行为。如有需要，运行
nssm edit HybridAgent进行此类更改。 - 作为为 Java 创建标准
PATH和JAVA_HOME环境变量的替代方法，它们可以添加到 NSSM 的环境标签下。采用这种方法时，变量仅在HybridAgent服务运行时激活。 -
与上面类似，
HYBRID_AGENT_API_KEY变量也可以移动到 NSSM 环境设置中，以便在服务运行时激活。
- 您可以在 NSSM 对话框的详细信息标签下使用启动类型选项设置服务启动行为。如有需要，运行
- 使用 Windows 服务管理工具或 NSSM 命令：
nssm start HybridAgent启动HybridAgent服务。如果服务设置为自动启动，则在 PC 重启后不需要这样做。 - 确保在 Windows 服务管理工具中或使用 NSSM 命令：
nssm status HybridAgent检查HybridAgent服务正在运行。
一旦Hybrid Agent连接到您的Altium 365工作区（刷新浏览器窗口以检查其状态），您就可以继续在Altium 365工作区中配置PLM集成。在添加配置页面，启用Hybrid Agent连接选项，并在URL字段中输入您在封闭网络内看到的本地PLM的URL。
HYBRID_AGENT_API_KEY环境变量。
重启 Hybrid Agent 以使用新的密钥 - 使用 NSSM 的话，使用nssm restart HybridAgent命令，或者在 Windows 服务中停止/启动HybridAgent服务。