TEESimulator: mô phỏng keystore Android
TEESimulator xứng đáng có chỗ trên thiết bị của một researcher. Nó làm một việc với độ chính xác đặc biệt: tạo ra attestation chain mà về mặt cấu trúc đã nhất quán từ trong ra, vì chúng đến từ cùng một reference TA có sẵn trong AOSP. Điều đó quan trọng khi bạn đang test code verify chain, không chỉ flag cuối cùng. Điểm trừ là keybox — bạn phải tự cung cấp, và đến khi có nó thì interceptor mới hoạt động. Với researcher bảo mật và dev cần đúng cái khả năng này, nó là con đường trực tiếp nhất; còn không thì công setup không đáng.
TEESimulator là gì?
TEESimulator là module Magisk mô phỏng key pair và attestation dựa trên phần cứng trên Android. Nó inject native library vào keystore daemon lúc boot, chặn request từ các app được cấu hình, và phục vụ chúng qua KeyMint chạy trong software nhưng nằm trong process keystore thật. Attestation certificate nó tạo được ký bằng keybox do người dùng cung cấp, và phần còn lại của hệ thống không hề hay biết.
Cách nó hook vào keystore của Android
- ✓Hook vào keystore2 (Android 12+) qua PLT-hook trên AIBinder_transact, và vào keystore daemon cũ (Android 10/11) qua ioctl hook trên libbinder
- ✓Route request theo từng lời gọi: app target đi vào KeyMint mô phỏng; mọi thứ khác chuyển tiếp sang phần cứng thật không đổi
- ✓Tạo attestation chain từ KeyMint TA tham chiếu của AOSP (kmr-ta) dùng BoringSSL, ký bằng keybox của user — nhất quán từ trong ra theo thiết kế
- ✓Đóng băng các giá trị root-of-trust của thiết bị thật (verified-boot key, device-locked flag) từ lúc harvest lúc boot để các key đã lưu vẫn giải mã được
- ✓Cấu hình theo profile gán app vào named bundle với keybox, patch level, OS version, và device identity riêng
- ✓WebUI (KernelSU/APatch) quản lý profile, kiểm tra key đã lưu, và flash canary build tại chỗ
- ✓An toàn khi chưa cấu hình: không có keybox thì interceptor đơn giản là không làm gì, thiết bị vẫn hoạt động bình thường
Bạn có thể làm gì với TEESimulator
- •Researcher bảo mật test cách app diễn giải kết quả attestation mà không cần thiết bị certified
- •Dev debug code attestation verification của chính mình trước khi ship
- •Audit app kiểm tra toàn bộ certificate chain, không chỉ flag PASS/FAIL
- •Tạo attestation parameters có kiểm soát (patch level, OS version, device identity) cho fuzzing
- •Chạy test suite phụ thuộc attestation trong CI với thiết bị đã root
Cài đặt TEESimulator
Flash module zip qua Magisk, KernelSU, hoặc APatch rồi reboot. Đặt keybox.xml chứa RSA và ECDSA private key tại /data/adb/teesim/keybox.xml. Tạo hoặc sửa /data/adb/teesim/config.json để liệt kê target app dưới một named profile, hoặc dùng WebUI để cấu hình trực quan. Daemon theo dõi thư mục config và áp dụng thay đổi ngay, không cần reboot sau khi sửa.
Điểm mạnh
- ✓Dùng KeyMint TA tham chiếu thật của AOSP chứ không phải reimplementation, nên attestation chain khớp với TEE thật
- ✓Route theo từng app nên phần còn lại của hệ thống — app ngân hàng, payment handler — vẫn dùng khóa phần cứng chính hãng
- ✓Profile system hỗ trợ nhiều keybox và device identity set cho các app khác nhau cùng lúc
- ✓Giá trị root-of-trust được harvest từ phần cứng thật, giữ cho các key đã lưu vẫn giải mã được qua các lần reboot
- ✓Tác động nhỏ: interceptor vô hiệu nếu không có keybox, và có thể khôi phục bằng cách kill keystore daemon
Yêu cầu và hạn chế
- △Yêu cầu root và thiết bị 64-bit (arm64-v8a hoặc x86_64) chạy Android 10 trở lên
- △Bạn phải tự tìm và quản lý keybox của mình với RSA và ECDSA key — module không cung cấp sẵn
- △Build từ source cần Android SDK (cho aidl) và NDK; không có prebuilt release chính thức
- △App verify attestation qua Play Integrity API chứ không phải query keystore trực tiếp sẽ không bị ảnh hưởng
- △Không hỗ trợ Android phiên bản dưới 10
TEESimulator so với các công cụ khác như thế nào
Câu hỏi thường gặp
Có. Nó hook vào entry point khác nhau tùy phiên bản: AIBinder_transact trong keystore2 trên Android 12+, và ioctl trên libbinder trong keystore daemon cũ trên Android 10 và 11. Cả hai đường đi đều dẫn đến KeyMint TA tham chiếu và ký bằng keybox giống nhau.
PlayIntegrityFix patch Play Services và Play Store trả về kết quả PASS mà không đụng đến TEE. TEESimulator tạo attestation certificate chain thật từ KeyMint TA, nên app verify toàn bộ chain sẽ nhận được thứ cấu trúc giống hệt như thiết bị certified tạo ra.
Có, root là bắt buộc. Module inject native library vào keystore daemon lúc boot, cần privileged access. Nó hoạt động với Magisk, KernelSU, và APatch.
TEESimulator load KeyMint TA tham chiếu của AOSP (kmr-ta) vào keystore process và ký attestation chain bằng keybox do người dùng cung cấp. Vì dùng cùng code path như TEE thật, certificate nhất quán từ trong ra theo thiết kế.
TEESimulator nhắm vào hardware-backed key attestation ở cấp keystore. Nó không ảnh hưởng trực tiếp đến Play Integrity API check mà Play Services thực hiện, vì chúng đi đường khác. Việc có giúp được với licensing hay không tùy thuộc app đó validate attestation kiểu gì.
Không có keybox hợp lệ thì interceptor cứ thế không làm gì và thiết bị hoạt động bình thường. Nếu có sự cố, kill keystore daemon buộc restart sạch không có interception cho đến khi daemon được re-inject.
Vấn đề mà nó giải quyết
Muốn test xem một app xử lý attestation kiểu gì thì thường gặp trở ngại từ phần cứng. Thiết bị thật báo gì thì báo nấy; emulator có khi không implement KeyMint luôn. Bạn cần tạo được attestation chain đáng tin với các tham số kiểm soát được (patch level, verified-boot state, device identity) mà không cần thiết bị certified, và chain đó phải chịu được scrutiny từ app validate toàn bộ certificate path.
Ai nên thử — và ai nên bỏ qua
Researcher bảo mật và dev cần test hành vi app phụ thuộc attestation với độ trung thực certificate chain đầy đủ. Nếu bạn đang audit code validate attestation ngoài check PASS đơn giản, TEESimulator cho bạn simulation chính xác nhất trên một thiết bị duy nhất. Bỏ qua nó nếu bạn chỉ cần truy cập Play Store — use case đó phục vụ tốt hơn bằng patch đơn giản hơn nhiều, và việc tìm keybox hợp lệ cũng không dễ.
Repo liên quan
Muốn nghe thêm một ý kiến về TEESimulator?
Hỏi một AI đọc được trang này — một cú bấm là có ngay nhận định về TEESimulator.
