Skip to main content

ProxySession

Struct ProxySession 

Source
pub struct ProxySession { /* private fields */ }
Expand description

Platform-neutral authenticated proxy admission state.

Implementations§

Source§

impl ProxySession

Source

pub fn new(config: ProxyConfig) -> Result<Self, ProxyError>

Open one non-cloneable proxy session.

Source

pub const fn endpoint(&self) -> LoopbackEndpoint

Exact numeric loopback endpoint.

Source

pub fn authorization_header_value(&self) -> String

Browser callback authorization value.

Source

pub const fn registry_generation(&self) -> u64

Current in-memory publication-registry generation.

Source

pub fn publication_count(&self) -> usize

Number of publication records currently resident in memory.

Source

pub fn authentication_challenge(&self) -> Vec<u8> ⓘ

Bounded 407 response for missing/invalid proxy authentication.

Source

pub fn admit_connect( &mut self, engine: &Engine, client: SocketAddr, request_head: &[u8], now: u64, ) -> Result<PendingConnect, ProxyError>

Admit one strict authenticated loopback CONNECT before origin TLS.

now must come from the native host’s trusted nondecreasing clock. Rollback is rejected. Expired pending records are removed before the capacity check, and every returned handle carries its exact exclusive deadline.

Source

pub fn publish_authority( &mut self, engine: &Engine, expected_registry_generation: u64, authority: ProviderAuthorityContext, now: u64, ) -> Result<PublishedAdmission, ProxyError>

Atomically publish one engine-issued provider authority.

The context is consumed even when publication fails. Expired or engine-invalid records are reclaimed before uniqueness and capacity checks without advancing the generation because they can no longer authorize a tunnel. Current records are unchanged unless every authority, lifecycle, bound, time, uniqueness, capacity, and expected-generation check succeeds.

Source

pub fn replace_authority( &mut self, engine: &Engine, expected_registry_generation: u64, admission: PublishedAdmission, authority: ProviderAuthorityContext, now: u64, ) -> Result<PublishedAdmission, ProxyError>

Atomically replace one exact-origin publication with fresh authority.

The old handle and replacement context are consumed. Replacement cannot change the logical origin, publication identity, process, or listener.

Source

pub fn revoke_authority( &mut self, expected_registry_generation: u64, admission: PublishedAdmission, ) -> Result<u64, ProxyError>

Atomically revoke one exact-origin publication.

The handle is consumed and the generation advances only after the exact publication and expected registry generation match.

Source

pub fn authorize_connect( &mut self, engine: &Engine, pending: PendingConnect, admission: &PublishedAdmission, expected_registry_generation: u64, now: u64, ) -> Result<TunnelGrant, ProxyError>

Convert one pending CONNECT into a short-lived exact-origin grant.

The pending token is consumed before any publication or engine check can succeed or fail. The published admission remains usable for another separately authenticated CONNECT only while every generation remains current.

Source

pub fn revalidate_tunnel_grant( &mut self, engine: &Engine, grant: &TunnelGrant, expected_registry_generation: u64, now: u64, ) -> Result<(), ProxyError>

Revalidate a grant immediately before native listener or origin I/O.

This check is intentionally generation-wide: any publish, replace, or revoke invalidates an outstanding grant until the CONNECT is admitted again. It also rejects another process/listener instance, a replaced or revoked exact-origin publication, security-invalidating engine transition, and expiry. Ordinary later engine admissions do not revoke the retained opaque authority.

Source

pub fn cancel(&mut self, pending: &PendingConnect) -> Result<(), ProxyError>

Cancel one exact pending request.

Trait Implementations§

Source§

impl Debug for ProxySession

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Drop for ProxySession

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)
Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.