apple-localauthentication 0.3.5

Safe Rust bindings for Apple's LocalAuthentication framework — contexts, rights, persisted secrets, keys, and credentials on macOS
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

import Foundation
import LocalAuthentication

// MARK: - Async Policy Evaluation

@_cdecl("la_context_evaluate_policy_async")
public func la_context_evaluate_policy_async(
    _ contextPtr: UnsafeMutableRawPointer?,
    _ policyRaw: Int32,
    _ localizedReason: UnsafePointer<CChar>?,
    _ cb: @convention(c) (UInt8, UnsafePointer<CChar>?, UnsafeMutableRawPointer) -> Void,
    _ ctx: UnsafeMutableRawPointer
) {
    // Resolve all pointer-derived inputs synchronously. The caller (Rust) frees
    // `localizedReason` as soon as this function returns, and the borrowed
    // context handle may be released before the deferred `Task` runs, so they
    // must not be dereferenced inside the asynchronous closure.
    let inputs: Result<(LAContext, LAPolicy, String), Error>
    do {
        inputs = .success((
            try laContext(contextPtr),
            try laPolicy(policyRaw),
            try laRequiredString(localizedReason, name: "localized reason")
        ))
    } catch {
        inputs = .failure(error)
    }

    Task {
        do {
            let (context, policy, reason) = try inputs.get()
            let success = try await context.evaluatePolicy(policy, localizedReason: reason)
            cb(success ? 1 : 0, nil, ctx)
        } catch {
            error.localizedDescription.withCString { errorCString in
                cb(0, errorCString, ctx)
            }
        }
    }
}

// MARK: - Async Access Control Evaluation

@_cdecl("la_context_evaluate_access_control_async")
public func la_context_evaluate_access_control_async(
    _ contextPtr: UnsafeMutableRawPointer?,
    _ accessControlPtr: UnsafeRawPointer?,
    _ operationRaw: Int32,
    _ localizedReason: UnsafePointer<CChar>?,
    _ cb: @convention(c) (UInt8, UnsafePointer<CChar>?, UnsafeMutableRawPointer) -> Void,
    _ ctx: UnsafeMutableRawPointer
) {
    // Resolve all pointer-derived inputs synchronously. The caller (Rust) frees
    // `localizedReason` as soon as this function returns, and the borrowed
    // context handle may be released before the deferred `Task` runs, so they
    // must not be dereferenced inside the asynchronous closure.
    let inputs: Result<(LAContext, SecAccessControl, LAAccessControlOperation, String), Error>
    do {
        let context = try laContext(contextPtr)
        let accessControl = try laAccessControl(accessControlPtr)
        let reason = try laRequiredString(localizedReason, name: "localized reason")
        guard let operation = LAAccessControlOperation(rawValue: Int(operationRaw)) else {
            throw LABridgeError.invalidArgument("unsupported access-control operation: \(operationRaw)")
        }
        inputs = .success((context, accessControl, operation, reason))
    } catch {
        inputs = .failure(error)
    }

    Task {
        do {
            let (context, accessControl, operation, reason) = try inputs.get()
            let success = try await context.evaluateAccessControl(
                accessControl,
                operation: operation,
                localizedReason: reason
            )
            cb(success ? 1 : 0, nil, ctx)
        } catch {
            error.localizedDescription.withCString { errorCString in
                cb(0, errorCString, ctx)
            }
        }
    }
}