Merge remote-tracking branch 'remotes/origin/release/1.12.0' into develop

2026-04-07 14:06:11 +08:00 · 2025-02-04 18:00:39 +03:00
parent f0b752fe2f da6a0e9c3c
commit ca7fb41089
5 changed files with 114 additions and 10 deletions
--- a/web/documentserver-example/csharp-mvc/README.md
+++ b/web/documentserver-example/csharp-mvc/README.md
@ -38,7 +38,15 @@ Configure the IIS components for the server to work correctly:
 * **Common HTTP Features**: Default Document,
 * **Security**: Request Filtering.

-## Step 4. Run your website with the editors
+## Step 4. Configure JWT 
+
+Open the *web.appsettings.config* file and [specify the same secret key](https://helpcenter.onlyoffice.com/installation/docs-configure-jwt.aspx) as used in your Document Server to enable JWT: 
+
+```
+<add key="files.docservice.secret" value="secret" />
+```
+
+## Step 5. Run your website with the editors
 1. Run the Internet Information Service (IIS) Manager:

 	**Start** -> **Control Panel** -> **System and Security** -> **Administrative Tools** -> **Internet Information Services (IIS) Manager**
@ -65,7 +73,7 @@ Configure the IIS components for the server to work correctly:

 	![browse](screenshots/browse.png)

-## Step 5. Check accessibility
+## Step 6. Check accessibility

 In case the example and Document Server are installed on different computers, make sure that your server with the example installed has access to the Document Server with the address which you specify instead of **documentserver** in the configuration files. 

--- a/web/documentserver-example/csharp/README.md
+++ b/web/documentserver-example/csharp/README.md
@ -39,7 +39,15 @@ Configure the IIS components for the server to work correctly:
 * **Common HTTP Features**: Default Document,
 * **Security**: Request Filtering.

-## Step 4. Run your website with the editors
+## Step 4. Configure JWT 
+
+Open the *settings.config* file and [specify the same secret key](https://helpcenter.onlyoffice.com/installation/docs-configure-jwt.aspx) as used in your Document Server to enable JWT: 
+
+```
+<add key="files.docservice.secret" value="secret" />
+```
+
+## Step 5. Run your website with the editors
 1. Run the Internet Information Service (IIS) Manager:

 	**Start** -> **Control Panel** -> **System and Security** -> **Administrative Tools** -> **Internet Information Services (IIS) Manager**
@ -67,7 +75,7 @@ Configure the IIS components for the server to work correctly:
 	
 	![browse](screenshots/browse.png)

-## Step 5. Check accessibility
+## Step 6. Check accessibility

 In case the example and Document Server are installed on different computers, make sure that your server with the example installed has access to the Document Server with the address which you specify instead of **documentserver** in the configuration files.

--- a/web/documentserver-example/java-spring/README.md
+++ b/web/documentserver-example/java-spring/README.md
@ -94,8 +94,15 @@ To run the Java example code, install the Java version 11 appropriate for your O
 	echo %MAVEN_HOME%
 	```

+### Step 5. Configure JWT 

-### Step 5. Start application with Maven
+Open the *src/main/resouces/application.properties* file and [specify the same secret key](https://helpcenter.onlyoffice.com/installation/docs-configure-jwt.aspx) as used in your Document Server to enable JWT: 
+
+```
+docservice.security.key=secret
+```
+
+### Step 6. Start application with Maven

 1. Open the console and go the java-spring folder using the **cd** command, for example:
 	```
@ -113,7 +120,7 @@ To run the Java example code, install the Java version 11 appropriate for your O
     http://server.address:server.port/
     ```

-### Step 6. Check accessibility
+### Step 7. Check accessibility

 In case the example and Document Server are installed on different computers, make sure that your server with the example installed has access to the Document Server with the address which you specify instead of **documentserver** in the configuration files. 

@ -174,6 +181,11 @@ See the detailed guide to learn how to install Document Server [for Linux](https

 	where the **documentserver** is the name of the server with the ONLYOFFICE Docs installed, **port** is any available port and **files.storage** is the path where files will be created and stored (in the project folder by default). You can set an absolute path.
   
+   [Specify the same secret key](https://helpcenter.onlyoffice.com/installation/docs-configure-jwt.aspx) as used in your Document Server to enable JWT: 
+
+    ```
+    docservice.security.key=secret
+    ```

 5. Install **Maven**:

@ -260,6 +272,12 @@ See the detailed guide to learn how to install Document Server [for Docker](http

    where the **documentserver** is the name of the server with the ONLYOFFICE Docs installed, **port** is any available port and **files.storage** is the path where files will be created and stored (in the project folder by default). You can set an absolute path.

+    [Specify the same secret key](https://helpcenter.onlyoffice.com/installation/docs-configure-jwt.aspx) as used in your Document Server to enable JWT: 
+
+    ```
+    docservice.security.key=secret
+    ```
+
 6. Run the next command in the java example directory:

 	```
--- a/web/documentserver-example/java/README.md
+++ b/web/documentserver-example/java/README.md
@ -88,7 +88,15 @@ To run the Java example code, install the Java version appropriate for your OS a

 	If everything is correct, you will see the Tomcat web page in the browser as shown below.

-### Step 5. Run the Java code
+### Step 5. Configure JWT 
+
+Open the *src/main/resouces/settings.properties* file and [specify the same secret key](https://helpcenter.onlyoffice.com/installation/docs-configure-jwt.aspx) as used in your Document Server to enable JWT: 
+
+```
+files.docservice.secret=secret
+```
+
+### Step 6. Run the Java code

 1. Open Tomcat Web Application Manager by clicking **Manager App:**

@ -124,7 +132,7 @@ To run the Java example code, install the Java version appropriate for your OS a

 6. Click the link with the application name to run it.

-### Step 6. Check accessibility
+### Step 7. Check accessibility

 In case the example and Document Server are installed on different computers, make sure that your server with the example installed has access to the Document Server with the address which you specify instead of **documentserver** in the configuration files. 

@ -176,6 +184,12 @@ See the detailed guide to learn how to [install Document Server for Linux](https
 	sudo chmod -R ugo+rw /{path}
 	```

+	[Specify the same secret key](https://helpcenter.onlyoffice.com/installation/docs-configure-jwt.aspx) as used in your Document Server to enable JWT: 
+
+	```
+	files.docservice.secret=secret
+	```
+
 5. Install **Maven**:

    ```
@ -278,6 +292,12 @@ See the detailed guide to learn how to install Document Server [for Docker](http

 	where the **documentserver** is the name of the server with the ONLYOFFICE Document Server installed and the **storage-folder** is the path where files will be created and stored.

+	[Specify the same secret key](https://helpcenter.onlyoffice.com/installation/docs-configure-jwt.aspx) as used in your Document Server to enable JWT: 
+
+	```
+	files.docservice.secret=secret
+	```
+
 6. Run the next command in the Java example directory:

 	```
--- a/web/documentserver-example/nodejs/README.md
+++ b/web/documentserver-example/nodejs/README.md
@ -32,7 +32,33 @@ If you want to experiment with the editor configuration, modify the [parameters]

 Install the **node.js** environment which is going to be used to run the Node.js project. Please follow the link at the [official website](https://nodejs.org/en/download/) choosing the correct version for your Windows OS (32-bit or 64-bit).

-### Step 4. Run the Node.js code
+### Step 4. Configure JWT 
+
+Open the *config/default.json* file and enable JWT:
+
+```
+{
+    "server": {
+        "token": {
+            "enable": true
+        }
+    }
+}
+```
+
+Also, [specify the same secret key](https://helpcenter.onlyoffice.com/installation/docs-configure-jwt.aspx) as used in your Document Server: 
+
+```
+{
+    "server": {
+        "token": {
+            "secret": "secret"
+        }
+    }
+}
+```
+
+### Step 5. Run the Node.js code

 We will run the code in Node.js runtime environment and will interact with it using the **command line interface (cmd)**.

@ -62,7 +88,7 @@ We will run the code in Node.js runtime environment and will interact with it us
    http://localhost:3000
    ```

-### Step 5. Check accessibility
+### Step 6. Check accessibility

 In case the example and Document Server are installed on different computers, make sure that your server with the example installed has access to the Document Server with the address which you specify instead of **documentserver** in the configuration files. 

@ -129,6 +155,30 @@ See the detailed guide to learn how to [install Document Server for Linux](https
   sudo chmod -R ugo+rw /{path}
   ```

+   Enable JWT:
+
+    ```
+    {
+      "server": {
+        "token": {
+          "enable: true
+        }
+      }
+    }
+    ```
+
+    Also, [specify the same secret key](https://helpcenter.onlyoffice.com/installation/docs-configure-jwt.aspx) as used in your Document Server: 
+
+    ```
+    {
+      "server": {
+        "token": {
+          "secret": "secret"
+        }
+      }
+    }
+    ```
+
 6. Run the project with Node.js:

    ```