MacSentry, công cụ giám sát bảo mật máy Mac mã nguồn mở của mình, không có file chạy để tải về. Bạn clone repo, chạy ./build.sh, rồi cài một daemon chạy bằng root. Vì vậy mỗi lần cập nhật là một việc vặt: git pull, build, sudo ./daemon/install.sh, rồi thoát app và mở lại. Làm sao cho một app như vậy có nút "Cập nhật ngay", khi việc cập nhật cần trình biên dịch, cần quyền root, và cần thay chính cái app đang chạy?
Mình mất ba phiên bản để đi tới đó: 1.0 chưa kiểm tra cập nhật, 1.1 mở Terminal, 1.2 làm ngay trong app. Những chi tiết quyết định: hỏi GitHub Releases cho lịch sự, một hộp thoại mật khẩu qua AppleScript, thay bundle đang chạy, khởi động lại qua launchd mà không kích hoạt cảnh báo chống can thiệp của chính app, và những đoạn chữ đi vào shell trên đường đi.
Vì sao app không tải file chạy mới về
Phần lớn app Mac cập nhật bằng cách tải một bản build đã ký và notarize rồi thay vào. Bản phát hành của MacSentry chỉ có mã nguồn, và mỗi bản cài được build ngay trên máy sẽ chạy nó. Mình cố ý giữ như vậy: một công cụ giám sát chạy bằng root dễ tin hơn khi bạn đọc và tự build đúng thứ sẽ chạy.
Nên "cập nhật" chỉ có thể là những gì một người tự làm bằng tay trong thư mục mã nguồn:
git pull --ff-only./build.shđể build app, daemon và helper Endpoint Security- cài lại daemon bằng root, giữ nguyên cấu hình
- thay app đang chạy và mở bản mới
build.sh ghi thư mục đó vào Info.plist của app (MacSentrySourceDir). Nếu thư mục không còn, không phải repo git, hoặc không có build.sh chạy được, nút sẽ mở trang phát hành.
Mỗi ngày hỏi GitHub Releases một lần
Phép kiểm gọi endpoint bản phát hành mới nhất của REST API. GitHub định nghĩa bản mới nhất là bản gần nhất không phải pre-release và không phải draft, nên draft và pre-release bị lọc ngay từ phía GitHub. Rút gọn từ Sources/Updater.swift:
var req = URLRequest(url: Self.latestURL, timeoutInterval: 15)
req.setValue("application/vnd.github+json", forHTTPHeaderField: "Accept")
req.setValue("MacSentry/\(Self.currentVersion)", forHTTPHeaderField: "User-Agent")
Hướng dẫn bắt đầu của GitHub ghi rằng mọi request tới API phải có header User-Agent hợp lệ, và gợi ý dùng tên ứng dụng.
Phần còn lại là để tốn ít và im lặng:
- Đồng hồ chạy mỗi giờ, nhưng mỗi ngày chỉ kiểm tra tối đa một lần. Máy Mac ngủ qua đêm, và một đồng hồ 24 giờ mới chạy một lần có thể chạy rất lâu sau lúc lẽ ra phải kiểm tra. Đồng hồ mỗi giờ, chỉ kiểm tra khi lần thành công trước đã cách một ngày, sẽ bắt kịp ngay sau khi máy thức.
- Đợi 30 giây sau khi mở app. Lúc đăng nhập, mạng thường chưa sẵn sàng.
- 404 nghĩa là "chưa có bản phát hành", không phải lỗi. Cài đặt ghi "mới nhất", không hiện lỗi màu đỏ.
- Mỗi phiên bản chỉ báo một lần. Bản bạn bỏ qua sẽ không nhắc mỗi ngày. Kiểm tra do bạn tự bấm thì hiện kết quả trong Cài đặt và không gửi thông báo.
Phiên bản được so theo từng phần số (1.10.0 mới hơn 1.9.0) và bỏ phần sau dấu -, nên 1.2.0-beta bằng 1.2.0. Điều đó chỉ ổn vì endpoint này không bao giờ trả về pre-release.
Một hộp thoại quản trị với do shell script
Bản 1.1 chỉ ghi các lệnh vào file update.command rồi mở nó trong Terminal, nơi bạn tự gõ mật khẩu sudo. Ở bản 1.2, app tự chạy các bước, và bước duy nhất cần root là cài lại daemon. Technical Note TN2065 của Apple ghi cách chuẩn để chạy một lệnh shell bằng root từ app: do shell script của AppleScript kèm with administrator privileges, hiện hộp thoại mật khẩu của hệ thống. Rút gọn từ Sources/DaemonInstaller.swift:
let cmd = "SUDO_USER=\(Shell.quote(user)) \(Shell.quote(dir + "/daemon/install.sh")) --auto 2>&1"
let source = "do shell script \"\(cmd.replacingOccurrences(of: "\\", with: "\\\\").replacingOccurrences(of: "\"", with: "\\\""))\""
+ " with prompt \"\(L("MacSentry cần quyền quản trị để cài daemon giám sát."))\" with administrator privileges"
var err: NSDictionary?
// NSAppleScript (không phải osascript) để hộp thoại mang tên MacSentry; do shell script không cần quyền Tự động hoá
let out = NSAppleScript(source: source)?.executeAndReturnError(&err)
if let err {
if (err[NSAppleScript.errorNumber] as? Int) == -128 { return L("Đã huỷ") }
return err[NSAppleScript.errorMessage] as? String ?? L("Cài daemon lỗi")
}
Ba chi tiết trong mấy dòng đó:
- Hai lớp quote. Lệnh là một chuỗi shell nằm trong một chuỗi AppleScript.
Shell.quotebọc mỗi giá trị trong dấu nháy đơn (dấu'viết thành'\'') cho shell. Sau đó dấu gạch ngược và nháy kép được escape cho AppleScript. Bỏ một trong hai lớp là một tên thư mục có dấu nháy đủ để đổi lệnh. TN2065 khuyên dùngquoted form ofkhi chuỗi được ghép trong AppleScript. Ở đây chuỗi được ghép trong Swift, nên code Swift làm đúng việc đó. NSAppleScripttrong app, không phải/usr/bin/osascript. Chạy trong tiến trình của app thì hộp thoại mật khẩu mang tên MacSentry, vàdo shell scriptkhông cần quyền Tự động hoá vì nó không nói chuyện với app khác.- Lỗi -128 là Huỷ, hiện là "Đã huỷ", không phải lỗi.
install.sh có thêm chế độ --auto cho việc này: không hỏi gì, giữ nguyên /etc/macsentry.conf cũ. Nó cũng tự bật khi stdin không phải terminal ([ -t 0 ] || AUTO=1), vì script chạy qua do shell script không có ai trả lời câu hỏi.
Mỗi bước lỗi là dừng, và app đang chạy được thay sau cùng
Việc cập nhật chạy trên một hàng đợi nền và trả về lỗi đầu tiên gặp phải (rút gọn):
var r = Shell.run("/usr/bin/git", ["pull", "--ff-only"], in: dir)
guard r.ok else { return L("git pull lỗi: %@", r.tail) }
r = Shell.run(dir + "/build.sh", ["--no-install"], in: dir)
guard r.ok else { return L("Build lỗi: %@", r.tail) }
if let e = DaemonInstaller.runScript(dir) { return e }
return Self.replaceApp(with: dir + "/build/MacSentry.app")
Thứ tự chính là tính an toàn. Pull lỗi (có thay đổi cục bộ, nhánh đã rẽ: --ff-only từ chối merge) hay build lỗi thì dừng trước khi bất cứ thứ gì đã cài bị đổi, và ba dòng output cuối hiện trong Cài đặt. Lỗi trước bước cài daemon thì mọi thứ đã cài vẫn y nguyên, app cũ vẫn chạy. Lỗi ở bước cuối thì daemon đã là bản mới, còn app cũ vẫn chạy bên cạnh. Trường hợp nào thì thư mục mã nguồn cũng có thể đã ở commit mới.
Thay bundle đang chạy
Thay vì chép đè lên app cũ, việc sẽ để lại một lúc app nửa cũ nửa mới, bản build mới được chép ra cạnh nó dưới một tên tạm rồi mới đổi chỗ (rút gọn):
let tmp = dest.deletingLastPathComponent().appendingPathComponent(".MacSentry-update.app")
try? fm.removeItem(at: tmp)
try fm.copyItem(at: src, to: tmp)
_ = try fm.replaceItemAt(dest, withItemAt: tmp)
Apple mô tả replaceItemAt là thay item tại một URL theo cách bảo đảm không mất dữ liệu. Để bản tạm trong cùng thư mục giữ cho việc đổi chỗ nằm trên cùng một volume. Tiến trình đang chạy tiếp tục chạy code đã nạp, và nó khởi động lại ngay sau khi đổi chỗ, nên gần như không có cơ hội nạp nhầm thứ gì từ bundle mới.
Khởi động lại qua launchd mà không báo động nhầm
App được giữ sống bởi một job launchd theo user, với KeepAlive đặt SuccessfulExit: false. Trang man launchd.plist định nghĩa true là job được chạy lại khi chương trình thoát với mã 0, và false là ngược lại: launchd chạy lại app mỗi khi nó thoát với mã khác 0. Đó là một phần của việc làm cho công cụ giám sát khó bị tắt lặng lẽ, và nó cũng cho việc khởi động lại miễn phí:
static func relaunch() {
UserDefaults.standard.set(currentVersion, forKey: updatedFromKey)
UserDefaults.standard.synchronize()
Monitor.stopHelper()
if LaunchAtLogin.runningUnderLaunchd { exit(1) }
NSWorkspace.shared.openApplication(at: URL(fileURLWithPath: Bundle.main.bundlePath), configuration: .init()) { _, _ in exit(0) }
}
exit(1) khiến launchd chạy lại file ở cùng đường dẫn, giờ đã là bản mới. Gọi exit trực tiếp cũng bỏ qua applicationWillTerminate, và điều đó quan trọng: handler đó gửi "MacSentry (app) đã bị tắt" về Telegram, vì một công cụ giám sát bị tắt thì phải lên tiếng. Cập nhật là một lần tắt do chính bạn yêu cầu, và nó không nên trông giống bị can thiệp.
Trước khi thoát, app lưu phiên bản đang cập nhật từ đó. Tiến trình mới thấy khoá này lúc khởi động, xoá nó, và nếu phiên bản của chính nó khác đi thì hiện một thông báo ("Đã cập nhật MacSentry 1.2.0") nói rằng cài đặt được giữ nguyên. Nếu bản build không đổi phiên bản thì không hiện gì.
Chữ đi vào shell hay AppleScript
Một app chạy được script bằng root chỉ an toàn bằng chỗ yếu nhất nơi chữ biến thành code. Hai trong ba fix dưới đây có từ đợt gia cố trước bản 1.0, fix thứ ba đi cùng chế độ cài --auto của bản 1.2:
Nội dung thông báo đi qua tham số. Khi chưa có quyền thông báo, app dùng
osascriptvớidisplay notification. Nội dung đó trước đây được ghép thẳng vào mã AppleScript, mà nội dung cảnh báo lại chứa những thứ kẻ tấn công điều khiển được, như tên tiến trình và tên file. Giờ nó đi quaargv, nên không phần nào bị chạy như script:p.arguments = ["-e", "on run argv", "-e", "display notification (item 1 of argv) with title (item 2 of argv) sound name \"Sosumi\"", "-e", "end run", body.replacingOccurrences(of: "\n", with: " "), title]Trang man osascript ghi rằng các tham số sau script được truyền thành một danh sách chuỗi cho run handler. Đó là giá trị script đọc, không bao giờ là mã nó biên dịch.
Kiểm tra trước khi đưa vào
sed, và không chỉ ở đó. Ở chế độ--auto, khi cấu hình của daemon đã có sẵn,install.shđiền token Telegram của app bằngsed, chỉ khi token và chat ID khớp^[A-Za-z0-9:_-]+$. Một giá trị có|mà lọt qua sẽ viết lại biểu thứcsed. Ở bản 1.2.0, cấu hình mới tinh được ghi bằngprintfvà không có phép kiểm này, nên một ký tự xuống dòng trong file cài đặt của app có thể thêm một dòng nhưES_EXEC=0vào file cấu hình thuộc root. Một bản sửa chưa phát hành giờ kiểm các giá trị này trước cả hai cách ghi.File riêng tư ngay từ byte đầu tiên. File token trước đây được ghi với quyền mặc định rồi mới đổi sang 0600, để lại một khoảnh khắc user khác đọc được. Giờ thư mục dữ liệu được tạo với quyền 0700, và mỗi file được ghi ra một file tạm quyền 0600 rồi đổi tên vào chỗ.
Những gì thiết kế này vẫn đang tin
- Remote git. Bản cập nhật chạy bất cứ thứ gì
git pullmang về. Không có gì kiểm chữ ký của commit hay tag. Ai kiểm soát repo, hoặc tài khoản GitHub, là kiểm soát bản build tiếp theo.git verify-tagvới một khoá đã biết sẽ chặn được chỗ này, và nó chưa được làm. - Một thư mục do user sở hữu. Thư mục mã nguồn thuộc về user, và hộp thoại quản trị chạy
install.shtừ đó bằng root. Mã độc chạy bằng user có thể sửa script đó, đợi lần cập nhật tới, rồi nhận quyền root từ chính mật khẩu bạn gõ. Điều này vốn đã đúng vớisudo ./daemon/install.shgõ tay, nhưng một hộp thoại quen thuộc từ một app mình tin thì dễ bấm đồng ý mà không nghĩ. Chép script và file chạy sang một thư mục thuộc root trước khi chạy sẽ thu hẹp khe hở đó. - Quyền chỉ được giữ khi có chứng chỉ thật.
build.shký bằng chứng chỉ Apple Development nếu máy có. Không có thì bản build được ký ad-hoc, macOS coi mỗi bản build là một danh tính mới, và Full Disk Access cùng Mạng cục bộ phải cấp lại sau mỗi lần cập nhật, dù thông báo nói cài đặt được giữ nguyên. - Phép kiểm bản phát hành chỉ để thông báo. Nó chỉ quyết định khi nào hiện nút. Code được chạy đến từ nhánh, không phải từ tag mà GitHub báo.
Không giới hạn nào mới xuất hiện cùng cái nút, nhưng cái nút khiến chúng dễ bị quên hơn.
Tóm tắt
- App build từ mã nguồn vẫn tự cập nhật được: pull, build, cài lại phần chạy bằng root, thay app, khởi động lại. Thứ tự quan trọng: lỗi trước bước root thì không thứ gì đã cài bị đổi.
- Gọi endpoint bản phát hành mới nhất của GitHub với
User-Agentcó tên app, kiểm mỗi giờ nhưng tối đa một lần mỗi ngày sau lần thành công, coi 404 là "chưa có bản phát hành", và mỗi phiên bản chỉ báo một lần. do shell script ... with administrator privilegesquaNSAppleScriptcho một hộp thoại mật khẩu hệ thống mang tên app. Quote cho shell, rồi escape cho AppleScript, và coi lỗi -128 là Huỷ.- Chép bundle mới ra cạnh bản cũ rồi đổi chỗ bằng
replaceItemAt. - Với
KeepAlivevàSuccessfulExit: false,exit(1)chính là khởi động lại. Bỏ quaapplicationWillTerminateđể một lần khởi động lại có chủ đích không trông giống bị can thiệp. - Truyền chữ do người khác tác động được cho
osascriptquaargv, kiểm tra giá trị trước khi đưa vàosed, và tạo file bí mật với đúng quyền cuối cùng ngay từ đầu. - Bước chạy bằng root vẫn đang tin remote git và một thư mục do user sở hữu. Tag có chữ ký và một thư mục trung gian thuộc root là các bước tiếp theo.
Nếu bạn từng làm tính năng tự cập nhật cho một công cụ Mac cần quyền root, nhất là khi không có bản build đã notarize, mình rất muốn được trao đổi. Email của mình ở trang chủ.
