pixlwave / matrix-authentication-service

Matrix authentication service for MSC2964 & co. (WIP)

OAuth 2.0 authentication server for Matrix

This is an attempt to implement an OAuth 2.0 and OpenID Connect authentication server for Matrix, following MSC2964. Don't expect too much here for now, this is very much a work in progress.

See the Documentation for information on installation and use.

Running

• Install Rust and Cargo
• Install Node.js and npm
• Install Open Policy Agent
• Clone this repository
• Build the frontend

  cd frontend
  npm ci
  npm run build
  cd ..

• Build the Open Policy Agent policies

  cd policies
  make
  # OR, if you don't have `opa` installed and want to build through the OPA docker image
  make DOCKER=1
  cd ..

• Generate the sample config via cargo run -- config generate > config.yaml
• Run a PostgreSQL database locally

  docker run -p 5432:5432 -e 'POSTGRES_USER=postgres' -e 'POSTGRES_PASSWORD=postgres' -e 'POSTGRES_DATABASE=postgres' postgres

• Update the database URI in config.yaml to postgresql://postgres:postgres@localhost/postgres
• Run the database migrations via cargo run -- database migrate
• Run the server via cargo run -- server -c config.yaml
• Go to http://localhost:8080/