wholetrans/docs-matrix-spec
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Merge pull request #3167 from matrix-org/travis/spec/msc2265-lower-3pid

Browse source 
Specify that email handling converts to lowercase first
This commit is contained in:
Travis Ralston 2021-05-02 23:11:54 -06:00 • committed by Richard van der Hoff
commit fb3dde1c2c
3 changed files with 12 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

1
changelogs/identity_service/newsfragments/3167.clarification Normal file
View file

@ -0,0 +1 @@
Clarify that some identifiers may be lowercase prior to processing, as per [MSC2265](https://github.com/matrix-org/matrix-doc/pull/2265).

7
content/appendices.md
View file

@ -772,6 +772,13 @@ Represents E-Mail addresses. The `address` is the raw email address in
`user@domain` form with the domain in lowercase. It must not contain `user@domain` form with the domain in lowercase. It must not contain
other text such as real name, angle brackets or a mailto: prefix. other text such as real name, angle brackets or a mailto: prefix.
In addition to lowercasing the domain component of an email address,
implementations are expected to lowercase the localpart as described
in [the unicode mapping file](https://www.unicode.org/Public/8.0.0/ucd/CaseFolding.txt)
prior to any processing. For example, `Strauß@Example.com` must be
considered to be `strauss@example.com` while processing the email
address.
### PSTN Phone numbers ### PSTN Phone numbers
Medium: `msisdn` Medium: `msisdn`

4
data/api/identity/v2_lookup.yaml
View file

@ -101,6 +101,10 @@ paths:
The addresses to look up. The format of the entries here depend on The addresses to look up. The format of the entries here depend on
the `algorithm` used. Note that queries which have been incorrectly the `algorithm` used. Note that queries which have been incorrectly
hashed or formatted will lead to no matches. hashed or formatted will lead to no matches.
Note that addresses are case sensitive: review the
[3PID Types](/appendices#pid-types) to verify the intended case an
identifier should be prior to submission/hashing.
example: [ example: [
"4kenr7N9drpCJ4AfalmlGQVsOn3o2RHjkADUpXJWZUc", "4kenr7N9drpCJ4AfalmlGQVsOn3o2RHjkADUpXJWZUc",
"nlo35_T5fzSGZzJApqu8lgIudJvmOQtDaHtr-I4rU7I" "nlo35_T5fzSGZzJApqu8lgIudJvmOQtDaHtr-I4rU7I"