Skip to content

AllDevicesIsolationMode

Defined in: src/crypto-api/index.ts:811

A type of DeviceIsolationMode.

Message encryption keys are shared with all devices in the room, except in case of verified user problems (see errorOnVerifiedUserProblems).

Events from all senders are always decrypted (and should be decorated with message shields in case of authenticity warnings, see EventEncryptionInfo).

AllDevicesIsolationMode is used in the legacy, non-‘exclude insecure devices’ mode in some reference clients. It is not recommended (see MSC4153).

new AllDevicesIsolationMode(errorOnVerifiedUserProblems): AllDevicesIsolationMode

Defined in: src/crypto-api/index.ts:825

boolean

Behavior when sharing keys to remote devices.

If set to true, sharing keys will fail (i.e. message sending will fail) with an error if:

  • The user was previously verified but is not anymore, or:
  • A verified user has some unverified devices (not cross-signed).

If false, the keys will be distributed as usual. In this case, the client UX should display warnings to inform the user about problematic devices/users, and stop them hitting this case.

AllDevicesIsolationMode

readonly errorOnVerifiedUserProblems: boolean

Defined in: src/crypto-api/index.ts:825

Behavior when sharing keys to remote devices.

If set to true, sharing keys will fail (i.e. message sending will fail) with an error if:

  • The user was previously verified but is not anymore, or:
  • A verified user has some unverified devices (not cross-signed).

If false, the keys will be distributed as usual. In this case, the client UX should display warnings to inform the user about problematic devices/users, and stop them hitting this case.


readonly kind: AllDevicesIsolationMode = DeviceIsolationModeKind.AllDevicesIsolationMode

Defined in: src/crypto-api/index.ts:812