mirror of
https://github.com/element-hq/matrix-authentication-service.git
synced 2026-10-12 15:47:30 +00:00
Devon HudsonandClaude Opus 5
4ad436fb33
Mints a single-use, passwordless registration token per recipient, pinned to their address and optionally to a username, and schedules the invite emails. The links are only ever mailed to the recipients, so the response carries a count rather than the tokens. Minting moves out of the queue and into the caller so a username that is already taken is refused up front, rather than emailed out as a link nobody can register with. That leaves the fan-out job with nothing to do, so `SendRoomInviteEmailsJob` goes away and `SendRoomInviteEmailJob` carries the token: it takes both the address and the invite link from it, which replaces the `matrix.to` stub and keeps the link and its recipient together. `manage send-room-invites` and the endpoint share the minting through `mas_storage::room_invite`. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
About this documentation
This documentation is intended to give an overview of how the matrix-authentication-service (MAS) works, both from an admin perspective and from a developer perspective.
MAS is an OAuth 2.0 and OpenID Provider server for Matrix. It has been created to support the migration of Matrix to an OpenID Connect (OIDC) based authentication layer as per MSC3861.
The documentation itself is built using mdBook. A hosted version is available at https://element-hq.github.io/matrix-authentication-service/.
How the documentation is organized
This documentation has four main sections:
- The installation guide will guide you through the process of setting up the
matrix-authentication-serviceon your own infrastructure. - The topics sections goes into more details about how the service works, like the policy engine and how authorization sessions are managed.
- The reference documentation covers configuration options, the Admin API, the scopes supported by the service, and the command line interface.
- The developer documentation is intended for people who want to contribute to the project. Developers may also be interested in: