From d07f6856fecde7d0e397d8dc614c697d24dd2d40 Mon Sep 17 00:00:00 2001
From: reivilibre Many of the API calls in the admin api will require an An existing user can be marked as a server admin by updating the database directly. Check your database settings in the configuration file, connect to the correct database using either Check your database settings in the configuration file, connect to the correct database using either A new server admin user can also be created using the For example, suppose we want to
-query the account of the user
+query the account of the user
0
if no furth
failure_ts
- nullable integer - The first time Synapse tried and failed to reach the
remote server, in ms. This is null
if communication with the remote server has never failed.last_successful_stream_ordering
- nullable integer - The stream ordering of the most
-recent successfully-sent PDU
+recent successfully-sent PDU
to this destination, or null
if this information has not been tracked yet.
diff --git a/develop/usage/administration/admin_api/index.html b/develop/usage/administration/admin_api/index.html
index 0d5587271d..62901ed644 100644
--- a/develop/usage/administration/admin_api/index.html
+++ b/develop/usage/administration/admin_api/index.html
@@ -151,7 +151,7 @@
room_id
- string - The ID of the room.stream_ordering
- integer - The stream ordering of the most recent
-successfully-sent PDU
+successfully-sent PDU
to this destination in this room.access_token
for a
server admin. (Note that a server admin is distinct from a room admin.)psql [database name]
(if using PostgreSQL) or sqlite3 path/to/your/database.db
(if using SQLite) and elevate the user @foo:bar.com
to administrator.psql [database name]
(if using PostgreSQL) or sqlite3 path/to/your/database.db
(if using SQLite) and elevate the user @foo:bar.com
to administrator.UPDATE users SET admin = 1 WHERE name = '@foo:bar.com';
register_new_matrix_user
@@ -168,10 +168,10 @@ providing the token as either a query parameter or a request header. To add it a
curl --header "Authorization: Bearer <access_token>" <the_rest_of_your_API_request>
@foo:bar.com
. We need an admin access token (e.g.
syt_AjfVef2_L33JNpafeif_0feKJfeaf0CQpoZk
), and we need to know which port
-Synapse's client
listener is listening
+Synapse's client
listener is listening
on (e.g. 8008
). Then we can use the following command to request the account
information from the Admin API.curl --header "Authorization: Bearer syt_AjfVef2_L33JNpafeif_0feKJfeaf0CQpoZk" -X GET http://127.0.0.1:8008/_synapse/admin/v2/users/@foo:bar.com
diff --git a/develop/usage/administration/admin_api/registration_tokens.html b/develop/usage/administration/admin_api/registration_tokens.html
index 30877efb34..c3415214de 100644
--- a/develop/usage/administration/admin_api/registration_tokens.html
+++ b/develop/usage/administration/admin_api/registration_tokens.html
@@ -153,7 +153,7 @@ registration requests, as proposed in
and stabilised in version 1.2 of the Matrix specification.
To use it, you will need to enable the
registration_requires_token
config
option, and authenticate by providing an access_token
for a server admin:
-see Admin API.
Most endpoints make use of JSON objects that contain details about tokens. These objects have the following fields:
diff --git a/develop/usage/administration/admin_faq.html b/develop/usage/administration/admin_faq.html index f9825d21d1..4fb69892cd 100644 --- a/develop/usage/administration/admin_faq.html +++ b/develop/usage/administration/admin_faq.html @@ -148,7 +148,7 @@If your server already has an admin account you should use the User Admin API to promote other accounts to become admins.
+If your server already has an admin account you should use the User Admin API to promote other accounts to become admins.
If you don't have any admin accounts yet you won't be able to use the admin API, so you'll have to edit the database manually. Manually editing the database is generally not recommended so once you have an admin account: use the admin APIs to make further changes.
UPDATE users SET admin = 1 WHERE name = '@foo:bar.com';
@@ -216,7 +216,7 @@ error (typically along the lines of "Invalid signature"). They might s
something like the following in their logs:
2019-09-11 19:32:04,271 - synapse.federation.transport.server - 288 - WARNING - GET-11752 - authenticate_request failed: 401: Invalid signature for server <server> with key ed25519:a_EqML: Unable to verify signature for <server>
-This is normally caused by a misconfiguration in your reverse-proxy. See the reverse proxy docs and double-check that your settings are correct.
+This is normally caused by a misconfiguration in your reverse-proxy. See the reverse proxy docs and double-check that your settings are correct.
First, ensure you are running the latest version of Synapse, using Python 3 with a PostgreSQL database.
diff --git a/develop/usage/administration/monitoring/reporting_homeserver_usage_statistics.html b/develop/usage/administration/monitoring/reporting_homeserver_usage_statistics.html index 9321a512ba..f04402eab6 100644 --- a/develop/usage/administration/monitoring/reporting_homeserver_usage_statistics.html +++ b/develop/usage/administration/monitoring/reporting_homeserver_usage_statistics.html @@ -218,7 +218,7 @@ option. By default, statistics are sent to Matrix.org. consider using one of the following known implementations: diff --git a/develop/usage/administration/request_log.html b/develop/usage/administration/request_log.html index e5b7100be4..38eceea543 100644 --- a/develop/usage/administration/request_log.html +++ b/develop/usage/administration/request_log.html @@ -147,7 +147,7 @@HTTP request logs are written by synapse (see site.py
for details).
HTTP request logs are written by synapse (see synapse/http/site.py
for details).
See the following for how to decode the dense data available from the default logging configuration.
2020-10-01 12:00:00,000 - synapse.access.http.8008 - 311 - INFO - PUT-1000- 192.168.0.1 - 8008 - {another-matrix-server.com} Processed request: 0.100sec/-0.000sec (0.000sec, 0.000sec) (0.001sec/0.090sec/3) 11B !200 "PUT /_matrix/federation/v1/send/1600000000000 HTTP/1.1" "Synapse/1.20.1" [0 dbevts]
-AAAAAAAAAAAAAAAAAAAAA- -BBBBBBBBBBBBBBBBBBBBBB- -C- -DD- -EEEEEE- -FFFFFFFFF- -GG- -HHHHHHHHHHHHHHHHHHHHHHH- -IIIIII- -JJJJJJJ- -KKKKKK-, -LLLLLL- -MMMMMMM- -NNNNNN- O -P- -QQ- -RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR- -SSSSSSSSSSSS- -TTTTTT-
diff --git a/develop/usage/configuration/config_documentation.html b/develop/usage/configuration/config_documentation.html
index 933801dc7b..560496dc39 100644
--- a/develop/usage/configuration/config_documentation.html
+++ b/develop/usage/configuration/config_documentation.html
@@ -1276,7 +1276,7 @@ connection pool. For a reference to valid arguments, see:
- for sqlite
- for postgres
-- for the connection pool
+- for the connection pool
@@ -3545,7 +3545,7 @@ other workers.
worker_daemonize
Specifies whether the worker should be started as a daemon process.
-If Synapse is being managed by systemd, this option
+If Synapse is being managed by systemd, this option
must be omitted or set to false
.
Defaults to false
.
Example configuration:
--
cgit 1.5.1