From 74007ef5eee52d565048a68f870200c84a3e5721 Mon Sep 17 00:00:00 2001 From: richvdh Date: Wed, 7 Jul 2021 09:44:14 +0000 Subject: deploy: 7c823789921ac34f1fee670be7ef7f6c8266832b --- latest/application_services.html | 281 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 281 insertions(+) create mode 100644 latest/application_services.html (limited to 'latest/application_services.html') diff --git a/latest/application_services.html b/latest/application_services.html new file mode 100644 index 0000000000..0f9485d5ed --- /dev/null +++ b/latest/application_services.html @@ -0,0 +1,281 @@ + + + + + + Application Services - Synapse + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + + +
+
+ +
+ +
+ +

Registering an Application Service

+

The registration of new application services depends on the homeserver used. +In synapse, you need to create a new configuration file for your AS and add it +to the list specified under the app_service_config_files config +option in your synapse config.

+

For example:

+
app_service_config_files:
+- /home/matrix/.synapse/<your-AS>.yaml
+
+

The format of the AS configuration file is as follows:

+
url: <base url of AS>
+as_token: <token AS will add to requests to HS>
+hs_token: <token HS will add to requests to AS>
+sender_localpart: <localpart of AS user>
+namespaces:
+  users:  # List of users we're interested in
+    - exclusive: <bool>
+      regex: <regex>
+      group_id: <group>
+    - ...
+  aliases: []  # List of aliases we're interested in
+  rooms: [] # List of room ids we're interested in
+
+

exclusive: If enabled, only this application service is allowed to register users in its namespace(s). +group_id: All users of this application service are dynamically joined to this group. This is useful for e.g user organisation or flairs.

+

See the spec for further details on how application services work.

+ +
+ + +
+
+ + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file -- cgit 1.5.1