有時候不看官方文檔進行配置,可能會出現奇奇怪怪的問題,SO轉載一下官方文檔,順帶學習。
想超長體驗此軟件,請搜索本博客內容,有破解方法,僅用來學習使用,順帶進行二次開發,請勿使用在商業用途,謝謝。
泛微雲橋e-Bridge安裝手冊
一、 概述
泛微雲橋(e-Bridge)是上海泛微公司在”互聯網+”的背景下研發的一款用於橋接互聯網開放資源與企業信息化系統的系統集成中間件。截止自本手冊編制之日e-Bridge已實現了騰訊微信及阿里釘釘開放接口的封裝,企業可以通過e-Bridge快速實現基於微信及釘釘的移動辦公應用接入。對於泛微協同辦公產品e-cology更是實現了可視化的配置接入。后續e-bridge將整合更多的互聯網信息化資源,讓企業能夠更加便利的利用開放的互聯網資源進行企業信息化建設。
本手冊基於e-Bridge20150910版本編制,之前版本產品名稱為【泛微微信&釘釘集成平台】本手冊同樣適用於之前的版本,之前的版本下文說明中涉及的目錄ebridge均為ewechat。
二、 安裝環境要求
- 適用操作系統:windows xp、7、8、2003、2008、2012、Linux系列
- 使用的web服務:tomcat(安裝包已包含無需單獨安裝)
- 使用的數據庫:mysql(安裝包已包含無需單獨安裝)
- 標准安裝包支持64位操作系統,非64位操作系統需要單獨處理
- 網絡環境要求:
a) e-Bridge需要開通外網訪問,安裝e-Bridge的服務器可訪問外網
b) e-Bridge需要能夠與被集成的系統之間相互訪問
- 6. PC端訪問瀏覽器要求:支持IE8及以上、谷歌、360,建議用360極速模式
- 7. 如果集成微信企業號:手機微信版本必須是6.2及以上,並且只支持安卓和IOS
三、 產品基本安裝
四、 License提交
安裝完成之后訪問:http://服務器IP:8088 (請用實際安裝的tomcat端口)
登陸系統:賬號sysadmin密碼1,用戶可以自行修改賬號密碼
根據License識別碼,向泛微客服人員申請license授權文件(系統安裝完可以直接點擊頁面上的【獲取臨時License】得到1個月的授權)
e-Bridge的License控制包含幾個方面
1、 使用時間:驗收之前只會給到1至2個月的使用期限,驗收后給到永久期限
2、 用戶數:注冊用戶數,能夠在微信或者釘釘中使用e-Bridge提供的功能的注冊用戶賬號數量
3、 公眾號:能夠通過e-Bridge管理多少個公眾號(根據合同約定給予,如果是微信公眾號集成合同,合同未注明個數的只提供1個)
4、 企業號(現已升級為企業微信):能夠通過e-Bridge管理多少個企業號(根據合同約定給予,如果是微信公眾號集成合同,合同未注明個數的只有1個)
5、 釘釘號:能夠通過e-Bridge管理多少個企業號(根據合同約定給予,如果阿里釘釘集成合同,合同未注明個數的只有1個)
6、 識別碼:和服務器硬件標識綁定,一個license只能在一個服務器上使用
7、 模塊License:針對非標配的模塊進行單獨的License控制,具體根據約同約定,合同未約定的只提供與泛微e-cology產品相關的模塊
五、 開通外網
因為本系統需要調用微信或者釘釘開放的接口,並且最終用戶是通過微信或者釘釘來使用集成的功能,所以本系統部署的服務器必須要求
能夠訪問外網:就開通這台服務器上上網權限,讓這個服務器能夠訪問互聯網(如果貴公司對網絡安全要求較高,至少需要讓這個服務器能夠訪問*.weixin.qq.com* *.dingtalk.com*的地址 *號表示任意字符),檢測方式,訪問以下地址
a) 企業號(現已升級為企業微信)接口測試:https://qyapi.weixin.qq.com/cgi-bin/menu/get
b) 公眾號接口測試1:https://api.weixin.qq.com/cgi-bin/menu/get
c) 公眾號接口測試2:http://file.api.weixin.qq.com/cgi-bin/media/get
d) 釘釘號接口測試:https://oapi.dingtalk.com/user/get
如果是windows服務器用服務器上的瀏覽器訪問上述地址,如果是Linux服務器,則執行curl命令檢測上面的地址,如curlhttps://qyapi.weixin.qq.com/cgi-bin/menu/get看看返回的數據看看是否返回41001錯誤,例如 {"errcode":41001,"errmsg":"XXXXXXXX"},如果返回的是這個則證明是可以的。
2、 外網能夠訪問到本系統:請網絡管理員將本系統的訪問地址映射到外網(為了后續能夠使用更多的微信及釘釘開放的接口,外網地址建議使用經過ICP備案的域名來訪問,比如泛微公司的地址:http://wx.weaver.com.cn或者http://wx.weaver.com.cn:8088)
六、 基礎參數設置
設置入口:【系統設置】à【基礎參數設置】
根據企業實際環境設置一下幾個參數,然后點擊【保存】按鈕進行保存
l 本系統外網地址:e-Bridge的外網訪問地址,即在公網上可以訪問e-Bridge的網址
溫馨提示:
如果涉及到和微信公眾號(服務號、訂閱號)的集成則外網訪問的地址必須是沒有端口的,需要讓客戶網絡管理員開通不帶端口可以的公網訪問地址否則無法接入微信公眾號(服務號、訂閱號)的接入,如果只做企業號的集成則無所謂端口,只要外網可以訪問即可
外網地址盡量設置成域名而且是經過ICP備案的域名,這樣用戶在web頁面輸入內容的時候不會存在風險提示,而且后續可以用到更多的微信及釘釘提供的接口
l 本系統內網地址:該地址主要用於e-cology服務器訪問使用,舉例說明,有幾種情況
n e-cology系統與e-Bridge在同一台服務器上那么地址就是http://127.0.0.1:8088
n e-cology系統與e-Bridge在一個局域網內則地址就是e-Bridge的http://內網IP+端口
n 如果e-cology系統與e-Bridge不在一個網絡環境下,那么這個地址設置的和外網地址一樣
總而言之,確保在e-cology的服務器上通過這個地址能夠訪問到e-Bridge即可
l 文件存放路徑:e-Bridge中產生的文件存放的位置:
n Windows下設置例子:d:\ebridge\file
n Linux 下設置例子:/user/ebridge/file
l 升級提醒:啟用了這個開關,一旦本系統有新版本管理員登陸系統的時候會提醒管理員進行升級,建議開啟升級提醒,並進行升級確保您的平台是最新版本
注意:這里系統會對您設置的內容進行檢測,如果保存時有特別提示請務必注意。
至此,泛微雲橋e-Bridge安裝完畢,請按照其他配置手冊配置具體的功能。
七、 雲橋升級
您可以通過泛微網站下載最新的e-Bridge最新的補丁包進行升級
下載地址http://wx.weaver.com.cn/download,如下圖所示
請下載【e-Bridge補丁包】,該升級補丁包,可用於任何版e-Bridge進行升級
- 1. windows上的升級(早期安裝的版本以下的ebridge是ewechat)
l 解壓補丁包文件得到ebridge目錄,覆蓋到 d:/ebridge
l 通過windows服務管理器重啟ebridge_tomcat服務
- 2. Linux上的升級操作(早期安裝的版本以下的ebridge是ewechat)
l 解壓補丁包文件得到ebridge目錄,上傳覆蓋到 /usr/ebridge
l 切換到/usr/ebridge目錄下執行命令./restart.sh 重啟集成平台服務
注意:如果通過e-Bridge集成了泛微的e-cology產品,那么請在e-cology產品中同步升級【e-cology端升級文件】