2018-07-17 20:58:18 +02:00
|
|
|
---
|
|
|
|
|
allOf:
|
|
|
|
|
- $ref: core-event-schema/event.yaml
|
|
|
|
|
|
|
|
|
|
description: |-
|
|
|
|
|
This event type is used to exchange keys for end-to-end encryption. Typically
|
2021-01-29 01:00:39 +01:00
|
|
|
it is encrypted as an `m.room.encrypted` event, then sent as a [to-device](/client-server-api/#send-to-device-messaging) event.
|
2018-07-17 20:58:18 +02:00
|
|
|
properties:
|
|
|
|
|
content:
|
|
|
|
|
properties:
|
|
|
|
|
algorithm:
|
|
|
|
|
type: string
|
2018-07-31 18:59:09 +02:00
|
|
|
enum: ["m.megolm.v1.aes-sha2"]
|
2018-07-17 20:58:18 +02:00
|
|
|
description: |-
|
2018-07-31 18:59:09 +02:00
|
|
|
The encryption algorithm the key in this event is to be used with.
|
|
|
|
|
room_id:
|
|
|
|
|
type: string
|
|
|
|
|
description: The room where the key is used.
|
|
|
|
|
session_id:
|
|
|
|
|
type: string
|
|
|
|
|
description: The ID of the session that the key is for.
|
|
|
|
|
session_key:
|
|
|
|
|
type: string
|
2022-05-26 16:02:52 +02:00
|
|
|
description: The Megolm key to be exchanged, in [session sharing
|
|
|
|
|
format](https://gitlab.matrix.org/matrix-org/olm/blob/master/docs/megolm.md#session-sharing-format).
|
2018-07-17 20:58:18 +02:00
|
|
|
required:
|
|
|
|
|
- algorithm
|
2018-07-31 18:59:09 +02:00
|
|
|
- room_id
|
|
|
|
|
- session_id
|
|
|
|
|
- session_key
|
2018-07-17 20:58:18 +02:00
|
|
|
type: object
|
|
|
|
|
type:
|
|
|
|
|
enum:
|
|
|
|
|
- m.room_key
|
|
|
|
|
type: string
|
|
|
|
|
type: object
|
