158 lines
6.5 KiB
Swift
158 lines
6.5 KiB
Swift
import Foundation
|
||
import CryptoKit
|
||
import Security
|
||
|
||
/// 队列里的一个文件。
|
||
struct PeerFileMeta: Equatable {
|
||
let name: String
|
||
let size: UInt64
|
||
let sha256: String
|
||
|
||
var json: [String: Any] {
|
||
["name": name, "size": NSNumber(value: size), "sha256": sha256]
|
||
}
|
||
|
||
static func parse(_ object: [String: Any]) -> PeerFileMeta? {
|
||
guard let rawName = (object["name"] as? String)?.trimmingCharacters(in: .whitespaces),
|
||
PairingProtocol.isValidFileName(rawName),
|
||
!rawName.hasPrefix("."),
|
||
let size = (object["size"] as? NSNumber)?.uint64Value,
|
||
let hash = (object["sha256"] as? String)?.lowercased(),
|
||
PairingProtocol.isValidSHA256(hash) else { return nil }
|
||
return PeerFileMeta(name: rawName, size: size, sha256: hash)
|
||
}
|
||
}
|
||
|
||
/// 隔空投送式点对点配对码(QFTP2P2)。
|
||
///
|
||
/// 与 QFTPAIR2/QFTSEND2 的关键区别:那两个是「连到某个 IP」,
|
||
/// 这个是「连到某个 Bonjour 服务实例,并用二维码里的预共享密钥做 TLS 认证」。
|
||
/// 二维码在这里充当带外信道——和隔空投送用 BLE 交换身份是同一个作用,
|
||
/// 只是我们把身份交换搬到了用户可见的扫码动作上,不需要任何配对弹窗。
|
||
///
|
||
/// 多文件时**文件清单不进二维码**,只放一个 SHA-256 摘要:
|
||
/// 十几个文件的元数据会让二维码密到扫不动。清单在 TLS 建立之后才传,
|
||
/// 接收端拿摘要比对——扫码这一下依然锁定了「你看到的就是你收到的」。
|
||
struct PeerPairing: Equatable {
|
||
static let prefix = "QFTP2P2:"
|
||
static let serviceType = "_qft-p2p._tcp"
|
||
|
||
let version: Int
|
||
/// 32 字节预共享密钥。既是 TLS-PSK,也是服务实例的唯一凭据。
|
||
let key: Data
|
||
/// Bonjour 服务实例名,由发送端随机生成
|
||
let instance: String
|
||
let senderName: String
|
||
/// 文件数与总字节数,用于扫码后立刻显示「3 个文件 · 1.2 GB」
|
||
let fileCount: Int
|
||
let totalSize: UInt64
|
||
/// 清单帧原始字节的 SHA-256(十六进制小写)
|
||
let queueDigest: String
|
||
/// 第一个文件名,纯展示用
|
||
let previewName: String
|
||
|
||
func encode() -> String {
|
||
let object: [String: Any] = [
|
||
"v": version,
|
||
"k": Base64URL.encode(key),
|
||
"i": instance,
|
||
"n": senderName,
|
||
"c": fileCount,
|
||
"z": NSNumber(value: totalSize),
|
||
"d": queueDigest,
|
||
"f": previewName,
|
||
]
|
||
let data = (try? JSONSerialization.data(withJSONObject: object)) ?? Data()
|
||
return Self.prefix + Base64URL.encode(data)
|
||
}
|
||
|
||
static func isPeerText(_ text: String) -> Bool { text.hasPrefix(prefix) }
|
||
|
||
static func parse(_ text: String) -> PeerPairing? {
|
||
guard text.hasPrefix(prefix), text.count <= 4096 else { return nil }
|
||
guard let data = Base64URL.decode(String(text.dropFirst(prefix.count))),
|
||
data.count <= 2048,
|
||
let object = (try? JSONSerialization.jsonObject(with: data)) as? [String: Any] else {
|
||
return nil
|
||
}
|
||
guard (object["v"] as? Int) == 2 else { return nil }
|
||
guard let keyText = object["k"] as? String,
|
||
let key = Base64URL.decode(keyText), key.count == 32 else { return nil }
|
||
guard let instance = object["i"] as? String, isValidInstance(instance) else { return nil }
|
||
guard let count = object["c"] as? Int, (1...512).contains(count) else { return nil }
|
||
guard let total = (object["z"] as? NSNumber)?.uint64Value else { return nil }
|
||
guard let digest = (object["d"] as? String)?.lowercased(),
|
||
PairingProtocol.isValidSHA256(digest) else { return nil }
|
||
|
||
let preview = (object["f"] as? String)?.trimmingCharacters(in: .whitespaces) ?? ""
|
||
guard preview.isEmpty || PairingProtocol.isValidFileName(preview) else { return nil }
|
||
|
||
return PeerPairing(
|
||
version: 2,
|
||
key: key,
|
||
instance: instance,
|
||
senderName: String(((object["n"] as? String) ?? "iPhone").prefix(80)),
|
||
fileCount: count,
|
||
totalSize: total,
|
||
queueDigest: digest,
|
||
previewName: String(preview.prefix(180))
|
||
)
|
||
}
|
||
|
||
/// Bonjour 实例名:只允许我们自己生成的字符集,避免把任意字符串
|
||
/// 交给 mDNS 解析。
|
||
static func isValidInstance(_ value: String) -> Bool {
|
||
guard (8...48).contains(value.count) else { return false }
|
||
for scalar in value.unicodeScalars {
|
||
switch scalar {
|
||
case "A"..."Z", "a"..."z", "0"..."9", "-": continue
|
||
default: return false
|
||
}
|
||
}
|
||
return true
|
||
}
|
||
|
||
static func newKey() -> Data {
|
||
var bytes = [UInt8](repeating: 0, count: 32)
|
||
_ = SecRandomCopyBytes(kSecRandomDefault, bytes.count, &bytes)
|
||
return Data(bytes)
|
||
}
|
||
|
||
static func newInstance() -> String {
|
||
let alphabet = Array("abcdefghijklmnopqrstuvwxyz0123456789")
|
||
var bytes = [UInt8](repeating: 0, count: 16)
|
||
_ = SecRandomCopyBytes(kSecRandomDefault, bytes.count, &bytes)
|
||
return "qft-" + String(bytes.map { alphabet[Int($0) % alphabet.count] })
|
||
}
|
||
}
|
||
|
||
/// 清单帧的编解码。
|
||
///
|
||
/// 摘要是对**帧的原始字节**取的,不是对重新序列化的结果——重新序列化
|
||
/// 会因为键顺序或数字格式的差异而算出不同的摘要,那种「几乎总是对」的
|
||
/// 校验在真机上迟早会咬人。
|
||
enum PeerQueue {
|
||
|
||
static func encode(sender: String, files: [PeerFileMeta]) throws -> Data {
|
||
let object: [String: Any] = ["v": 2, "sender": sender, "files": files.map(\.json)]
|
||
return try JSONSerialization.data(withJSONObject: object, options: [.sortedKeys])
|
||
}
|
||
|
||
static func decode(_ data: Data) -> (sender: String, files: [PeerFileMeta])? {
|
||
guard let object = (try? JSONSerialization.jsonObject(with: data)) as? [String: Any],
|
||
(object["v"] as? Int) == 2,
|
||
let rawFiles = object["files"] as? [[String: Any]], !rawFiles.isEmpty else { return nil }
|
||
var files: [PeerFileMeta] = []
|
||
for raw in rawFiles {
|
||
guard let file = PeerFileMeta.parse(raw) else { return nil }
|
||
files.append(file)
|
||
}
|
||
let sender = String(((object["sender"] as? String) ?? "iPhone").prefix(80))
|
||
return (sender, files)
|
||
}
|
||
|
||
static func digest(of data: Data) -> String {
|
||
SHA256.hash(data: data).map { String(format: "%02x", $0) }.joined()
|
||
}
|
||
}
|