feat(ios): device client-cert mTLS — ClientTLS package, transport wiring, install UX (C-iOS)

- ios/Packages/ClientTLS: SecIdentity wrapper, PKCS12 importer (typed errors), keychain store
  (AfterFirstUnlockThisDeviceOnly), pure MutualTLSChallengeResponder truth table, cross-platform
  X.509 DER summary. 14/14 tests.
- Both transports (SessionCore URLSessionTermTransport, App URLSessionHTTPTransport) + SessionThumbnail
  take a lazy @Sendable ()->ClientIdentity? provider: WS resolves per-connect, HTTP per client-cert
  challenge, so a freshly-imported cert applies without an app relaunch. AppEnvironment injects
  { store.loadedIdentityOrNil() }.
- ClientCertScreen (.fileImporter([.pkcs12]) + passphrase -> import -> keychain), reachable via a
  设备证书 entry in SessionListScreen.hostMenu. PairingViewModel gates tunnel-host probes on cert
  presence and re-maps mTLS-reject to a clientCertRejected message.
Verified: ClientTLS 14/14, SessionCore 93/93, xcodegen + xcodebuild BUILD SUCCEEDED.
This commit is contained in:
Yaojia Wang
2026-07-07 09:42:12 +02:00
parent 5337281e85
commit e38e6d1689
25 changed files with 1510 additions and 30 deletions

View File

@@ -243,6 +243,29 @@ struct URLSessionTermTransportTests {
await connection.close()
}
@Test("identity provider is resolved PER CONNECT (no-relaunch pickup, not captured once)")
func identityProviderResolvedPerConnect() async throws {
// A cert imported mid-run must take effect on the NEXT connection. The
// transport therefore re-consults its provider on every `connect` rather
// than capturing a snapshot proven here by a provider whose invocation
// count grows once per connect (nil identity: ScriptedWSServer is plain
// ws, so the connection succeeds regardless).
let (server, endpoint) = try await Self.startServer()
defer { server.stop() }
let calls = CallCounter()
let transport = URLSessionTermTransport(identityProvider: {
calls.increment()
return nil
})
let first = try await transport.connect(to: endpoint)
await first.close()
let second = try await transport.connect(to: endpoint)
await second.close()
#expect(calls.value == 2)
}
@Test("connect to a dead port throws (handshake failure path, no hang)")
func connectToDeadPortThrows() async throws {
let server = ScriptedWSServer()
@@ -254,5 +277,14 @@ struct URLSessionTermTransportTests {
_ = try await URLSessionTermTransport().connect(to: endpoint)
}
}
/// Thread-safe invocation counter for the `@Sendable` identity provider
/// (URLSession may consult it off the test's isolation domain).
private final class CallCounter: @unchecked Sendable {
private let lock = NSLock()
private var count = 0
func increment() { lock.withLock { count += 1 } }
var value: Int { lock.withLock { count } }
}
}
#endif