Struct X509Source

pub struct X509Source { /* private fields */ }

Represents a source of X.509 SVIDs and X.509 bundles.

X509Source implements the BundleSource and SvidSource traits.

The methods return cloned instances of the underlying objects.

Implementations

impl X509Source

pub async fn default() -> Result<Arc<Self>, X509SourceError>

Builds a new X509Source using a default WorkloadApiClient and no SVID picker. Since no SVID picker is provided, the get_svid method will return the default SVID.

This method is asynchronous and may return an error if the initialization fails.

pub fn updated(&self) -> Receiver<()>

Returns a watch::Receiver<()> that can be used to listen for notifications when the X509Source is updated.

Example

``no_run let mut update_channel = source.updated(); // Get the watch receiver for the source

// Asynchronously handle updates in a loop tokio::spawn(async move { loop { match update_channel.changed().await { Ok() => { println!(“X509Source was updated!”); }, Err() => { println!(“Watch channel closed; exiting update loop”); break; } } } });

pub fn close(&self) -> Result<(), X509SourceError>

Closes the X509Source cancelling all spawned tasks.

Trait Implementations

impl BundleSource for X509Source

fn get_bundle_for_trust_domain( &self, trust_domain: &TrustDomain, ) -> Result<Option<Self::Item>, Box<dyn Error + Send + Sync + 'static>>

Retrieves the X.509 bundle for the given trust domain.

Arguments

• trust_domain - The trust domain for which the X.509 bundle is to be retrieved.

Returns

A Result containing an Option<X509Bundle> for the given trust domain. If the bundle is not found, returns Ok(None).

Errors

Returns a boxed error if the source is closed or if there is an issue accessing the bundle.

type Item = X509Bundle

The type of the bundles provided by the source.

impl Debug for X509Source

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl SvidSource for X509Source

fn get_svid( &self, ) -> Result<Option<Self::Item>, Box<dyn Error + Send + Sync + 'static>>

Retrieves the X.509 SVID from the source.

Returns

An Result<Option<X509Svid>, Box<dyn Error + Send + Sync + 'static>> containing the X.509 SVID if available. Returns Ok(None) if no SVID is found. Returns an error if the source is closed or if there’s an issue fetching the SVID.

type Item = X509Svid

The type of the SVIDs provided by the source.