1
0
mirror of https://github.com/matrix-org/matrix-authentication-service.git synced 2025-07-31 09:24:31 +03:00

Migration guide

This commit is contained in:
Hugh Nimmo-Smith
2023-09-11 14:51:02 +01:00
committed by Quentin Gliech
parent f9393020b6
commit 49d4fae16f
2 changed files with 16 additions and 1 deletions

15
docs/setup/migration.md Normal file
View File

@ -0,0 +1,15 @@
# Migrating an existing homeserver
One of the design goals of MAS has been to allow it to be used to migrate an existing homeserver to an OIDC-based architecture.
Specifically without requiring users to re-authenticate and that non-OIDC clients continue to work.
Features that are provided to support this include:
- Ability to import existing password hashes from Synapse
- Ability to import existing sessions and devices
- Ability to import existing access tokens
- Ability to import existing upstream IdP subject ID mappings
- Provides a compatibility layer for legacy Matrix authentication
There will be tools to help with the migration process itself. But these aren't quite ready yet.