Combine the steps

Author: Meggielqk

en_US/dashboard/introduction.md

@@ -54,31 +54,9 @@ This feature is particularly useful for seamless redirection and integration sce
 
 #### How To Use This Login Method
 
-1. Call the `/login` API to obtain the login token and related information.
+1. Use the `/login` endpoint to obtain an authentication token. Since the response does not include the username, you will need to manually add it before encoding the full JSON payload.
 
-   ```
-   curl -X POST "http://127.0.0.1:18083/api/v5/login" \
-     -H 'accept: application/json' \
-     -H 'Content-Type: application/json' \
-     -d '{"username": "admin","password": "public"}'
-   {"license":{"edition":"ee"},"role":"administrator","token":"xxx.yyy.zzz","version":"5.6.1"}
-   ```
-
-2. Combine the data into a JSON structure. Manually add the username used during login (not included in the `/login` response).
-
-   ```json
-   {
-     "license": {
-       "edition": "ee"
-     },
-     "role": "administrator",
-     "token": "xxx.jwt.token",
-     "version": "5.6.1-g0fef19f8",
-     "username": "admin"
-   }
-   ```
-
-3. Convert the JSON string to Base64. Below is an example on how to get base64-encoded authentication string in one call:
+   You can perform all steps, including requesting the token, injecting the username, and encoding the result in Base64, in a single command, as shown below:
 
    ```
    curl -s -X POST "http://127.0.0.1:18083/api/v5/login" \
@@ -87,23 +65,23 @@ This feature is particularly useful for seamless redirection and integration sce
      -d '{"username": "admin","password": "public"}' | jq '.username = "admin"' | base64
    ```
 
-4. Embed the encoded string in the `login_meta` query parameter of the Dashboard URL.
+2. Construct the login URL. Embed the encoded string in the `login_meta` query parameter of the Dashboard URL. For example:
 
-#### Example URL
+   For EMQX versions **before 5.6.0**:
 
-For versions **before 5.6.0**:
+   ```bash
+   http://localhost:18083?login_meta=BASE64_ENCODED_STRING
+   ```
 
-```bash
-http://localhost:18083?login_meta=BASE64_ENCODED_STRING
-```
+   This redirects to the default cluster overview page.
 
-Redirects to the default cluster overview page.
+   For EMQX **version 5.6.0 and later**:
 
-For **version 5.6.0 and later**, you can also specify a target page:
+   ```bash
+   http://localhost:18083/#/dashboard/overview?login_meta=BASE64_ENCODED_STRING
+   ```
 
-```bash
-http://localhost:18083/#/dashboard/overview?login_meta=BASE64_ENCODED_STRING
-```
+   This allows specifying the target page after login.
 
 This method provides a smooth, pre-authenticated user experience for accessing the EMQX Dashboard. Make sure to handle the token securely and ensure it has appropriate expiration and scope limits.
 

zh_CN/dashboard/introduction.md

@@ -56,31 +56,9 @@ EMQX Dashboard 是一个 Web 应用程序，默认监听 `18083` 端口。下载
 
 使用此登录方式的步骤如下：
 
-1. 调用 `/login` 接口，获取登录返回的 token 及相关信息。
+1. 使用 `/login` 接口获取身份验证 token。由于返回结果中不包含用户名，你需要手动将用户名添加到 JSON 数据中，再进行编码。
 
-   ```
-   curl -X POST "http://127.0.0.1:18083/api/v5/login" \
-     -H 'accept: application/json' \
-     -H 'Content-Type: application/json' \
-     -d '{"username": "admin","password": "public"}'
-   {"license":{"edition":"ee"},"role":"administrator","token":"xxx.yyy.zzz","version":"5.6.1"}
-   ```
-
-2. 将数据整理成如下 JSON 结构，手动添加登录时使用的用户名（该字段不包含在接口返回中）。
-
-   ```json
-   {
-     "license": {
-       "edition": "ee"
-     },
-     "role": "administrator",
-     "token": "xxx.jwt.token",
-     "version": "5.5.0-g0fef19f8",
-     "username": "admin"
-   }
-   ```
-
-3. 将 JSON 字符串进行 Base64 编码。
+   你可以通过以下命令一步完成所有操作，包括请求 token、添加用户名，以及将结果进行 Base64 编码：
 
    ```
    curl -s -X POST "http://127.0.0.1:18083/api/v5/login" \
@@ -89,25 +67,25 @@ EMQX Dashboard 是一个 Web 应用程序，默认监听 `18083` 端口。下载
      -d '{"username": "admin","password": "public"}' | jq '.username = "admin"' | base64
    ```
 
-4. 将编码后的字符串通过 `login_meta` 参数附加到 Dashboard 的访问 URL 中。
+2. 构造登录 URL。将编码后的字符串嵌入到 Dashboard URL 的 `login_meta` 查询参数中。例如：
 
-#### 示例 URL
+   对于 **EMQX 5.6.0 之前的版本**：
 
-**5.6.0 以下版本**：
+   ```bash
+   http://localhost:18083?login_meta=BASE64_ENCODED_STRING
+   ```
 
-```bash
-http://localhost:18083?login_meta=BASE64_ENCODED_STRING
-```
+   该方式会跳转至默认的集群概览页面。
 
-将默认跳转至集群总览页面。
+   对于 **EMQX 5.6.0 及以上版本**：
 
-**5.6.0 及以上版本**，可指定跳转页面：
+   ```bash
+   http://localhost:18083/#/dashboard/overview?login_meta=BASE64_ENCODED_STRING
+   ```
 
-```bash
-http://localhost:18083/#/dashboard/overview?login_meta=BASE64_ENCODED_STRING
-```
+   该方式支持在登录后跳转到指定页面。
 
-通过该方式，可以为用户提供无需手动登录的便捷访问体验。请确保妥善管理 token 的安全性，建议设置合理的过期时间和访问权限范围。
+通过这种登录方式，可以为用户提供无需手动登录的便捷访问体验。请确保妥善管理 token 的安全性，建议设置合理的过期时间和访问权限范围。
 
 ## 忘记密码