Repository Public
1// Author: Simon-Pierre Boucher — contact@spboucher.ai2// File: SPChat/Features/Account/SystemPasskeyAuthenticator.swift3// Description: Passkey ceremonies through AuthenticationServices (Touch ID / iCloud Keychain / nearby device / security key). The app never sees biometric data.4import AppKit5import AuthenticationServices6import SPChatCore78/// System implementation of `PasskeyAuthenticator`. Requires the `webcredentials:<rp id>` associated domain and the9/// server's apple-app-site-association file; macOS shows its own sheet and performs user verification.10nonisolated final class SystemPasskeyAuthenticator: PasskeyAuthenticator, Sendable {11 func assert(_ request: AssertionRequest) async throws -> PasskeyAssertion {12 try await PasskeyCeremony.run { ceremony in13 let platform = ASAuthorizationPlatformPublicKeyCredentialProvider(relyingPartyIdentifier: request.rpId).createCredentialAssertionRequest(challenge: request.challenge)14 platform.userVerificationPreference = .required15 platform.allowedCredentials = request.allowCredentials.map { ASAuthorizationPlatformPublicKeyCredentialDescriptor(credentialID: $0) }16 let key = ASAuthorizationSecurityKeyPublicKeyCredentialProvider(relyingPartyIdentifier: request.rpId).createCredentialAssertionRequest(challenge: request.challenge)17 key.userVerificationPreference = .required18 key.allowedCredentials = request.allowCredentials.map { ASAuthorizationSecurityKeyPublicKeyCredentialDescriptor(credentialID: $0, transports: ASAuthorizationSecurityKeyPublicKeyCredentialDescriptor.Transport.allSupported) }19 ceremony.start([platform, key])20 } map: { credential in21 if let a = credential as? ASAuthorizationPlatformPublicKeyCredentialAssertion {22 return PasskeyAssertion(credentialId: a.credentialID, clientDataJSON: a.rawClientDataJSON, authenticatorData: a.rawAuthenticatorData, signature: a.signature, userHandle: a.userID, attachment: "platform")23 }24 if let a = credential as? ASAuthorizationSecurityKeyPublicKeyCredentialAssertion {25 return PasskeyAssertion(credentialId: a.credentialID, clientDataJSON: a.rawClientDataJSON, authenticatorData: a.rawAuthenticatorData, signature: a.signature, userHandle: a.userID, attachment: "cross-platform")26 }27 throw PasskeyError(.refused, "Type de clé d'accès inattendu.")28 }29 }3031 func register(_ request: RegistrationRequest) async throws -> PasskeyRegistration {32 try await PasskeyCeremony.run { ceremony in33 let r = ASAuthorizationPlatformPublicKeyCredentialProvider(relyingPartyIdentifier: request.rpId).createCredentialRegistrationRequest(challenge: request.challenge, name: request.userName, userID: request.userId)34 r.userVerificationPreference = .required35 r.excludedCredentials = request.excludeCredentials.map { ASAuthorizationPlatformPublicKeyCredentialDescriptor(credentialID: $0) }36 ceremony.start([r])37 } map: { credential in38 guard let c = credential as? ASAuthorizationPlatformPublicKeyCredentialRegistration, let att = c.rawAttestationObject else { throw PasskeyError(.refused, "L'appareil n'a pas fourni d'attestation.") }39 return PasskeyRegistration(credentialId: c.credentialID, clientDataJSON: c.rawClientDataJSON, attestationObject: att, transports: ["internal", "hybrid"], attachment: "platform")40 }41 }42}4344/// One ASAuthorizationController round trip, bridged to async/await.45private final class PasskeyCeremony: NSObject, ASAuthorizationControllerDelegate, ASAuthorizationControllerPresentationContextProviding {46 private var continuation: CheckedContinuation<ASAuthorizationCredential, Error>?47 private var controller: ASAuthorizationController?48 private static var active: PasskeyCeremony?4950 static func run<T: Sendable>(_ configure: @MainActor (PasskeyCeremony) -> Void, map: @MainActor (ASAuthorizationCredential) throws -> T) async throws -> T {51 if active != nil { throw PasskeyError(.cancelled, "Une vérification est déjà en cours.") }52 let ceremony = PasskeyCeremony(); active = ceremony53 defer { active = nil }54 let credential = try await withCheckedThrowingContinuation { (c: CheckedContinuation<ASAuthorizationCredential, Error>) in55 ceremony.continuation = c56 configure(ceremony)57 }58 return try map(credential)59 }6061 func start(_ requests: [ASAuthorizationRequest]) {62 let c = ASAuthorizationController(authorizationRequests: requests)63 c.delegate = self; c.presentationContextProvider = self64 controller = c65 c.performRequests()66 }6768 func presentationAnchor(for controller: ASAuthorizationController) -> ASPresentationAnchor {69 NSApp.keyWindow ?? NSApp.mainWindow ?? NSApp.windows.first { $0.isVisible } ?? ASPresentationAnchor()70 }7172 func authorizationController(controller: ASAuthorizationController, didCompleteWithAuthorization authorization: ASAuthorization) {73 continuation?.resume(returning: authorization.credential); continuation = nil74 }7576 func authorizationController(controller: ASAuthorizationController, didCompleteWithError error: Error) {77 continuation?.resume(throwing: Self.explain(error)); continuation = nil78 }7980 static func explain(_ error: Error) -> PasskeyError {81 let ns = error as NSError82 // diagnostic only: error domain, code and reason — never credentials or challenges83 NSLog("SPChat passkey error: domain=%@ code=%ld reason=%@", ns.domain, ns.code, (ns.userInfo[NSLocalizedFailureReasonErrorKey] as? String) ?? ns.localizedDescription)84 let detail = (ns.userInfo[NSLocalizedFailureReasonErrorKey] as? String ?? ns.localizedDescription).lowercased()85 if detail.contains("not associated with domain") || detail.contains("associated domain") || detail.contains("application identifier") {86 return PasskeyError(.config, "macOS n'a pas (encore) validé l'association entre cette application et le domaine des clés d'accès. Vérifie la connexion Internet, puis réessaie dans quelques minutes.")87 }88 guard let e = error as? ASAuthorizationError else { return PasskeyError(.refused, "La vérification n'a pas abouti.") }89 switch e.code {90 case .canceled: return PasskeyError(.cancelled, "Vérification annulée.")91 case .notInteractive: return PasskeyError(.cancelled, "La vérification demande une fenêtre active.")92 case .matchedExcludedCredential: return PasskeyError(.refused, "Ce Mac possède déjà une clé d'accès pour ce site.")93 case .notHandled, .failed, .invalidResponse, .unknown: return PasskeyError(.refused, "La vérification n'a pas abouti. Vérifie que Touch ID ou le trousseau iCloud est disponible.")94 default: return PasskeyError(.refused, "La vérification n'a pas abouti.")95 }96 }97}98