OpenCloud
/
MatrixSynapse
mirror of https://github.com/matrix-org/synapse
1
0
Fork 0
Code Issues Releases Wiki Activity

Finished up Identity section in the architecture section.

paul/schema_breaking_changes
Kegan Dougal 2014-09-02 20:32:09 +01:00
parent 3167d47882
commit 2f5182b2d2
1 changed files with 19 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
docs/specification.rst
View File

@ -125,11 +125,24 @@ once and then use that ID on subsequent requests.
Identity Identity
-------- --------
- Identity in relation to 3PIDs. Discovery of users based on 3PIDs. Users in Matrix are identified via their user ID. However, existing ID namespaces
- Identity servers; trusted clique of servers which replicate content. can also be used in order to identify Matrix users. A Matrix "Identity" describes
- They govern the mapping of 3PIDs to user IDs and the creation of said mappings. both the user ID and any other existing ID namespaces *linked* to their account.
- Not strictly required in order to communicate.
Matrix users can *link* third-party IDs (3PIDs) such as email addresses, social
network accounts and phone numbers to their
user ID. Linking 3PIDs creates a mapping from a 3PID to a user ID. This mapping
can then be used by other Matrix users in order to discover other users, according
to a strict set of privacy permissions.
In order to ensure that the mapping from 3PID to user ID is genuine, dedicated
trusted servers called "Identity Servers" (IS) are used to perform authentication
of the 3PID. Identity servers are also used to preserve the mapping indefinitely,
by replicating the mappings across multiple ISes.
Usage of an IS is not required in order for a client application to be part of
the Matrix ecosystem. However, by not using an IS, discovery of users is greatly
impacted.
API Standards API Standards
------------- -------------