summary refs log tree commit diff
path: root/docs/application_services.rst
diff options
context:
space:
mode:
authorErik Johnston <erik@matrix.org>2015-05-07 18:51:09 +0100
committerErik Johnston <erik@matrix.org>2015-05-07 18:51:09 +0100
commit35698484a51081126d3f8b37a599d7d37a91f5fb (patch)
tree4c383e3590e94de5626d237601910ff0f93b5e5d /docs/application_services.rst
parentBump date (diff)
downloadsynapse-35698484a51081126d3f8b37a599d7d37a91f5fb.tar.xz
Add some information on registering AS's
Diffstat (limited to '')
-rw-r--r--docs/application_services.rst26
1 files changed, 26 insertions, 0 deletions
diff --git a/docs/application_services.rst b/docs/application_services.rst
new file mode 100644
index 0000000000..07236e62ae
--- /dev/null
+++ b/docs/application_services.rst
@@ -0,0 +1,26 @@
+Registering an Application Service
+==================================
+
+The registration of new application services is implementation dependent. In
+synapse you need to create a new configuration file for you AS and add it to
+the list of AS's specified under ``app_service_config_files`` synapse
+config option.
+
+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 ad to requests to AS>
+    sender_localpart: <localpart of AS user>
+    namespaces:
+      users:  # List of users we're interested in
+        - exclusive: <bool>
+          regex: <regex>
+        - ...
+      aliases: []  # List of aliases we're interested in
+      rooms: [] # List of room ids we're interested in
+
+See the spec_ for further details on how application services work.
+
+.. _spec: https://github.com/matrix-org/matrix-doc/blob/master/specification/25_application_service_api.rst#application-service-api
+