dandri/synapse
1
0
Fork 0
mirror of https://github.com/element-hq/synapse.git synced 2026-09-01 20:18:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

deploy: 7ed55666b5

Browse Source
This commit is contained in:
sandhose
2025-08-04 13:51:41 +00:00
parent b3a94fed48
commit 3145941c3a
6 changed files with 126 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
develop/usage/configuration/config_documentation.html
+24
View File
@@ -683,6 +683,30 @@ For more details, see the <a href="../../setup/forward_proxy.html">forward proxy
- 172.30.0.0/16
</code></pre>
<hr />
<h3 id="matrix_authentication_service"><a class="header" href="#matrix_authentication_service"><code>matrix_authentication_service</code></a></h3>
<p><em>(object)</em> The <code>matrix_authentication_service</code> setting configures integration with <a href="https://github.com/element-hq/matrix-authentication-service">Matrix Authentication Service (MAS)</a>.</p>
<p>This setting has the following sub-options:</p>
<ul>
<li>
<p><code>enabled</code> (boolean): Whether or not to enable the MAS integration. If this is set to <code>false</code>, Synapse will use its legacy internal authentication API. Defaults to <code>false</code>.</p>
</li>
<li>
<p><code>endpoint</code> (string): The URL where Synapse can reach MAS. This <em>must</em> have the <code>discovery</code> and <code>oauth</code> resources mounted. Defaults to <code>&quot;http://localhost:8080&quot;</code>.</p>
</li>
<li>
<p><code>secret</code> (string|null): A shared secret that will be used to authenticate requests from and to MAS.</p>
</li>
<li>
<p><code>secret_path</code> (string|null): Alternative to <code>secret</code>, reading the shared secret from a file. The file should be a plain text file, containing only the secret. Synapse reads the secret from the given file once at startup.</p>
</li>
</ul>
<p>Example configuration:</p>
<pre><code class="language-yaml">matrix_authentication_service:
enabled: true
secret: someverysecuresecret
endpoint: http://localhost:8080
</code></pre>
<hr />
<h3 id="dummy_events_threshold"><a class="header" href="#dummy_events_threshold"><code>dummy_events_threshold</code></a></h3>
<p><em>(integer)</em> Forward extremities can build up in a room due to networking delays between homeservers. Once this happens in a large room, calculation of the state of that room can become quite expensive. To mitigate this, once the number of forward extremities reaches a given threshold, Synapse will send an <code>org.matrix.dummy_event</code> event, which will reduce the forward extremities in the room.</p>
<p>This setting defines the threshold (i.e. number of forward extremities in the room) at which dummy events are sent.</p>