在前面的文章中已经详细介绍过Jenkins、Sonarqube的安装、配置及使用,对于Web端的代码质量管理通常相对容易,Jenkins配套Sonarqube很方便就能搞定。但是对于移动端来说,尤其iOS,集成和使用的复杂性会大幅提高,目前网络上有一些介绍的方法,但实际操作的过程中会存在很多坑。本篇文章,就带大家详细实操移动端代码质量扫描与安全检测评估。
一、代码质量扫描
Android的Sonarqube相对简单,这里不做过多介绍,重点介绍iOS的代码质量扫描。iOS代码质量扫描的核心是如何支持Objective-C和swift的扫描。SonarQubeCommunity社区版免费开源,一般来说,社区版就符合大多数开发者的需求,针对大多数语言都可以免费扫描。然而对于iOS,社区版不支持Objective-C和Swift的扫描,因此网络上有单身做了相应的开源插件sonar-swift来实现iOS的代码扫描。sonar-swift的github地址为https://github.com/Idean/sonar-swift,根据官方文档使用该插件的前提是要安装SonarQube、SonarQube Scanner、xcpretty、SwiftLint、Tailor、slather、lizard、OCLint。SonarQube和SonarQube Scanner在前面的文章中已经详细介绍过了,其他几个依赖我们一次介绍下。
(1)xcpretty安装
xcpretty是格式化Xcodebuild输入的工具,使用ruby开发,安装命令如下:
git clone https://github.com/Backelite/xcpretty.git
cd xcpretty
git checkout fix/duration_of_failed_tests_workaround
gem build xcpretty.gemspec
sudo gem install --both xcpretty-0.2.2.gem
(2)SwiftLint安装
SwiftLint 是一个用于强制检查 Swift 代码风格和规定的一个工具,基本上以 Ray Wenderlich's Swift代码风格指南为基础。
安装命令如下:
brew install swiftlint
(3)Tailor安装
Tailor是一个用于苹果的Swift编程语言编写的源代码的静态分析和lint工具。安装命令如下:
brew install tailor
(4)slather安装
slather为Xcode项目生成测试覆盖率报告并将其连接到CI。安装命令如下:
sudo gem install -n /usr/local/bin slather
(5)lizard安装
Lizard是一个可扩展的圈复杂度分析插件,适用于许多编程语言,包括C/C (不需要所有头文件或Java导入)。安装命令如下:
sudo pip3 install lizard
(6)OCLint安装
OCLint 是一种静态代码分析工具,用于通过检查 C、C 和 Objective-C 代码来提高质量并减少缺陷。
安装命令如下:
brew install oclint
(7)下载并安装完上述依赖后,通过https://github.com/Idean/sonar-swift下载jar文件,并将下载的jar文件放到本地SonarQube安装目录的插件目录下,通常为/usr/local/Cellar/sonarqube/xxx/libexec/extensions/plugins目录下。这时在SonarQube安装目录的bin目录下执行./sonar start,可能会报错导致SonarQube无法启动。原因是如果SonarQube的版本是9以上,官方的sonar-swift的jar为0.4.6版本,导致无法启动,需要在另一个分支上找适配的版本: https://github.com/estebanhiguitad/sonar-swift/releases,下载0.4.7版本即可。
(8)在iOS项目的根目录下创建sonar-project.properties和run-sonar-swift.sh两个文件。
1)其中sonar-project.properties为SonarQube相关的配置文件,可以直接拷贝https://raw.githubusercontent.com/Backelite/sonar-swift/master/sonar-project.properties,然后根据自己的项目做相应的配置修改,其中比较关键的如下:
# 项目使用的语言
sonar.language=swift
# Project description
# 源代码目录
sonar.sources=XXX
# Destination Simulator to run surefire
# As string expected in destination argument of xcodebuild command
# Example = sonar.swift.simulator=platform=iOS Simulator,name=iPhone 6,OS=9.2
指定模拟器,这里会有一个坑,为了配合run-sonar-swift.sh这个脚本,此处是必填项,可能存在找不到相应模拟器的问题,我们在run-sonar-swift.sh这个文件中做相应修改。
sonar.swift.simulator=platform=iOS Simulator,name=iPhone 13,OS=15.0
# 指定工程名或者空间名
sonar.swift.project=XXX.xcodeproj
sonar.swift.workspace=XXX.xcworkspace
# 配置Scheme
sonar.swift.appScheme= XXX
2)下载https://raw.githubusercontent.com/Backelite/sonar-swift/master/sonar-swift-plugin/src/main/shell/run-sonar-swift.sh的run-sonar-swift.sh文件,并修改其中的内容将 build-for-testing和destinationSimulator去掉buildCmd=($XCODEBUILD_CMD clean)
echo -n 'Building & extracting Xcode project information'
if [[ "$workspaceFile" != "" ]] ; then
buildCmd =(-workspace "$workspaceFile")
else
buildCmd =(-project "$projectFile")
fi
buildCmd =(-scheme $appScheme)
runCommand xcodebuild.log "${buildCmd[@]}"
这样就不会出现找不到模拟器的问题,完美解决。
(9)执行iOS代码扫描
启动SonarQube,在项目根目录下执行bash run-sonar-swift.sh -nounittests -v命令,根据sonar-project.properties的配置,会自动进行代码扫描,扫描完成后在SonarQube即可看到相应的报告。
二、安全检测评估
移动端安全检测我们采用MobSF,移动安全框架 (MobSF) 是一个智能化、一体化的开源移动应用(Android / iOS)自动测试框架,能够对iOS和Android 应用进行静态和动态分析(动态分析目前只支持Android)。MobSF可以有效、快速地对应用APK 和ipa文件及压缩的源代码进行审计分析。MobSF的安装和使用参照官方文档https://mobsf.github.io/docs/#/zh-cn/。安装和使用以MAC为例。
(1) 安装git,或者直接通过github上下载压缩包
sudo apt-get install git
(2) 安装Python
sudo apt-get install python3.8
注意MAC电脑上默认安装有安装Python ,需要修改环境变量以便切换到python3。
(3) 安装 JDK 8
sudo apt-get install openjdk-8-jdk
(4) 安装以下依赖
sudo apt install python3-dev python3-venv python3-pip build-essential libffi-dev libssl-dev libxml2-dev libxslt1-dev libjpeg8-dev zlib1g-dev wkhtmltopdf
依赖包括xml解析、pdf生成等插件。
(5) 安装MobSF
git clone https://github.com/MobSF/Mobile-Security-Framework-MobSF.git
cd Mobile-Security-Framework-MobSF
./setup.sh
(6) 运行MobSF
./run.sh 127.0.0.1:8000
(7) 运行MobSF
在浏览器中,打开 http://localhost:8000/ 访问 MobSF Web界面。
三、Jenkins集成sonar-swift和MobSF
由于MobSF需要上传APK 或IPA,因此需要在使用MobSF框架前将相应的包打包出来备用。采用Jenkins实现代码扫描和安全检测自动化有两种方式,一种是在Jenkins中新建两个任务,分别进行代码扫描、编译打包和安全检测;另一种方式是同一个任务中设置依赖,先进行代码扫描、编译打包,然后再进行安全检测,我们以第一种方式为例。
(1)代码扫描、编译打包
新建一个自由风格的Jenkins项目,常规的配置代码获取等在之前的文章中有介绍,这里不再赘述。
上图中的两个run-sonar-swift.sh和build.sh均位于iOS项目的根目录,build.sh为命令行编译打包的脚本,可以参考网上的相关文章进行编写。在构建步骤执行这两个步骤后就能将sonar-swift扫描的结果呈现到SonarQube上,并且打包出来ipa。
(2)安全检测
1)在Jenkins中新建一个Pipeline项目,在构建触发器选择依赖上一个编译打包的工程。
2)MobSF启动后访问http://127.0.0.1:8000/api_docs,获取REST API Key。
3)在Pipeline项目配置中添加脚本
脚本内容如下:
pipeline {
agent any
stages{
stage('Analysis') {
steps {
script {
echo 'start Upload'
//上传应用包
def AUTH_KEY = 'MobSF的REST API Key'
upload_cmd =
"curl -F
'file=@ipa文件所在的具体路径'
http://localhost:8000/api/v1/upload -H 'Authorization:${AUTH_KEY}'"
upload_result = sh label: 'Upload Binary', returnStdout: true, script: upload_cmd
}
}
}
}
}
4)执行Jenkins任务,构建完成后ipa包直接上传到MobSF平台作静态分析。
,