diff options
author | Kegan Dougal <kegan@matrix.org> | 2014-09-09 15:00:48 -0700 |
---|---|---|
committer | Kegan Dougal <kegan@matrix.org> | 2014-09-09 15:00:48 -0700 |
commit | 56a358481e928d6e70ff8afd48756c67860965c9 (patch) | |
tree | 31c45dd036fd5ab37d4854d028b69ab04614a1d0 /docs | |
parent | Added initial draft for human-readable ID rules. (diff) | |
download | synapse-56a358481e928d6e70ff8afd48756c67860965c9.tar.xz |
Tyops
Diffstat (limited to 'docs')
-rw-r--r-- | docs/human-id-rules.rst | 14 |
1 files changed, 7 insertions, 7 deletions
diff --git a/docs/human-id-rules.rst b/docs/human-id-rules.rst index 36987ddd0d..999651991c 100644 --- a/docs/human-id-rules.rst +++ b/docs/human-id-rules.rst @@ -7,23 +7,23 @@ such, Matrix requires that all strings MUST be encoded as UTF-8. However, using Unicode as the character set for human-readable IDs is troublesome. There are many different characters which appear identical to each other, but would identify different users. In addition, there are non-printable characters which -cannot be rendered the the end-user. This opens up a security vulnerability with +cannot be rendered by the end-user. This opens up a security vulnerability with phishing/spoofing of IDs, commonly known as a homograph attack. Web browers encountered this problem when International Domain Names were introduced. A variety of checks were put in place in order to protect users. If an address failed the check, the raw punycode would be displayed to disambiguate -the address. Similar checks are performed by home servers in Matrix, which will -then warn the client about the potentially misleading ID. However, Matrix does -not use punycode, and so does not show raw punycode on a failed check. Instead, -home servers must outright reject these misleading IDs. +the address. Similar checks are performed by home servers in Matrix. However, +Matrix does not use punycode representations, and so does not show raw punycode +on a failed check. Instead, home servers must outright reject these misleading +IDs. Types of human-readable IDs --------------------------- There are two main human-readable IDs in question: - - Room aliases - - User IDs +- Room aliases +- User IDs Room aliases look like ``#localpart:domain``. These aliases point to opaque non human-readable room IDs. These pointers can change, so there is already an |