From 55354482cd7fdda060fe77597c3f8dbf86d82bda Mon Sep 17 00:00:00 2001 From: reivilibre Date: Tue, 26 Jul 2022 11:13:04 +0000 Subject: deploy: 641412decde53bad393d478858355ae1db5306cf --- v1.64/application_services.html | 215 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 215 insertions(+) create mode 100644 v1.64/application_services.html (limited to 'v1.64/application_services.html') diff --git a/v1.64/application_services.html b/v1.64/application_services.html new file mode 100644 index 0000000000..aa5e5db2ea --- /dev/null +++ b/v1.64/application_services.html @@ -0,0 +1,215 @@ + + + + + + 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.4.1