Repository Public
1import Foundation23/// What the platform authenticator returns when a passkey is created.4struct PasskeyRegistration: Sendable {5 var credentialID: Data6 var clientDataJSON: Data7 var attestationObject: Data8}910/// What the platform authenticator returns when a passkey signs a challenge.11struct PasskeyAssertion: Sendable {12 var credentialID: Data13 var clientDataJSON: Data14 var authenticatorData: Data15 var signature: Data16 var userHandle: Data?17}1819enum PasskeyError: Error, Equatable, LocalizedError {20 case cancelled21 case notAvailable22 case failed(String)2324 var errorDescription: String? {25 switch self {26 case .cancelled: return L("The passkey request was cancelled.")27 case .notAvailable: return L("Passkeys are not available on this device.")28 case .failed(let message): return message29 }30 }31}3233/// Performs WebAuthn ceremonies with the system authenticator (Touch ID, Face ID, device passcode, security key).34/// The app implements it with AuthenticationServices; tests use a software authenticator with real ES256 signatures.35/// Biometric data never reaches this code: the system only returns signed responses.36protocol PasskeyAuthorizer: Sendable {37 func register(challenge: Data, relyingParty: String, userID: Data, userName: String) async throws -> PasskeyRegistration38 /// `allowedCredentials` empty = any passkey of this relying party (the passkey identifies the account).39 func assert(challenge: Data, relyingParty: String, allowedCredentials: [Data]) async throws -> PasskeyAssertion40}4142/// The WebAuthn JSON shapes exchanged with the backend (base64url fields, as in the W3C JSON serialization).43enum WebAuthnJSON {44 struct RegistrationOptions: Decodable, Sendable {45 struct User: Decodable, Sendable { var id: String; var name: String; var displayName: String }46 struct RP: Decodable, Sendable { var id: String?; var name: String }47 var challenge: String48 var rp: RP49 var user: User50 }5152 struct AuthenticationOptions: Decodable, Sendable {53 struct Allowed: Decodable, Sendable { var id: String }54 var challenge: String55 var rpId: String?56 var allowCredentials: [Allowed]?57 }5859 struct Credential: Encodable, Sendable {60 struct Response: Encodable, Sendable {61 var clientDataJSON: String62 var attestationObject: String?63 var authenticatorData: String?64 var signature: String?65 var userHandle: String?66 var transports: [String]?67 }68 var id: String69 var rawId: String70 var type = "public-key"71 var authenticatorAttachment = "platform"72 var clientExtensionResults: [String: String] = [:]73 var response: Response7475 init(_ registration: PasskeyRegistration) {76 id = SyncCrypto.base64URL(registration.credentialID)77 rawId = id78 response = Response(clientDataJSON: SyncCrypto.base64URL(registration.clientDataJSON),79 attestationObject: SyncCrypto.base64URL(registration.attestationObject), transports: ["internal", "hybrid"])80 }8182 init(_ assertion: PasskeyAssertion) {83 id = SyncCrypto.base64URL(assertion.credentialID)84 rawId = id85 response = Response(clientDataJSON: SyncCrypto.base64URL(assertion.clientDataJSON),86 authenticatorData: SyncCrypto.base64URL(assertion.authenticatorData),87 signature: SyncCrypto.base64URL(assertion.signature),88 userHandle: assertion.userHandle.map(SyncCrypto.base64URL))89 }90 }91}92