Do not require UIA when first uploading cross-signing keys (#1828)
As per MSC3967.
This commit is contained in:
parent
e15a36b0a1
commit
1e303b3bbc
2 changed files with 16 additions and 0 deletions
1
changelogs/client_server/newsfragments/1828.feature
Normal file
1
changelogs/client_server/newsfragments/1828.feature
Normal file
|
@ -0,0 +1 @@
|
||||||
|
Do not require UIA when first uploading cross-signing keys, as per [MSC3967](https://github.com/matrix-org/matrix-spec-proposals/pull/3967).
|
|
@ -19,11 +19,26 @@ paths:
|
||||||
/keys/device_signing/upload:
|
/keys/device_signing/upload:
|
||||||
post:
|
post:
|
||||||
x-addedInMatrixVersion: "1.1"
|
x-addedInMatrixVersion: "1.1"
|
||||||
|
x-changedInMatrixVersion:
|
||||||
|
"1.11": UIA is not always required for this endpoint.
|
||||||
summary: Upload cross-signing keys.
|
summary: Upload cross-signing keys.
|
||||||
description: |-
|
description: |-
|
||||||
Publishes cross-signing keys for the user.
|
Publishes cross-signing keys for the user.
|
||||||
|
|
||||||
This API endpoint uses the [User-Interactive Authentication API](/client-server-api/#user-interactive-authentication-api).
|
This API endpoint uses the [User-Interactive Authentication API](/client-server-api/#user-interactive-authentication-api).
|
||||||
|
|
||||||
|
User-Interactive Authentication MUST be performed, except in these cases:
|
||||||
|
- there is no existing cross-signing master key uploaded to the homeserver, OR
|
||||||
|
- there is an existing cross-signing master key and it exactly matches the
|
||||||
|
cross-signing master key provided in the request body. If there are any additional
|
||||||
|
keys provided in the request (self-signing key, user-signing key) they MUST also
|
||||||
|
match the existing keys stored on the server. In other words, the request contains
|
||||||
|
no new keys.
|
||||||
|
|
||||||
|
This allows clients to freely upload one set of keys, but not modify/overwrite keys if
|
||||||
|
they already exist. Allowing clients to upload the same set of keys more than once
|
||||||
|
makes this endpoint idempotent in the case where the response is lost over the network,
|
||||||
|
which would otherwise cause a UIA challenge upon retry.
|
||||||
operationId: uploadCrossSigningKeys
|
operationId: uploadCrossSigningKeys
|
||||||
security:
|
security:
|
||||||
- accessTokenQuery: []
|
- accessTokenQuery: []
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue