Struct dittolive_ditto::identity::OnlineWithAuthentication

pub struct OnlineWithAuthentication { /* private fields */ }

Run Ditto in secure production mode, logging on to Ditto Cloud or an on-premises authentication server. User permissions are centrally managed. Sync will not work until a successful login has occurred.

The only required configuration is the application’s UUID, which can be found on the Ditto portal where the app is registered.

By default cloud sync is enabled. This means the SDK will sync to a Big Peer in Ditto’s cloud when an internet connection is available. This is controlled by the enableDittoCloudSync parameter. If true (default), a suitable wss:// URL will be added to the TransportConfig.

To prevent cloud sync, or to specify your own URL later, pass false.

Authentication requests are handled by Ditto’s cloud by default, configured in the portal at <https://portal.ditto.live>.

To use a different or on-premises authentication service, pass a custom HTTPS base URL as the * auth_url parameter.

Implementations

impl OnlineWithAuthentication

pub fn new(
    ditto_root: Arc<dyn DittoRoot>,
    app_id: AppId,
    auth_event_handler: impl DittoAuthenticationEventHandler + 'static,
    enable_cloud_sync: bool,
    custom_auth_url: Option<&str>
) -> Result<Self, DittoError>

Construct an OnlineWithAuthentication Identity

• ditto_root - The directory containing ditto local storage
• app_id - The unique identifier of the application, usually a UUIDv4 string
• auth_event_handler - A user created type which implements the DittoAuthenticationEventHandler trait
• enable_cloud_sync - where cloud sync should be started by default
• custom_auth_url - an optional custom authentication URL; default is is cloud.ditto.live

Trait Implementations

impl Identity for OnlineWithAuthentication

fn site_id(&self) -> SiteId

Returns the current SiteId identifying the Ditto peer

fn app_id(&self) -> Option<&AppId>

Returns the current AppId

fn auth_client(&self) -> Arc<BoxedAuthClient>

Returns a shared reference to the underlying AuthClient

fn ditto_root(&self) -> Arc<dyn DittoRoot>

Returns the current DittoRoot

fn is_web_valid(&self) -> bool

Returns if the curernt web auth token is valid

fn is_x509_valid(&self) -> bool

Returns if the configured x509 certificate is valid

fn is_cloud_sync_enabled(&self) -> bool

Indicates if cloud sync should be enabled by default

fn auth_url(&self) -> Result<String, DittoError>

Returns the configured URL for Auth

fn sync_url(&self) -> Result<String, DittoError>

Returns the configured URL for websocket sync

fn authenticator(&self) -> Option<DittoAuthenticator>

Returns the underlying DittoAuthenticator if specified

fn make_listener(
    &self,
    transports: Arc<RwLock<Transports>>
) -> Option<Arc<ValidityListener>>

Constructs a ValidityListener given a shared reference to the Ditto Transports

fn requires_offline_only_license_token(&self) -> bool

Indicates whether the specific Identity type requires an offline only license token to be set.