Struct apple_codesign::stapling::Stapler

pub struct Stapler { /* private fields */ }

Handles stapling operations.

Implementations

impl Stapler

pub fn new() -> Result<Self, AppleCodesignError>

Construct a new instance with defaults.

pub fn set_client(&mut self, client: Client)

Set the HTTP client to use for ticket lookups.

pub fn lookup_ticket_for_executable_bundle( &self, bundle: &DirectoryBundle ) -> Result<Vec<u8>, AppleCodesignError>

Look up a notarization ticket for an app bundle.

This will resolve the notarization ticket record name from the contents of the bundle then attempt to look up that notarization ticket against Apple’s servers.

This errors if there is a problem deriving the notarization ticket record name or if a failure occurs when looking up the notarization ticket. This can include a notarization ticket not existing for the requested record.

pub fn staple_bundle( &self, bundle: &DirectoryBundle ) -> Result<(), AppleCodesignError>

Attempt to staple a bundle by obtaining a notarization ticket automatically.

pub fn lookup_ticket_for_dmg( &self, dmg: &DmgReader ) -> Result<Vec<u8>, AppleCodesignError>

Look up ticket data for DMG file.

pub fn staple_dmg(&self, path: &Path) -> Result<(), AppleCodesignError>

Attempt to staple a DMG by obtaining a notarization ticket automatically.

pub fn lookup_ticket_for_xar<R: Read + Seek + Sized + Debug>( &self, reader: &mut XarReader<R> ) -> Result<Vec<u8>, AppleCodesignError>

Lookup ticket data for a XAR archive (e.g. a .pkg file).

pub fn staple_xar<F: Read + Write + Seek + Sized + Debug>( &self, xar: XarReader<F> ) -> Result<(), AppleCodesignError>

Staple a XAR archive.

Takes the handle to a readable, writable, and seekable object.

The stream will be opened as a XAR file. If a ticket is found, that ticket will be appended to the end of the file.

pub fn staple_path( &self, path: impl AsRef<Path> ) -> Result<(), AppleCodesignError>

Attempt to staple an entity at a given filesystem path.

The path will be modified on successful stapling operation.