Struct ServerCommunicationConfigClient 

pub struct ServerCommunicationConfigClient<R, P>
where
    R: ServerCommunicationConfigRepository,
    P: ServerCommunicationConfigPlatformApi,
{
    repository: R,
    platform_api: P,
}

Server communication configuration client

Fields

repository: R

platform_api: P

Implementations

impl<R, P> ServerCommunicationConfigClient<R, P>

where R: ServerCommunicationConfigRepository, P: ServerCommunicationConfigPlatformApi,

pub fn new(repository: R, platform_api: P) -> Self

Creates a new server communication configuration client

Arguments

• repository - Cookie storage implementation (e.g a StateProvider hook)
• platform_api - Cookie acquistion implementation

pub async fn get_config( &self, hostname: String, ) -> Result<ServerCommunicationConfig, R::GetError>

Retrieves the server communication configuration for a hostname

pub async fn needs_bootstrap(&self, hostname: String) -> bool

Determines if cookie bootstrapping is needed for this hostname

pub async fn cookies(&self, hostname: String) -> Vec<(String, String)>

Returns cookies to include in HTTP requests

Returns the stored cookies as-is. For sharded cookies, each entry includes the full cookie name with its -{N} suffix (e.g., AWSELBAuthSessionCookie-0).

pub async fn set_communication_type( &self, hostname: String, config: ServerCommunicationConfig, ) -> Result<(), R::SaveError>

Sets the server communication configuration for a hostname

This method saves the provided communication configuration to the repository. Typically called when receiving the /api/config response from the server.

Arguments

• hostname - The server hostname (e.g., “vault.acme.com”)
• config - The server communication configuration to store

Errors

Returns an error if the repository save operation fails

pub async fn acquire_cookie( &self, hostname: &str, ) -> Result<(), AcquireCookieError>

Acquires a cookie from the platform and saves it to the repository

This method calls the platform API to trigger cookie acquisition (e.g., browser redirect to IdP), then validates and stores the acquired cookie in the repository.

Arguments

• hostname - The server hostname (e.g., “vault.acme.com”)

Errors

Returns an error if:

• Cookie acquisition was cancelled by the user (AcquireCookieError::Cancelled)
• Server configuration doesn’t support SSO cookies (AcquireCookieError::UnsupportedConfiguration)
• Acquired cookie name doesn’t match expected name (AcquireCookieError::CookieNameMismatch)
• Repository operations fail (AcquireCookieError::RepositoryGetError or AcquireCookieError::RepositorySaveError)