一、场景
使用 MobileUpdate扩展包,可以实现在手机浏览器中访问一个htm页面,进行APP的安装和下载。 主要适用于两种情况:一种是客户的移动设备只能访问内部网络,另一种是客户的移动端版本是经过定制化的。
二、扩展包设置及部署
1.获取扩展包:扩展包的名称为 MobileUpdate.ext,可以从这里下载,或者从思迈特处获取该扩展包的最新版。
2.把需要安装的ipa和apk文件,重新命名为Smartbi_Small.ipa和smartbiWeb for Android.akp。
将扩展包使用压缩软件打开,并将上述两个app文件替换掉扩展包 中\vision\package目录中的同名文件
保存该扩展包
3.扩展包部署:参照“扩展包部署”文档,部署到服务器后重启服务器即可使用。成功部署后可以在“用户名-》系统监控-》扩展包”页面上看到类似下面的记录。
4.访问
本节以IOS为例,安卓设备类似
在 iPad/iPhone 设备上用系统自带的 Safari 浏览器访问如下安装链接,比如:http://172.26.99.1:18080/smartbi/app.htm,将出现如下所示界面。点击其中 iOS 操作系统对应的 Smartbi Mobile 安装地址
点击 Smartbi Mobile之后,进入下载安装界面。正常可以点击新界面上的产品图标,系统将自动下载安装包并安装。但是对于 IOS 8.0 及以上版本,左下角会出现“使用前先安装证书”选项。需要先点击它安装证书后,再点击上面的产品图标。
在安装产品前需要先点击安装好证书(只需要安装一次)。关于证书的生成及部署的进一步说明请参考下一步骤。
三、证书生成及部署
IOS 8.0 及以上版本中,若使用 WEB 的安装方式,只能使用 HTTPS 来通讯,因此需要在应用服务器上部署 SSL 证书。请参考以下步骤设置。
3.1 附录1:SSL证书生成
强烈建议用户使用自己的证书或者由专业 CA 生成的证书,若没有,可以使用下载文档中的 "OpenSSL证书工具.zip"来自己生成证书。
- 下载并解压 OpenSSL 工具包。 下载链接: OpenSSL.zip
- 执行解压目录里面的 1.GenerateRootCA.cmd 生成根证
- 将 RootCA目录里面的 RootCA.cer放入扩展包的vision目录替换原来的RootCA.cer。
- 执行解压目录里面的 2.GenerateServer.cmd 出现如下界面:
这时候需要填入应用服务器的IP或者域名(使用IP还是域名由移动端设置时填入的服务器地址决定,即苹果设备下载移动端访问的地址要与SSL证书颁发的地址保持一致),多个域名与
IP之间使用空格分开。 - 上一步成功执行后,将产生一个对应IP或者域名的目录,将.pfx、.pem和.cer文件拷入应用服务器的bin目录,
这个文件就是服务器需要使用证书了。 - 参考下面的附录进行服务端的证书部署。
3.2 附录2:Tomcat服务器证书部署
1、进入 Tomcat 服务器安装目录的 conf 子目录下,编辑 server.xml 文件。
2、在server.xml中找到以下信息并将注释放开。
3、修改里面的SSL设置,因Tomcat不同这里可能存在有两种不同的配置方式。需要注意修改的就是端口号和证书路径。
配置方式一:修改里面的SSL设置,需要注意修改的就是端口号和证书路径。
<Connector port="8443" maxHttpHeaderSize="8192" SSLEnabled="true" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" disableUploadTimeout="true" acceptCount="100" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" keystoreType="PKCS12" keystoreFile=" XXX\XXX\XXX.pfx" keystorePass="ServerPassword" />
注:如果使用上述配置启动时提示SSLCertificateFile或SSLCertificateKeyFile属性没有设置,则使用下述的格式
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" SSLCertificateFile="${catalina.base}/bin/XXX.cer" SSLCertificateKeyFile="${catalina.base}/bin/XXX.pem" SSLPassword="ServerPassword"/>
配置方式二:如果没有找到配置方式一的代码,直接采取此配置方式即可:
找到第2步骤中server.xml取消注释的这段代码,修改成如下信息,对应端口号信息和证书信息需要进行修改,证书的路径可以是相对路径也可以是绝对路径,如可以将证书放在Tomcat/bin目录下:
详细信息如下:
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" SSLCertificateFile="${catalina.base}/bin/XXX.cer" SSLCertificateKeyFile="${catalina.base}/bin/XXX.pem" SSLPassword="ServerPassword"/>
4、修改后,同时修改 MobileUpdate.ext 扩展包中的 META-INF/mobileupdate.properties 文件,把里面的端口号改为对应的端口号(默认8443)。
3.3 附录3:WebSphere服务器证书部署
以 WebSphere 8.5 应用服务器举例说明。
1、进入服务器管理页面, "安全性"——"SSL证书和密钥管理"。
2、进入"管理端点安全配置"。
3、选择对应的服务器或集群的入站设置。
4、进入管理证书。
5、填写证书存放的路径,导入证书。
注意选择证书别名。
6、导入后回到上层菜单选择导入的证书别名保存,并重启服务器。
四、安装步骤
IOS端通过上述步骤完成后,按照如下的方式访问安装APP。
1.在safari浏览器中通过 https://172.26.99.1:8443/smartbi/app.htm 的方式访问。注意:ios是通过https方式访问的,有可能浏览器提示没有验证,需要确认是否继续访问,直接确认即可。
2.点击 Smartbi Mobile,进入下一个界面
3.点击“使用前先安装证书”,进入证书安装界面
跟着引导进行证书安装即可,注意证书安装过程中有可能会要求输入密码,该密码及苹果设备的锁屏密码
安装完成的界面如下:
4.由于IOS高版本,如IOS10及以上,增加了对证书的信任设置,因此需要进入手机设置-》通用-》关于本机,找到“证书信任设置”
进入之后,设置ROOTCA为允许状态
5.重新进入safari浏览器,点击页面中的图标安装APP
如下:
Android端仍然正常通过 http://172.26.99.1:18080/smartbi/app.htm访问
四、附录
3、操作步骤
下面以 IOS 系统为例介绍操作步骤,安卓系统 Android 类同。
3.1 首次安装
在 iPad/iPhone 设备上用系统自带的 Safari 浏览器访问如下安装链接,比如:http://192.168.1.109:18080/smartbi/app.htm,将出现如下所示界面。点击其中 iOS 操作系统对应的 Smartbi Mobile 安装地址。
接着,点击新界面上的产品图标,系统将自动下载安装包并安装。对于 IOS 7.1 及以上版本,左下角会出现“使用前先安装证书”选项。需要先点击它安装证书后,再点击上面的产品图标。
在安装产品前需要先点击安装好证书(只需要安装一次)。关于证书的生成及部署的进一步说明请参考附录。