Merge branch 'develop' into release/1.14.0

This commit is contained in:
Svetlana Maleeva 2023-07-27 13:10:16 +03:00
commit e21b10539b
2 changed files with 57 additions and 0 deletions

View File

@ -80,6 +80,7 @@
<img alt="Connecting ONLYOFFICE Docs to ONLYOFFICE Groups" id="img1_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/portalsettingslin.png")%>" />
<div target="img1_eventcom_guides" class="screenphoto magnifier"></div>
</div>
<div class="notehelp">Starting from ONLYOFFICE Docs <b>v7.2</b>, JWT is enabled by default and the secret key is generated automatically. You need to specify the JWT parameters in the ONLYOFFICE Groups configuration file as well. For more details, see the <a href="#JWT">Configuring JWT</a> section of this article.</div>
<h2 id="ConnectDocServerTable">ONLYOFFICE Docs and ONLYOFFICE Groups version compatibility table</h2>
<cc:Compatibility ID="Compatibility1" runat="server" />
<h2 id="CSConfigFiles">Editing configuration files for ONLYOFFICE Groups</h2>
@ -119,5 +120,32 @@
<pre><code>DELETE FROM `webstudio_settings` WHERE `ID`='a3acbfc4-155b-4ea8-8367-bbc586319553';
</code></pre>
<div class="notehelp">In case there are problems with documents, you can try to change the &lt;add key="web.client.cache.resetkey" value="3" /&gt; line of the <b>web.appsettings.config</b> file entering any other numerical value instead of <b>3</b>.</div>
<h2 id="JWT">Configuring JWT</h2>
<p>To protect documents from unauthorized access, ONLYOFFICE editors use the JSON Web Token (JWT). The <b>token</b> is added in the configuration when the Document Editor is initialized and during the exchange of commands between inner ONLYOFFICE Docs services. The <b>secret key</b> is used to sign the JSON web token and validate the token upon the request to ONLYOFFICE Docs. The <b>JWT header</b> defines the HTTP header that will be used to send the JSON web token.</p>
<p>Starting from ONLYOFFICE Docs <b>v7.2</b>, JWT is enabled by default and the secret key is generated automatically. You need to find your secret key and JWT header in the ONLYOFFICE Docs configuration file, then specify the same values in the ONLYOFFICE Groups configuration file.</p>
<p><b>Step 1</b>: Find your secret key and JWT header in the <b>ONLYOFFICE Docs</b> configuration file</p>
<p>Open the <code>local.json</code> file which can be found at the following path:</p>
<ul>
<li>For Linux - <code>/etc/onlyoffice/documentserver/local.json</code></li>
<li>For Windows - <code>%ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json</code></li>
</ul>
<p>Find the <b>secret key</b> value in the following strings:</p>
<ul>
<li><code>services.CoAuthoring.secret.inbox.string</code></li>
<li><code>services.CoAuthoring.secret.outbox.string</code></li>
<li><code>services.CoAuthoring.secret.session.string</code></li>
</ul>
<p>Find the <b>JWT header</b> value in the following strings:</p>
<ul>
<li><code>services.CoAuthoring.token.inbox.header</code></li>
<li><code>services.CoAuthoring.token.outbox.header</code></li>
</ul>
<p><b>Step 2</b>: Specify your secret key and JWT header in the <b>ONLYOFFICE Groups</b> configuration file</p>
<p>Open the <code>WebStuido/web.appsettings.config</code> file with any available text editor.</p>
<p>Edit the following keys by specifying the <b>secret key</b> and <b>JWT header</b> values:</p>
<pre class="prettyprint source linenums"><code>&lt;add key="files.docservice.secret" value="your_key" /&gt;
&lt;add key="files.docservice.secret.header" value="your_header" /&gt;</code></pre>
<p>Restart the site.</p>
</div>
</div>

View File

@ -85,6 +85,7 @@
<img alt="Connecting ONLYOFFICE Docs to ONLYOFFICE Groups" id="img1_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/portalsettingswin.png")%>" />
<div target="img1_eventcom_guides" class="screenphoto magnifier"></div>
</div>
<div class="notehelp">Starting from ONLYOFFICE Docs <b>v7.2</b>, JWT is enabled by default and the secret key is generated automatically. You need to specify the JWT parameters in the ONLYOFFICE Groups configuration file as well. For more details, see the <a href="#JWT">Configuring JWT</a> section of this article.</div>
<h2 id="ConnectDocServerTable">ONLYOFFICE Docs and ONLYOFFICE Groups version compatibility table</h2>
<cc:Compatibility ID="Compatibility1" runat="server" />
<h2 id="CSConfigFiles">Editing configuration files for ONLYOFFICE Groups</h2>
@ -109,6 +110,34 @@
<p>For <b>ONLYOFFICE Docs</b> <b>2.5</b> the following SQL script must be run (<b>without running the above script!</b>):</p>
<pre><code>DELETE FROM `webstudio_settings` WHERE `ID`='a3acbfc4-155b-4ea8-8367-bbc586319553';
</code></pre>
<h2 id="JWT">Configuring JWT</h2>
<p>To protect documents from unauthorized access, ONLYOFFICE editors use the JSON Web Token (JWT). The <b>token</b> is added in the configuration when the Document Editor is initialized and during the exchange of commands between inner ONLYOFFICE Docs services. The <b>secret key</b> is used to sign the JSON web token and validate the token upon the request to ONLYOFFICE Docs. The <b>JWT header</b> defines the HTTP header that will be used to send the JSON web token.</p>
<p>Starting from ONLYOFFICE Docs <b>v7.2</b>, JWT is enabled by default and the secret key is generated automatically. You need to find your secret key and JWT header in the ONLYOFFICE Docs configuration file, then specify the same values in the ONLYOFFICE Groups configuration file.</p>
<p><b>Step 1</b>: Find your secret key and JWT header in the <b>ONLYOFFICE Docs</b> configuration file</p>
<p>Open the <code>local.json</code> file which can be found at the following path:</p>
<ul>
<li>For Linux - <code>/etc/onlyoffice/documentserver/local.json</code></li>
<li>For Windows - <code>%ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json</code></li>
</ul>
<p>Find the <b>secret key</b> value in the following strings:</p>
<ul>
<li><code>services.CoAuthoring.secret.inbox.string</code></li>
<li><code>services.CoAuthoring.secret.outbox.string</code></li>
<li><code>services.CoAuthoring.secret.session.string</code></li>
</ul>
<p>Find the <b>JWT header</b> value in the following strings:</p>
<ul>
<li><code>services.CoAuthoring.token.inbox.header</code></li>
<li><code>services.CoAuthoring.token.outbox.header</code></li>
</ul>
<p><b>Step 2</b>: Specify your secret key and JWT header in the <b>ONLYOFFICE Groups</b> configuration file</p>
<p>Open the <code>WebStuido/web.appsettings.config</code> file with any available text editor.</p>
<p>Edit the following keys by specifying the <b>secret key</b> and <b>JWT header</b> values:</p>
<pre class="prettyprint source linenums"><code>&lt;add key="files.docservice.secret" value="your_key" /&gt;
&lt;add key="files.docservice.secret.header" value="your_header" /&gt;</code></pre>
<p>Restart the site.</p>
<h2 id="DSConfigFiles">Editing configuration files for ONLYOFFICE Docs</h2>
<p>Next the <b>web.config</b> file need to be altered. It can be found in the <code>c:\Program Files\Ascensio System SIA\ONLYOFFICE Online Editors\DocService\</code> folder of the <b>ONLYOFFICE Docs</b> computer. Open it with a text editor and add the following lines (or change these lines accordingly, in case they are already present):</p>
<pre class="prettyprint source linenums"><code>&lt;add key="editor.settings.coauthoring.url" value="http://documentserver:8000" /&gt;