Phase 6: Lüftersteuerung über privilegierten Helfer
Das Sicherheitsnetz kommt zuerst und liegt als reine Funktion vor — 17 Tests, kein Hardwarezugriff nötig. Es sitzt im Helfer, nicht in der Oberfläche: die kann abstürzen, hängen oder beendet sein, während die Lüfter auf einem festen Wert stehen. Genau dafür ist es da. Vier Regeln, nicht abschaltbar: nie unter das Firmware-Minimum, Rückfall auf Automatik ab 95 °C, Rückfall wenn der Herzschlag fünf Sekunden ausbleibt, Rückfall beim Beenden. Ohne lesbare Temperatur wird gar nicht gesteuert — blind eine feste Drehzahl zu halten wäre die falsche Antwort auf fehlende Information. Die App sagt dem Helfer NICHT, wie warm es ist. Er misst selbst. Sonst hinge das Netz an der Ehrlichkeit eines Prozesses, der abstürzen, hängen oder — bei einer manipulierten Kopie — schlicht lügen kann. Der Herzschlag sagt nur "ich lebe noch". Der Helfer entscheidet jede Sekunde neu, nicht nur beim Setzen: nur so greifen Wachhund und Temperaturwächter auch dann, wenn von der App nie wieder etwas kommt. Geschrieben wird nur bei Änderung — jeder SMC-Schreibvorgang ist ein Eingriff. Der Schreibpfad existiert ausschließlich im Helfer, als eigene Kopie statt geteilter Bibliothek. Was im App-Prozess nicht vorhanden ist, kann dort auch nicht versehentlich aufgerufen werden. XPC prüft die Signatur in BEIDE Richtungen. Ohne das könnte jedes Programm auf dem Rechner die Lüfter eines root-Dienstes steuern — der Mach-Dienst ist systemweit sichtbar. Drei Fallstricke beim Einbetten, alle nachgemessen: Xcode signiert Kommandozeilenprogramme unter dem Dateinamen. Der Helfer hieß damit "OnyxHelper" statt com.scarriffleservices.onyx.helper, und die App hätte ihren eigenen Helfer abgelehnt. Behoben über eine in die Binary eingebettete Info.plist (CREATE_INFOPLIST_SECTION_IN_BINARY). Der Build-Schritt läuft nach Xcodes Signatur; das Kopieren bricht das Siegel des App-Bundles. Also wird zum Schluss neu signiert — mit denselben Entitlements, sonst gingen App-Group, WeatherKit und die TCC-Berechtigungen verloren. Mit deklarierten outputFiles übersprang Xcode den Schritt, obwohl sich das Programm geändert hatte. Geprüft: App-Siegel gültig (deep), beide Signaturanforderungen erfüllt, alle sieben Entitlements erhalten. 162 Tests grün.
This commit is contained in:
Guido Schmit
163
Onyx/FanControl.swift
Normal file
163
Onyx/FanControl.swift
Normal file
@@ -0,0 +1,163 @@
|
||||
import Foundation
|
||||
import ServiceManagement
|
||||
import OSLog
|
||||
import OnyxHelperProtocol
|
||||
|
||||
private let log = Logger(subsystem: "com.scarriffleservices.onyx", category: "FanControl")
|
||||
|
||||
/// Die App-Seite der Lüftersteuerung.
|
||||
///
|
||||
/// Sie darf **wünschen**, nicht bestimmen. Ob eine Drehzahl gesetzt wird,
|
||||
/// entscheidet allein das Sicherheitsnetz im Helfer — mit Temperaturen, die er
|
||||
/// selbst misst. Diese Klasse hält nur die Verbindung und den Herzschlag.
|
||||
@MainActor
|
||||
@Observable
|
||||
public final class FanControl {
|
||||
|
||||
public enum InstallState: Equatable {
|
||||
case notInstalled
|
||||
case requiresApproval
|
||||
case installed
|
||||
case failed(String)
|
||||
}
|
||||
|
||||
public private(set) var installState: InstallState = .notInstalled
|
||||
public private(set) var report: FanStatusReport?
|
||||
public private(set) var lastError: String?
|
||||
|
||||
private var connection: NSXPCConnection?
|
||||
private var heartbeatTimer: Timer?
|
||||
private var statusTimer: Timer?
|
||||
|
||||
private var service: SMAppService {
|
||||
SMAppService.daemon(plistName: "com.scarriffleservices.onyx.helper.plist")
|
||||
}
|
||||
|
||||
public init() { refreshInstallState() }
|
||||
|
||||
// MARK: - Einrichtung
|
||||
|
||||
public func refreshInstallState() {
|
||||
switch service.status {
|
||||
case .enabled: installState = .installed
|
||||
case .requiresApproval: installState = .requiresApproval
|
||||
case .notRegistered, .notFound: installState = .notInstalled
|
||||
@unknown default: installState = .notInstalled
|
||||
}
|
||||
}
|
||||
|
||||
/// Registriert den Helfer. macOS fragt dabei nach Zustimmung.
|
||||
public func install() {
|
||||
do {
|
||||
try service.register()
|
||||
refreshInstallState()
|
||||
log.notice("Helfer registriert: \(String(describing: self.installState))")
|
||||
} catch {
|
||||
// `requiresApproval` kommt hier als Fehler an und ist keiner: der
|
||||
// Nutzer muss den Dienst nur noch in den Systemeinstellungen
|
||||
// freigeben.
|
||||
refreshInstallState()
|
||||
if installState != .requiresApproval {
|
||||
installState = .failed(error.localizedDescription)
|
||||
log.error("Helfer nicht registrierbar: \(error.localizedDescription, privacy: .public)")
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// Entfernt den Helfer wieder. Die Lüfter fallen dabei auf Automatik.
|
||||
public func uninstall() async {
|
||||
for fan in report?.fans ?? [] { setAutomatic(index: fan.index) }
|
||||
disconnect()
|
||||
try? await service.unregister()
|
||||
refreshInstallState()
|
||||
}
|
||||
|
||||
/// Öffnet die Stelle, an der macOS den Dienst freigeben lässt.
|
||||
public func openApprovalSettings() {
|
||||
SMAppService.openSystemSettingsLoginItems()
|
||||
}
|
||||
|
||||
// MARK: - Verbindung
|
||||
|
||||
private func proxy() -> OnyxHelperProtocol? {
|
||||
if connection == nil {
|
||||
let connection = NSXPCConnection(machServiceName: OnyxHelper.machServiceName,
|
||||
options: .privileged)
|
||||
connection.remoteObjectInterface = NSXPCInterface(with: OnyxHelperProtocol.self)
|
||||
// In beide Richtungen prüfen: die App spricht nur mit einem Helfer,
|
||||
// der ebenso signiert ist wie sie. Sonst könnte ein untergeschobener
|
||||
// Dienst unter demselben Namen die Antworten liefern.
|
||||
try? connection.setCodeSigningRequirement(OnyxHelper.helperRequirement)
|
||||
|
||||
connection.invalidationHandler = { [weak self] in
|
||||
Task { @MainActor in self?.connection = nil }
|
||||
}
|
||||
connection.interruptionHandler = { [weak self] in
|
||||
Task { @MainActor in self?.connection = nil }
|
||||
}
|
||||
connection.resume()
|
||||
self.connection = connection
|
||||
}
|
||||
return connection?.remoteObjectProxyWithErrorHandler { [weak self] error in
|
||||
Task { @MainActor in
|
||||
self?.lastError = error.localizedDescription
|
||||
log.error("Helfer nicht erreichbar: \(error.localizedDescription, privacy: .public)")
|
||||
}
|
||||
} as? OnyxHelperProtocol
|
||||
}
|
||||
|
||||
private func disconnect() {
|
||||
heartbeatTimer?.invalidate(); heartbeatTimer = nil
|
||||
statusTimer?.invalidate(); statusTimer = nil
|
||||
connection?.invalidate(); connection = nil
|
||||
report = nil
|
||||
}
|
||||
|
||||
/// Beginnt zu beobachten und den Herzschlag zu senden.
|
||||
///
|
||||
/// Der Herzschlag ist die Lebensversicherung: bleibt er aus — weil Onyx
|
||||
/// abstürzt, beendet wird oder hängt — fallen die Lüfter im Helfer nach
|
||||
/// fünf Sekunden auf Automatik zurück.
|
||||
public func start() {
|
||||
guard installState == .installed, heartbeatTimer == nil else { return }
|
||||
|
||||
heartbeatTimer = Timer.scheduledTimer(withTimeInterval: 2, repeats: true) { _ in
|
||||
MainActor.assumeIsolated { [weak self] in
|
||||
self?.proxy()?.heartbeat { _ in }
|
||||
}
|
||||
}
|
||||
statusTimer = Timer.scheduledTimer(withTimeInterval: 2, repeats: true) { _ in
|
||||
MainActor.assumeIsolated { [weak self] in self?.refreshStatus() }
|
||||
}
|
||||
refreshStatus()
|
||||
}
|
||||
|
||||
public func stop() { disconnect() }
|
||||
|
||||
private func refreshStatus() {
|
||||
proxy()?.fanStatus { [weak self] data in
|
||||
Task { @MainActor in self?.apply(data) }
|
||||
}
|
||||
}
|
||||
|
||||
private func apply(_ data: Data?) {
|
||||
guard let data, let decoded = try? JSONDecoder().decode(FanStatusReport.self, from: data)
|
||||
else { return }
|
||||
report = decoded
|
||||
lastError = nil
|
||||
}
|
||||
|
||||
// MARK: - Steuern
|
||||
|
||||
public func setTarget(index: Int, rpm: Double) {
|
||||
proxy()?.setFan(index: index, targetRPM: rpm) { [weak self] data in
|
||||
Task { @MainActor in self?.apply(data) }
|
||||
}
|
||||
}
|
||||
|
||||
public func setAutomatic(index: Int) {
|
||||
proxy()?.setFanAutomatic(index: index) { [weak self] data in
|
||||
Task { @MainActor in self?.apply(data) }
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user