security_framework/
lib.rs

1#![cfg(any(target_os = "macos", target_os = "ios", target_os = "tvos", target_os = "watchos", target_os = "visionos"))]
2
3//! Wrappers around the OSX Security Framework.
4#![warn(missing_docs)]
5#![allow(non_upper_case_globals)]
6#![allow(clippy::manual_non_exhaustive)] // MSRV
7#![allow(clippy::bad_bit_mask)] // bitflags
8
9use core_foundation_sys::base::OSStatus;
10use security_framework_sys::base::errSecSuccess;
11
12use crate::base::{Error, Result};
13#[cfg(target_os = "macos")]
14use crate::os::macos::access::SecAccess;
15#[cfg(target_os = "macos")]
16use crate::os::macos::keychain::SecKeychain;
17
18#[cfg(test)]
19macro_rules! p {
20    ($e:expr) => {
21        match $e {
22            Ok(s) => s,
23            Err(e) => panic!("{:?}", e),
24        }
25    };
26}
27
28#[cfg(all(not(feature = "OSX_10_13"), any(feature = "alpn", feature = "session-tickets")))]
29#[macro_use]
30mod dlsym;
31
32pub mod access_control;
33#[cfg(target_os = "macos")]
34pub mod authorization;
35pub mod base;
36pub mod certificate;
37pub mod cipher_suite;
38#[cfg(target_os = "macos")]
39pub mod cms;
40pub mod identity;
41pub mod import_export;
42pub mod item;
43pub mod key;
44pub mod os;
45pub mod passwords;
46pub mod passwords_options;
47pub mod policy;
48pub mod random;
49pub mod secure_transport;
50pub mod trust;
51#[cfg(target_os = "macos")]
52pub mod trust_settings;
53
54#[cfg(target_os = "macos")]
55trait Pkcs12ImportOptionsInternals {
56    fn keychain(&mut self, keychain: SecKeychain) -> &mut Self;
57    fn access(&mut self, access: SecAccess) -> &mut Self;
58}
59
60#[cfg(target_os = "macos")]
61trait ItemSearchOptionsInternals {
62    fn keychains(&mut self, keychains: &[SecKeychain]) -> &mut Self;
63}
64
65trait AsInner {
66    type Inner;
67    fn as_inner(&self) -> Self::Inner;
68}
69
70#[inline(always)]
71fn cvt(err: OSStatus) -> Result<()> {
72    match err {
73        errSecSuccess => Ok(()),
74        err => Err(Error::from_code(err)),
75    }
76}
77
78#[cfg(test)]
79mod test {
80    use crate::certificate::SecCertificate;
81
82    pub fn certificate() -> SecCertificate {
83        let certificate = include_bytes!("../test/server.der");
84        p!(SecCertificate::from_der(certificate))
85    }
86}
security_framework/lib.rs

security_framework/
lib.rs
