WowCoolApk

😃 Compute api.coolapk.com API X-App-Token HTTP Request header with Scala CLI Application

Why？How can I use that API？

酷安的 HTTP 接口会利用 X-App-Token HTTP 请求头参数校验客户端的身份，这就是所谓的『接口验证』

酷安的客户端内部肯定要有这么一个生成算法，不过为了『100% 保密安全』是用 C 程序设计语言编写的，一般人看不懂也不知道怎么 RE

不过很可惜的是，虽然酷安的高级技术人员们，有心炫技弄了这个 native 的访问令牌生成算法，可是不知道把某知名 CoolLibrary 项目怎么就弄成了 Debug Release 😂

令人笑破肚皮了，这是生怕别人逆向工程不出来整个算法啊！于是酷安的 liba.so 到这里彻底爆破翻车，一个晚上就被人还原了所有逻辑，还被几个某安基佬 C, Ruby, Python, Java, Scala 五国语言重写了一遍，真是酷安史上最大发布翻车。

实在是属于项目构建打包发布管理严重纰漏，要不然就是开发部水准不过关啊！（暴论）

如果接口验证不能通过并且需要的 HTTP 头没有提供，则接口（2019.5.5 止）会返回 404 Not Found 也加了令牌无效和令牌过期验证，不过很可惜，现在都作废了.... 🤔

这个故事告诉我们，不要以 Debug 模式发布任何应用程序。 另外也提醒了我们，用 C 写，编译成机器码，也未必就是所谓的『完全黑盒』了。

X-Requested-With: XMLHttpRequest
X-Sdk-Int: 25
X-Sdk-Locale: zh-CN
X-App-Id: com.coolapk.market
X-App-Version: 9.0.2
X-App-Code: 1902151
X-App-Token: getCoolToken()

DMCA Takedown

欢迎，不过 v6 沿用至今的算法怕是不能用了，要不然，得强迫所有 v8 的用户更新

Compiling

Just compile WowCoolApk.scala with scalac:

scalac -optimise -target:jvm-1.7 WowCoolApk.scala

The default output classpath is .

Running

With scala command:

$ scala WowCoolApk
Run WowCoolApk help to show help

with java command and scala-library.jar:

$ java -cp /usr/share/java/scala/scala-library.jar:. WowCoolApk gen
91e0857e3de6b1dff2bcfa4bd31f051900000000-0000-0000-0000-0000000000000x5ccdbac9

Command-line Usage

$ scala WowCoolApk help
Generate X-App-Token HTTP request header field for com.coolapk.market
Usage:
WowCoolApk <help -help -h --help> Get help
WowCoolApk <uuid> 
WowCoolApk <uuid> <date>
WowCoolApk <uuid> <date> <apk>
WowCoolApk <flag: _ or q or v> rest... [! to use defaults]
WowCoolApk <get gen> generate one with default options:
 0*-0*-0*-0*-0* as UUID,
 $PACKAGE as market,
 current time as time

• WowCoolApk: How to get help?
• WowCoolApk <get|gen>: Get token with default parameters
• WowCoolApk: <help -help -h --help> Get help
• WowCoolApk [uuid] [date] [apk]: Generate with options override
• WowCoolApk [qv_] [!]: Generate with flags (q -> be quiet, v -> be verbose)
• WowCoolApk [qv_][uuid] [date] [apk]: Generate with flags and options override

WowCoolApk "WoW" Template (GET Query only) Client

• WowCoolApk r [-a -auth Cookie set] [-ac -accept Accept] [parameters] : Get raw data
• WowCoolApk rj [-a -auth Cookie set] [-ac -accept Accept] [parameters] : Get pretty JSON data

w: wow or w

• WowCoolApk w [-a -auth Cookie set] [-ac -accept Accept] [Query or path parameters]

Run wow client

URL Template like:

/foo/bar
/{arg}/name: with a path parameter named arg
/setAsAdmin?uid: with a query parameter named uid
/setName?uid&name: with query parameter uid and name
/setBio?uid&bio=Noting (: with query parameter uid and bio, bio default value is "Nothing (:"
/{arg}/name?uid=1
...

Display string like:

Name: {$.appName}<<Version: {$['app_version']}<<Author: {$.author.name}

<<: newline

Simple JSON Path language:

$: root object
$.name: index object with simplename
$['name'] index object with string name
$['a'][0] index array with number index
$.0.1: $[0][1]
$.a.b: $['a']['b']


Result VALUE maybe Map(object)/List(array)/String/Double/Boolean/null

"Wow" template client is Not supported yet

Scala library

//$ scala -i WowCoolApk.scala 
//Loading WowCoolApk.scala...
import java.util.Base64
import java.util.Date
import java.text.SimpleDateFormat
import java.text.ParseException
import java.security.MessageDigest
import java.security.NoSuchAlgorithmException
//defined module WowCoolApk

//Welcome to Scala version 2.10.6 (OpenJDK 64-Bit Server VM, Java 1.8.0_201).
//Type in expressions to have them evaluated.
//Type :help for more information.

WowCoolApk.getCoolToken("com.coolapk.market", new Date, "|uuid|")
val res0: String = "555a63b38d01e2c6d02191e2caa927fa|uuid|0x5ccdbe03"

// new version
getCoolToken(apk = PACKAGE, timeAt = new Date, uuid = Some(DEFAULT_DEVICE_UUID))

Implementation

def getCoolToken(apk: String = PACKAGE, timeAt: Date = new Date, uuid: String = DEFAULT_DEVICE_UUID):
  String = {
  val timestamp = timeAt.getTime() / 1000
  val salt = TOKEN + timestampMd5(timestamp) + "$" + uuid + "&" + apk
 
  val stringBytes = (s: String) => s.getBytes()
  val toBase64AndMD5Digest = toMd5String _ compose stringBytes compose toBase64

  val salt_b64_md5 = toBase64AndMD5Digest(salt.getBytes())

  val utime_hex = "0x%x".format(timestamp)
  return salt_b64_md5 + uuid + utime_hex
}

See also

• PinkD/CoolApkApiTokenGenerator (java program)
• bjzhou/Coolapk-kotlin