SPB Git

Repository Public

Passkeys.swift 3.6 KB 92 lines swift

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
Files main
Menu

Theme