Enum CollectStrategy 

pub enum CollectStrategy {
    AllDevices,
    ErrorOnVerifiedUserProblem,
    IdentityBasedStrategy,
    OnlyTrustedDevices,
}

Strategy to collect the devices that should receive room keys for the current discussion.

Variants

AllDevices

Share with all (unblacklisted) devices.

Not recommended, per the guidance of MSC4153.

(Used by Element X and Element Web in the legacy, non-“exclude insecure devices” mode.)

ErrorOnVerifiedUserProblem

Share with all devices, except errors for verified users cause sharing to fail with an error.

In this strategy, if a verified user has an unsigned device, key sharing will fail with a SessionRecipientCollectionError::VerifiedUserHasUnsignedDevice. If a verified user has replaced their identity, key sharing will fail with a SessionRecipientCollectionError::VerifiedUserChangedIdentity.

Otherwise, keys are shared with unsigned devices as normal.

Once the problematic devices are blacklisted or whitelisted the caller can retry to share a second time.

Not recommended, per the guidance of MSC4153.

IdentityBasedStrategy

Share based on identity. Only distribute to devices signed by their owner. If a user has no published identity he will not receive any room keys.

This is the recommended strategy: it is compliant with the guidance of MSC4153.

(Used by Element Web and Element X in the “exclude insecure devices” mode.)

OnlyTrustedDevices

Only share keys with devices that we “trust”. A device is trusted if any of the following is true: - It was manually marked as trusted. - It was marked as verified via interactive verification. - It is signed by its owner identity, and this identity has been trusted via interactive verification. - It is the current own device of the user.

This strategy is compliant with MSC4153, but is probably too strict for normal use.

(Used by Element Web when “only send messages to verified users” is enabled.)

Implementations

impl CollectStrategy

pub const fn new_identity_based() -> Self

Creates an identity based strategy

Trait Implementations

impl Clone for CollectStrategy

fn clone(&self) -> CollectStrategy

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CollectStrategy

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

Formats the value using the given formatter.

impl Default for CollectStrategy

fn default() -> CollectStrategy

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CollectStrategy

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CollectStrategy

fn eq(&self, other: &CollectStrategy) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CollectStrategy

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CollectStrategy