mirror of https://github.com/etkecc/synapse-admin.git synced 2024-12-13 08:33:15 +03:00

* unify components import

* refactor config and app context

* refactor icons

* refactor date, error, mxid and storage

* refactor synapse utils

2024-11-25 12:51:05 +02:00

3.9 KiB

Raw Blame History

Configuration

Synapse Admin could be configured using the following ways (both are optional, and both could be used together):

By providing the config.json file alongside with the Synapse Admin deployment, example: admin.etke.cc/config.json
By providing configuration under the cc.etke.synapse-admin key in the /.well-known/matrix/client file, example: demo.etke.host/.well-known/matrix/client

In case you are an etke.cc customer, or use spantaleev/matrix-docker-ansible-deploy, or etkecc/ansible, configuration will be automatically added to the /.well-known/matrix/client file.

Why /.well-known/matrix/client?

Because any instance of Synapse Admin will automatically pick up the configuration from the homeserver. Common use case when you have a Synapse server running, but don't want (or can't) deploy Synapse Admin alongside with it. In this case, you could provide the configuration in the /.well-known/matrix/client file, and any Synapse Admin instance (e.g., admin.etke.cc will pick it up.

Another common case is when you have multiple Synapse servers running and want to use a single Synapse Admin instance to manage them all. In this case, you could provide the configuration in the /.well-known/matrix/client file for each of the servers.

Configuration options

restrictBaseUrl - restrictBaseUrl restricts the Synapse Admin instance to work only with specific homeserver(-s). It accepts both a string and an array of strings. The homeserver URL should be the actual homeserver URL, and not the delegated one. Example: https://matrix.example.com or https://synapse.example.net More details
asManagedUsers - protect system user accounts managed by appservices (such as bridges) / system (such as bots) from accidental changes. By defining a list of MXID regex patterns, you can protect these accounts from accidental changes. Example: ^@baibot:example\\.com$, ^@slackbot:example\\.com$, ^@slack_[a-zA-Z0-9\\-]+:example\\.com$, ^@telegrambot:example\\.com$, ^@telegram_[a-zA-Z0-9]+:example\\.com$ More details
menu - add custom menu items to the main menu (sidebar) by providing a menu array in the config. Each menu item can contain the following fields:
- label (required): The text to display in the menu.
- icon (optional): The icon to display next to the label, one of the src/utils/icons.ts icons, otherwise a default icon will be used.
- url (required): The URL to navigate to when the menu item is clicked. More details

Examples

config.json

{
  "restrictBaseUrl": [
    "https://matrix.example.com",
    "https://synapse.example.net"
  ],
  "asManagedUsers": [
    "^@baibot:example\\.com$",
    "^@slackbot:example\\.com$",
    "^@slack_[a-zA-Z0-9\\-]+:example\\.com$",
    "^@telegrambot:example\\.com$",
    "^@telegram_[a-zA-Z0-9]+:example\\.com$"
  ],
  "menu": [
    {
      "label": "Contact support",
      "icon": "SupportAgent",
      "url": "https://github.com/etkecc/synapse-admin/issues"
    }
  ]
}

`/.well-known/matrix/client`

{
  "cc.etke.synapse-admin": {
    "restrictBaseUrl": [
      "https://matrix.example.com",
      "https://synapse.example.net"
    ],
    "asManagedUsers": [
      "^@baibot:example\\.com$",
      "^@slackbot:example\\.com$",
      "^@slack_[a-zA-Z0-9\\-]+:example\\.com$",
      "^@telegrambot:example\\.com$",
      "^@telegram_[a-zA-Z0-9]+:example\\.com$"
    ],
    "menu": [
      {
        "label": "Contact support",
        "icon": "SupportAgent",
        "url": "https://github.com/etkecc/synapse-admin/issues"
      }
    ]
  }
}

3.9 KiB Raw Blame History