远程应用

注：社区版只支持 Website 方式。

1 功能简述

• 远程应用（RemoteApp）功能是微软在 Windows Server 2008之后，在其系统中集成的一项服务功能，使用户可以通过远程桌面访问远端的桌面与程序，客户端本机无须安装系统与应用程序的情况下也能正常使用远端发布的各种的桌面与应用。

2 应用发布机

• RemoteApp 功能需准备应用发布机环境来进行支持。
• 应用发布机是用来运行 Web 页面资产或者使用远程应用 Navicat 连接数据的程序运行主体。

2.1 版本要求

• 应用发布机为 Windows Server 服务器，具体版本要求如下：

Windows Server 2016	Windows Server 2019

2.2 创建应用发布机

• 点击应用发布机页面的创建按钮即新建一个应用发布机。

• 我们支持通过 WinRM 和 OpenSSH 的协议进行应用发布机的部署（推荐使用 Windows-Server 自带的 WinRM 服务）

WinRMOpenSSH

• 通过 WinRM 协议部署应用发布机，在创建应用发布机页面新增 WinRM 协议即可。

• WinRM 配置完成。

• 通过 OpenSSH 协议部署应用发布机需要安装 OpenSSH 协议，可以在 JumpServer 页面 - Web终端 - 帮助 - 下载 页面找到 OpenSSH 安装包。

• OpenSSH 安装包传到应用发布机桌面后，双击进行安装。

• OpenSSH 配置完成。

• 详细参数说明：

2.3 部署应用发布机

• 创建应用发布机后需手动执行应用发布机部署，安装 Python、Chrome、Navicat、DBeaver 或自定义远程应用。
• 点击应用发布机名称按钮进入应用发布机详情页中，选择发布机部署页签，点击快速更新模块的初始化部署按钮，初始化应用发布机。

2.4 查看应用发布机详情

• 点击应用发布机名称按钮进入应用发布机详情页中。
• 此页面包含应用发布机详情信息，包括：远程应用发布机帐号列表、远程应用、发布机部署记录等。

• 详细参数说明：

3 远程应用

• 创建远程应用资源，实现远程访问目标资源，并实现密码代填功能。
• 当前举例访问 JumpServer 页面过程（实现密码代填）

3.1 创建 Website 资产

• 点击切换至控制台视图资产管理 - 资产列表 页面中。
• 选中 Web 页签，点击创建 Website 资产。

• 其中 选择器 参数，需要根据目标 Url 页面中的代码参数中获取。
• 我们通过 F12 打开目标 Url 的开发者工具页面，步骤如下图：

• 把获取到的参数填写至创建的目标 Website 资产，参考当前页面3.1 标题第一张图片。

3.2 创建资产授权规则

• 点击切换至权限管理 - 资产授权 页面中。
• 创建新的授权规则，如下图：

3.3 访问 Website 资产

• 通过 Web终端 选中目标 Website 资产访问。
• 访问 Website 资产需要本地客户端安装 JumpServer 客户端程序，可在 JumpServer 页面 - Web终端 - 帮助 - 下载 页面找到安装包。

3.4 页面效果

• 当前为远程应用页面访问效果图：

4 自定义 Applet

4.1 Applet 介绍

• Applet 是一个包含 Python 脚本的目录，必须至少包含以下文件：

├── i18n.yml
├── icon.png
├── main.py
├── manifest.yml
└── setup.yml

• 文件名称作用说明：

4.2 元数据 manifest.yml

• manifest.yml 定义了 Applet 的元数据，如名称、作者、版本、支持的协议。

name: mysql_workbench8 （required）
display_name: MySQL Workbench8
comment: A tool for working with MySQL, to execute SQL and design tables (required）
version: 0.1 (required）
exec_type: python (reserved，暂未使用)
author: Eric (required）
type: general (required）
update_policy: none (暂未使用)
tags: (required）
  - database
protocols: (required）
  - mysql

• 详细字段说明：

4.3 安装条件 setup.yml

• setup.yml 定义了 Applet 拉起程序的安装方式。

type: msi # exe, zip, manual
source: https://jms-pkg.oss-cn-beijing.aliyuncs.com/windows-pkgs/mysql-workbench-community-8.0.31-winx64.msi
arguments:
  - /qn
  - /norestart
destination: C:\Program Files\MySQL\MySQL Workbench 8.0 CE
program: C:\Program Files\MySQL\MySQL Workbench 8.0 CE\MySQLWorkbench.exe
md5: d628190252133c06dad399657666974a

• 详细字段说明：

• 如果选择 manual 的方式，source 等保持为空，可不校验 MD5 值，需要手动登录 Applet host（应用发布机）上安装软件。

4.4 脚本执行 main.py

• main.py 是 Python 脚本主程序。
• JumpServer 的 Remoteapp 程序 tinker 将通过调用 python main.py base64_json_data 的方式执行。
• base64_json_data 是 JSON 数据进行 base64 之后的字符串，包含资产、账号等认证信息。数据格式大致如下，依据 api 变化做相应调整：

{
  "app_name": "mysql_workbench8",
  "protocol": "mysql",
  "user": {
    "id": "2647CA35-5CAD-4DDF-8A88-6BD88F39BB30",
    "name": "Administrator",
    "username": "admin"
  },
  "asset": {
    "asset_id": "46EE5F50-F1C1-468C-97EE-560E3436754C",
    "asset_name": "test_mysql",
    "address": "192.168.1.1",
    "protocols": [
      {
        "id": 2,
        "name": "mysql",
        "port": 3306
      }
    ]
  },
  "account": {
    "account_id": "9D5585DE-5132-458C-AABE-89A83C112A83",
    "username": "root",
    "secret": "test"
  },
  "platform": {
    "charset": "UTF-8"
  }
}