# 莫奈数据代理服务

莫奈数据代理服务(MonetProxy)是莫奈可视化平台的一个数据源配置工具，它可以部署在您的机器上， 作为莫奈可视化平台和您本地数据源通信的代理服务。(为了保证网络安全性，您部署MonetProxy机器安全组不应开放所有ip访问权限，只需额外添加莫奈可视化平台的出口ip即可)

# 适用场景

• 您不希望将您的数据库信息托管在莫奈可视化平台上
• 您的数据库没有外网访问地址或者部署在内网中，但是您希望打通数据源到莫奈可视化平台的通信

# MonetProxy工作原理

• 莫奈可视化平台将加密的sql查询字段和数据库的唯一标识传递给MonetProxy
• 由本地部署的MonetProxy连接到用户的数据库，并执行解密后的Sql，获取查询结果
• 将查询结果返回到莫奈可视化平台大屏中

由于莫奈可视化平台需要通过公网访问MonetProxy服务，所以需要将部署后的MonetProxy服务映射到公网

# 安装教程

# 1. 下载部署包

Linux部署包

MacOS部署包

Windows部署包

# 2. 启动服务

• linux/MacOS环境

启动命令

sh launch_app.sh start

停止命令

sh launch_app.sh stop

• windows环境

启动命令

launch_app.bat start

停止命令

launch_app.bat stop

• 备注： 该服务是java工程，启动时的默认端口是8001，您可以在命启动命令中追加 -p [端口号] 指定服务的端口号，也可以通过在命令中追加 -j 指定运行时jvm参数。 例如：

sh launch_app.sh start -p 8080 -j "-Xmx1g -Xms512m"

# 使用教程

# MonetProxy

服务启动成功后，在浏览器中访问 http://域名:端口 进入MonetProxy服务界面，在界面中您可以新增数据源以及查询/生成通信秘钥等功能。

• 域名：安装MonetProxy的服务器的公网ip
• 端口：MonetProxy服务的启动端口

1. 注册并登陆 首次登陆需要注册并登陆应用

2. 配置数据源 数据源配置步骤与莫奈开放平台-数据源管理部分一致，参考数据源配置，需注意MonetProxy所在机器需要和目标数据源网络打通

3. 配置秘钥 MonetProxy初次启动时会生成默认的秘钥key-secret；该秘钥用于莫奈可视化平台和MonetProxy通信的凭证，点击""一件生成新的key/secret"生成新的秘钥

# 莫奈可视化平台-使用MonetProxy数据源

1. 创建数据代理服务数据源

• 打开莫奈可视化平台-数据源管理菜单，点击添加数据源按钮，选择莫奈数据代理服务

• 填写MonetProxy的访问信息，服务器地址为带有协议的http/https地址,如：http://xxx.xxx.xxx.xxx, key和secret为MonetProxy服务中秘钥菜单对应的key/secret串

• 配置完成后，点击测试连通性,出现 测试通过 即可;若测试不通过，请确认MonetProxy服务能否公网访问，或者MonetProxy所在机器的安全组是否添加了莫奈可视化平台的出口ip

2. 使用数据代理服务

• 大屏数据配置
• 组件数据配置