Struct NetworkTimeClient 

pub struct NetworkTimeClient { /* private fields */ }

An HTTPS client that reports the contents of the response Date header.

Implementations

impl NetworkTimeClient

pub fn new() -> Self

Create a new NetworkTimeClient that uses the trust anchors provided through the ‘root-ssl-certificates’ component feature.

pub async fn get_network_time( &mut self, uri: Uri, ) -> Result<DateTime<FixedOffset>, HttpsDateError>

Makes a best effort to get network time via an HTTPS connection to uri.

Errors

get_network_time will return errors for network failures and TLS failures.

Panics

httpdate needs access to the root-ssl-certificates sandbox feature. If it is not available this API will panic.

Security

Validation of the TLS connection is deferred until after the handshake and then performed with respect to the time provided by the remote host. We validate the TLS connection against the system rootstore and time the server reports. This does mean that the best we can guarantee is that the host certificates were valid at some point, but the server can always provide a date that falls into the validity period of the certificates they provide.